AGENTS.md

1# SDP Codex Instructions
2 
3You are operating in a repository that uses Spec-Driven Protocol (SDP).
4SDP is a structured workflow for AI-assisted software development:
5explicit scope, workstreams, quality gates, review, and evidence before ship.
6 
7## Quick Start
8 
9Read these in order:
10 
111. `AGENTS.md`
122. `docs/reference/project-map.md`
133. `prompts/commands.yml`
144. `docs/reference/FALLBACK_MODE.md` if your Codex runtime cannot spawn subagents
15 
16## Main Commands
17 
18### Planning and analysis
19 
20- `@vision` — strategic product shaping
21- `@feature` — feature planning
22- `@idea` — requirements gathering
23- `@design` — workstream design
24- `@understand`, `@scout`, `@architect`, `@reality`, `@metrics` — repo analysis
25 
26### Execution
27 
28- `@build` — execute one scoped workstream
29- `@oneshot` — end-to-end feature execution
30- `@operate` / `@deploy` — release and operations work
31 
32### Bugs and review
33 
34- `@fix`, `@bugfix`, `@hotfix`, `@issue`, `@debug`
35- `@review`, `@verify-workstream`, `@ci-triage`
36 
37### Coordination
38 
39- `@llm-council` — multi-model synthesis for hard decisions
40- `@git-worktree` — safe parallel work setup
41- `@parallel-dispatch` — parallel subagent delegation
42 
43## Quality Gates
44 
45Run the relevant gates before claiming a task is complete:
46 
47| Language | Build | Test | Lint |
48|---|---|---|---|
49| Go | `go build ./...` | `go test ./...` | `go vet ./...` |
50| Python | `pip install .` | `pytest` | `ruff check .` |
51| Node.js | `npm run build` | `npm test` | `npm run lint` |
52| Rust | `cargo build` | `cargo test` | `cargo clippy` |
53| Java | `mvn compile` | `mvn test` | `mvn checkstyle:check` |
54 
55## Operating Rules
56 
57- No code change without a clear scope.
58- Prefer TDD for behavior changes.
59- Do not hide broken assumptions. Call them out and resolve them.
60- Use `prompts/commands.yml` as the canonical command mapping.
61- Use `prompts/skills/` as the canonical skill source.
62 
63## Landing The Plane
64 
65Before ending a session:
66 
671. Run the relevant quality gates.
682. Verify acceptance criteria with evidence.
693. Update docs if behavior or UX changed.
704. Commit and push from a harness that has git access if your Codex sandbox does not.
71 
72## Related Files
73 
74- `prompts/commands.yml`
75- `prompts/skills/`
76- `prompts/agents/`
77- `docs/reference/FALLBACK_MODE.md`
78