atlas-map
Orient in a codebase with titi's atlas — a ranked map of files, exported symbols, dependency edges, and PageRank. Use when you need to know which files matter most before diving in.
- License 许可
- MIT
- 所属仓库
- robertt3kuk/titi
- 最近更新
- 2026-11-02
- Stars
- ★ 1
- Forks
- 1
01 前言 Front Matter
- name
- atlas-map
- description
- Orient in a codebase with titi's atlas — a ranked map of files, exported symbols, dependency edges, and PageRank. Use when you need to know which files matter most before diving in.
03 SKILL.md 正文
atlas-map
titi ships its own code-orientation tool: titi-atlas indexes a
workspace into a ranked map — files, the symbols each defines and uses,
the dependency edges between them, and a PageRank over those edges — then
projects the top-N into a compact prompt-sized listing.
Run it
From the titi repo (compiles the example on first run):
cargo run -p titi-atlas --example map -- <path> <N>
Or the prebuilt release binary (no compile), if installed at
~/bin/titi-map (it may be older than the source; otherwise use the
cargo run form above):
titi-map <path> <N>
<path>— workspace root to index (defaults to.).<N>— how many top-ranked files to print (defaults to 24).
It first prints <files> files, <edges> edges to stderr, then the ranked
projection to stdout. Read the top of that list to find the load-bearing
files before editing.
The atlas from titi itself
The same index answers two more questions, without the example binary:
titi atlas # status: on/off, why, the cap, the agent config path
titi atlas on|off # write the boolean to the agent config.yml
titi atlas budget <t> # write the token budget (200..=4000, else sized from the repo)
titi atlas check # index diagnostics: path:line: code: message, exit 1 on any
titi atlas lsp # stdio LSP: documentSymbol, definition, references, diagnostic
The same verbs work in the chat as /atlas (check runs locally there;
lsp only names the terminal command). Two settings decide what a turn
gets: atlas.enabled (unset means on) and atlas.budget (200..=4000 tokens, the
project .titi/config.yml winning over the agent's); TITI_NO_ATLAS=1
forces the map off for one run without touching either.
04 同仓库更多 Skills
tui-smoke
Manually verify a titi TUI change in a real terminal and record it in docs/QA_STATUS.md. Use after changing titi-tui or titi-cli screen code, keys, slash commands, rendering, or when asked to smoke-test the chat.
supervisor-review
Playbook for the lead agent in titi that dispatches workers and accepts or rejects their output — verify artifacts not reports, return wrong work to the same worker, serialize shared files. Use when orchestrating subagents or reviewing a subagent's result.
skill-authoring
How to turn a recurring multi-step procedure in titi into a new project skill under .agents/skills, and wire it for every agent. Use when a 3+ step routine repeats, or the user says "make this a skill".
security-review
titi project security checklist for changes touching keys, providers, tools, approval, sessions, memory, or prompts. Use when a change handles credentials, runs commands, reads/writes files for the model, or when asked for a security review.
dependency-update
Add, bump, or remove a crate dependency in the titi workspace safely — justification, RustSec check, lockfile, one commit. Use when a change needs a new crate or a version bump.
commit
Commit and push a change in titi the project way — one concern per commit, Conventional Commits with a prose body, straight to origin master, never force. Use when asked to commit, push, save, or ship a change.