// Turn a feature idea or rough requirement into a complete, dependency-ordered spec set under ./specs, including PRD, design docs, roadmap, implementation plan, glossary, key decisions, and index updates. Use for non-trivial design, phasing, PRD, roadmap, or implementation-plan requests.
| name | spec |
| description | Turn a feature idea or rough requirement into a complete, dependency-ordered spec set under ./specs, including PRD, design docs, roadmap, implementation plan, glossary, key decisions, and index updates. Use for non-trivial design, phasing, PRD, roadmap, or implementation-plan requests. |
Use this Codex skill when the user asks for design/specification work before
implementation. The canonical workflow is the Claude spec skill at
.claude/skills/spec/SKILL.md; follow it, with the Codex-specific adjustments
below.
AGENTS.md, CLAUDE.md, specs/index.md, and relevant
docs/research/ memos before writing specs.rg, sed, find, cargo as needed) rather
than Claude-only tool names.research skill first.specs/.specs/index.md for every spec addition, deletion, or rename.90-roadmap.md) is stakeholder-facing.91-impl-plan.md) is engineer-facing and
dependency-ordered.99-key-decisions.md.Each component design must pin its purpose, public interface, invariants,
non-trivial behavior, tests or gates for those invariants, and cross-references
to dependent specs or research. Specs must not silently relax CLAUDE.md;
explicitly document any necessary deviation.
Implement one phase of ./specs/91-impl-plan.md end-to-end, matching the specs and project quality bars, then review the diff and fix valid findings before declaring done. Use when the user asks to build a phase, milestone, next phase, or roadmap slice.
Vendor reference repos as git submodules under ./vendors and produce deep research memos under ./docs/research covering architecture, design, key data structures, and load-bearing algorithms. Use whenever the user asks to research, study prior art, spike an assumption, compare upstream repos, or learn from pasted GitHub URLs before design or implementation.
Implement one phase of ./specs/91-impl-plan.md end-to-end with high quality bars (correctness, elegance, performance), then run an independent code review against the relevant specs and fix every valid finding before declaring done. Use whenever the user says "build phase N", "implement the next phase", "land M0/M1/M2/M3", "follow the impl plan", "ship phase X entirely", "based on @specs/91-impl-plan.md think ultra hard and build phase X", or asks for a phase-shaped slice of the spec set. Trigger even when the user does not say "impl" if they reference an impl plan / roadmap milestone and ask Claude to build it.
Vendor reference repos as git submodules under ./vendors and produce deep research memos under ./docs/research covering architecture, design, key data structures, and load-bearing algorithms. Use whenever the user says "do research on X", "study how Y works", "submodule this repo and look into it", "understand the design of Z before we start", "spike on …", references prior-art crates / repos that should be evaluated, or asks to refer to ./vendors before designing or implementing. Trigger even when the user does not say the word "research" if they paste GitHub URLs and ask Claude to learn from them, compare alternatives, or extract patterns.
Turn a feature idea or rough requirement into a complete, dependency-ordered spec set under ./specs — PRD, component designs, glossary, security/perf/test cross-cuts, key-decisions log, stakeholder roadmap, and engineer-facing implementation plan — cross-referenced with prior-art memos in ./docs/research and vendored code in ./vendors. Use whenever the user says "write the spec", "design this", "let's plan X", "produce a PRD / impl plan / roadmap", "restructure the specs", "review and re-organise the design", "think ultra hard and split this into phases", or describes a non-trivial system that needs a written design before code. Trigger even when the user does not say "spec" if they ask for phased delivery, milestone exit criteria, or a build-order graph.
