Docs Code

Analyze a codebase, get confirmation on the module map, then add high-value comments without changing code behavior.

Phase 0: Execution Mode

Before Phase 1, ask the user to choose one execution mode and wait for the answer: "Choose subagent driven or inline exec."

1. subagent driven: use concurrent subagents for both Phase 1 exploration and Phase 2 annotation when scopes can be kept independent.
2. inline exec: use concurrent subagents for Phase 1 exploration when useful, but do Phase 2 edits in the current thread; before each docs-code edit, briefly explain why that annotation is worth adding.

If the user already specified a mode, proceed with that mode.

Phase 1 exploration rule for both modes: