Skip to content

codex-bootstrap.md

Latest commit

 

History

History
47 lines (44 loc) · 2.72 KB

codex-bootstrap.md

File metadata and controls

47 lines (44 loc) · 2.72 KB
Raw

Codex bootstrap

This is the canonical short Codex start bridge. Repository-local AGENTS.md files link here; they do not copy the detailed governance in control/docs/.

  1. Use CTX first when it is available in the local environment. If it is not available, record that fact and continue without treating the absence as technical evidence.
  2. Classify the assignment: read-only evidence, decision clarification, or implementation of an already decided scope.
  3. Read the complete GitHub Issue, all comments, labels, and Project fields.
  4. Read ADR 0002, the relevant control/docs/ pages, repository rules, and the matching specification before technical work.
  5. Treat GitHub as the only active and historical work, evidence, and memory source.
  6. Confirm that the Issue contains an Aktueller verbindlicher Vertrag section near the top. It is the current target and explicitly supersedes older intermediate states; historical comments remain audit evidence and are marked superseded/überholt when replaced.
  7. For stateful logic, verify that acceptance criteria name states, transitions, owner domain/repository, authoritative source, and expected results.
  8. Keep observation, evidenced Ist, decided Soll, implementation, tests, risks, open gates, and Live evidence separate.
  9. Before implementation, write a short Ist-/Soll-Abgleich against the canonical contract. If the target is missing or ambiguous, stop and record the product question in the Issue.
  10. Carry explicitly linked cross-thread Issues, PRs, specifications, and decisions into the active prompt and handoff. Work on benni_media_state#21 must explicitly include control#28 and control PR #39.
  11. Never invent a product decision or silently replace uncertainty. Preserve unknown, unavailable, stale, source_conflict, and fallback=reject as visible diagnostic outcomes.
  12. Keep domain priorities, blockers, recovery, and existing paths domain-specific; do not create a global replacement stack.
  13. Work under exactly one Issue agent, recorded as agent:codex or agent:claude. Codex is the current default for new or explicitly reassigned work; Claude is an explicit per-Issue exception.
  14. Technical completion and Tests Pass are not Live. Benni owns Live and Live Verified.
  15. Keep local bridges short and repository-specific; do not duplicate detailed governance or feature logic in integration repositories.

The Issue records the current scope, decisions, tests, PRs, risks, handoff, and remaining Live gate. Benni owns the final Live verification.