Use Atlas as optional project-folder orientation. Underlying project files are authoritative; expand exploration as evidence requires.
When Atlas work is the user's whole request, end with one optional next step fitting this outcome: a fenced, self-contained prompt naming any repository, issue, PR, or artifact it needs, or say none is needed. Only a "yes" starts it, via any skill it names, but the user runs a charter, diagnose, or ticket step as its /<skill> command.
Invoke commands as python <skill>/scripts/cli.py --repo-root <root> --format json [--input name=value ...] <command>; doctor returns the next command.
Navigate an existing wiki
- Start from the Map in root guidance.
- Follow only cue-matching links, batching each level's reads into one turn: a Satellite's start target first, a cross-link only when the task crosses its boundary.
- Read a link's heading section or named symbol's definition with a bounded read; widen only if insufficient.
- When no cue fits, routes compete, or an entrypoint proves unproductive, reconsider the route or search natively; never hunt through the whole wiki. If your work edits files, fix the misleading cue unless your skill limits Atlas upkeep.
- Inspect current project files before making claims or decisions.
Author or rebalance
Before changing wiki structure, read information architecture for roles, cues, and links, and authoring and rebalancing for mapping and completion.
Validate the hierarchy
The command is read-only. After edits, run run and repair every diagnostic; report map.map_unreadable. Counts are review signals.
Keep pointers current
When your work moves, renames, deletes, or changes the meaning of a file or symbol, update each pointer a .map/ search for it finds in the same work; never walk the wiki or remap unrelated areas. This needs no freshness cycle. For a deliberate drift audit, read freshness and maintenance.
Install project-folder guidance
setup-guidance writes the Map, one block in root AGENTS.md and CLAUDE.md, from top-level Landmark titles and opening paragraphs, creating either file; authoring, rebalancing, and edits to those finish with it. Only the user adds <!-- OPT-OUT ATLAS -->; remove-guidance runs only on explicit request.