Onboard to a codebase
-
Read the baseline —
AGENTS.md/CLAUDE.md/README; note stack, commands, conventions. -
Map the architecture — dispatch the
exploreragent: where do requests enter, where does business logic live, how is data accessed, how are jobs/queues run? - Find the change pattern — locate a canonical example of the kind of change you’ll make and the test that covers it.
- Confirm the loop — run the build and the test suite once to learn the commands and the baseline state.
- Record findings in the state file so later sessions skip the ramp-up.
Hand-off: explorer returns the map without spending your main context; planning-a-change uses it for the first real change.


