materialofair Update Documentation
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:
- Use native subagents first for independent workstreams (parallel when possible).
- Merge results in main thread and run final verification.
- 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
Sync documentation from source-of-truth:
Read package.json scripts section
- Generate scripts reference table
- Include descriptions from comments
Read .env.example
- Extract all environment variables
- Document purpose and format
Generate docs/CONTRIB.md with:
- Development workflow
- Available scripts
- Environment setup
- Testing procedures
Generate docs/RUNBOOK.md with:
- Deployment procedures
- Monitoring and alerts
- Common issues and fixes
- Rollback procedures
Identify obsolete documentation:
- Find docs not modified in 90+ days
- List for manual review
Show diff summary
Single source of truth: package.json and .env.example