---

name: update-codemaps description: Imported from everything-codex command update-codemaps version: 0.1.0 source: fork checksum: fa4d8102177e477c26ffa036780586770242b14ec472690884ca31d51ffc9988 updated_at: 2026-02-11T09:29:16+08:00 layer: utility

Update Codemaps

Native Subagent Protocol (Codex)

Codex supports native subagents. Delegate with spawn_agent, coordinate with send_input, collect via wait_agent, and clean up with close_agent.

Execution preference:

1. Use native subagents first for independent workstreams (parallel when possible).
2. Merge results in main thread and run final verification.
3. Fallback only when delegation is blocked: use the [ANALYST]/[ARCHITECT]/[EXECUTOR]/[REVIEWER] structure in a single response.

Minimal orchestration pattern:

spawn_agent -> send_input (optional) -> wait_agent -> close_agent

Analyze the codebase structure and update architecture documentation:

1. Scan all source files for imports, exports, and dependencies

2. Generate token-lean codemaps in the following format:

   • codemaps/architecture.md - Overall architecture
   • codemaps/backend.md - Backend structure
   • codemaps/frontend.md - Frontend structure
   • codemaps/data.md - Data models and schemas

3. Calculate diff percentage from previous version

4. If changes > 30%, request user approval before updating

5. Add freshness timestamp to each codemap

6. Save reports to .reports/codemap-diff.txt

Use TypeScript/Node.js for analysis. Focus on high-level structure, not implementation details.