compass
Installation
SKILL.md
Compass
A single docs/compass.md per repo that answers "where am I, what's the next move, what will I forget?" Auto-maintained by the skills that mark meaningful lifecycle events; read by getting-started at every session entry.
Skill type: Utility — direct execution, no subagent dispatch.
Platform: POSIX only (Linux, WSL2, macOS). Native Windows not supported in v1.
When to use
| Situation | Action |
|---|---|
| "What arc am I on?" / session reorientation | compass read or compass read --compact |
| Inspect full file | compass read |
| Manually set a field | compass update --field <name> --value <value> |
| File is at the 40-line cap | compass compress |
| Suspect schema drift or parse error | compass doctor |