athena-codex

name	athena-codex
description	Use the ATHENA framework in Codex for PRD-driven, traceable delivery. Trigger when the user wants iterative execution with auditable CR/Decision/Spec/Task artifacts and disciplined one-task-at-a-time implementation.

ATHENA Codex Adapter

The loop is identical on every harness — follow ../../skills/athena/SKILL.md. This adapter only covers Codex wiring.

Codex wiring

• Session open: run ./scripts/owl context (Codex has no hooks or auto-memory — the script is the mechanism).

• Keep ~/.codex/AGENTS.md minimal (trigger + stop-gates only, ≤ 15 lines). Do not duplicate loop steps there — the loop lives in SKILL.md. Recommended block:

  ## ATHENA — mandatory for all coding work
  - Invoke the athena skill before any change and follow its loop exactly.
  - Session open: ./scripts/owl context
  - Never Read docs/requests.md, docs/decisions.md, or docs/athena-index.md —
    use ./scripts/owl (add-request, add-decision, add-note, show, why).
  - No code changes until the current request is captured (owl add-request)
    and reflected in docs/PRD.md.
  - If any gate above was skipped, STOP and restart with ATHENA.
  

• Install the full package with $skill-installer into $CODEX_HOME/skills/athena, then run scripts from $CODEX_HOME/skills/athena/scripts/ (or a local ./scripts/owl wrapper).

Versioning

Use Semantic Versioning from ../../VERSION. Breaking process changes require a major bump.