geointel/docs/CODEX_AUTONOMOUS_RUNBOOK_M4.md

Codex Autonomous Runbook M4

Use this runbook when starting an autonomous implementation session.

Before Coding

1. Read README.md.
2. Read AGENTS.md.
3. Read docs/DEVELOPMENT_RULES.md.
4. Read docs/M4_AUTONOMOUS_BUILD_READINESS.md.
5. Read docs/SPRINT_BOARD_M4.md.
6. Read module contract for the sprint being implemented.

Implementation Rules

• Build in the sprint order unless explicitly instructed otherwise.
• Do not skip backend tests for frontend work.
• Do not add a new dependency without updating dependency documentation.
• Do not invent new architecture where a contract already exists.
• Preserve fixture determinism.
• Update TODO and changelog after each pass.

End-of-Pass Report Format

Each Codex pass must end with:

## Completed
- ...

## Tests Run
- ...

## Changed Files
- ...

## Remaining TODO
- ...

## Risks / Blockers
- ...

Stop Conditions

Stop and ask for human direction only if:

• A required external credential is missing.
• A core architecture decision conflicts across documents.
• A dependency cannot be installed or replaced safely.
• Data license terms are unclear for a live connector.