Agile Find Bearings

At the start of a session, or whenever the user asks to "init the session", "find your bearings", or orient yourself in the repository.

1. Use compass for all your operations. Reach for compass (search, list, show, where, story, task, sprint, capture, journal, pr, review, …) before falling back to Unix tools or raw gh=/=git invocations. If compass cannot do something you need, make the limitation clear to the user — gaps in compass are captures, not workarounds.

2. To find information about any compass command, search the recipes — never guess flags from --help alone:

   ./compass.sh search "<term>"
   ./compass.sh list --type recipe --tag compass
   

3. Find your bearings:

   ./compass.sh bearings
   

4. Report back: provide the user a summary of the bearings — where we are (branch, story, task, PR and its state), whether the environment is up, and anything unusual (stale branch, merged PR, drifted worktree) — and suggest the next action.

• How do I orient a new session?
• How do I search docs with compass?
• How do I see where we are?

• ores.compass — the compass tool's component model.