Guidance for OpenAI Codex and other agents.
Read these files before starting work:
AI-WORKFLOW.md- Workflow and issue tracking (mandatory)AI-README.md- Project conventions (update for this repo)
Command docs live in:
.codex/commands/(issue.md,workflow.md).claude/commands/(issue.md,workflow.md)
If your environment supports /issue or /workflow, use them. Otherwise update .issues/ manually per AI-WORKFLOW.md.
.issues/ISSUE-N/issue.md.issues/ISSUE-N/plan.md.issues/ISSUE-N/summary-1.md(after work).issues/ISSUE-N/summary.md(when done)- update
.issues/index.md
- Keep
.codex/commands/*and.claude/commands/*in sync. - Session summaries are mandatory after any work.