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

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

Scripts share a verb-prefix convention (`orient-*`, etc.) so they tab-complete as groups
when you remember the kind of thing you want but not the specific name.