compass🔗

Small scripts for rapidly orienting in a project area.

Each script is standalone: run individually for debugging, or compose into larger summaries (e.g. an agent's system prompt).

Conventions🔗

• One concern per script.
• Output is markdown, scoped so the top-level output fits under an h3 or smaller. Composers wrap in larger sections as needed.
• If a script has nothing applicable to say, it stays silent (exits 0 with no output). Errors are different: surface those.
• Bash for now. Nushell on the table once we want to pass structured data between scripts.

Scripts🔗

• cwd-orient -- describes the current working directory.
• git-orient -- describes the surrounding git repo, if any.