update-docs

name	update-docs
description	Imported from everything-codex command update-docs
version	0.1.0
source	fork
checksum	60e7fd5ed9bc50331c66e375757e3b7433d4918e45e18f0b1e05d48779645a05
updated_at	"2026-02-11T01:29:16.000Z"
layer	utility

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:

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

Sync documentation from source-of-truth:

1. Read package.json scripts section

   • Generate scripts reference table
   • Include descriptions from comments

2. Read .env.example

   • Extract all environment variables
   • Document purpose and format

3. Generate docs/CONTRIB.md with:

   • Development workflow
   • Available scripts
   • Environment setup
   • Testing procedures

4. Generate docs/RUNBOOK.md with:

   • Deployment procedures
   • Monitoring and alerts
   • Common issues and fixes
   • Rollback procedures

5. Identify obsolete documentation:

   • Find docs not modified in 90+ days
   • List for manual review

6. Show diff summary

Single source of truth: package.json and .env.example