AGENT SKILL

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

robertt3kuk
robertt3kuk/titi

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.

★ 1
robertt3kuk
robertt3kuk/titi

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.

★ 1
robertt3kuk
robertt3kuk/titi

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".

★ 1
robertt3kuk
robertt3kuk/titi

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.

★ 1
robertt3kuk
robertt3kuk/titi

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.

★ 1
robertt3kuk
robertt3kuk/titi

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.

★ 1