Skip to content
cccskills
FreePublished on GitHub

codex-spec-driven-development

Use for prototype, MVP, fullstack feature, from-scratch feature, or multi-domain work that needs a SPEC.md before planning or implementation. Do not use for tiny one-file edits.

The English summary is being prepared. Showing the original description.

See how to install

Files included (5)

  • SKILL.md2.3 KB
  • agents/openai.yaml311 B
  • references/spec.schema.json954 B
  • scripts/check_spec.py9.6 KB
  • scripts/init_spec.py13.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

TL;DR

Use before $prototype, MVP, fullstack, or high-ambiguity feature work. Write .codex/specs/<slug>/SPEC.md first, then plan, delegate, implement, and validate against acceptance criteria.

Activation

  1. Activate on $spec, $prototype, "spec-driven", "MVP", "fullstack prototype", "from scratch", or "build whole app".
  2. Activate when a task spans frontend + backend, data, QA, or deployment concerns.
  3. Activate when requirements are ambiguous enough that coding first would create rework.

Hard Rules

  • Do not implement prototype/fullstack work before a spec exists.
  • Specs must include requirements, non-goals, acceptance criteria, FE/BE/data/QA impact, and validation plan.
  • Specs must include Schema-Version: 1.0, AC IDs such as AC-001, and a traceability table mapping changed files to AC IDs and validation commands.
  • Keep specs project-local under .codex/specs/; do not always load every spec.
  • Use check_spec.py after code changes when .codex/specs/ exists.
  • Treat spec checks as advisory in quality gate unless the user makes spec compliance mandatory.

Commands

python "<SKILLS_ROOT>/codex-spec-driven-development/scripts/init_spec.py" --project-root <path> --title "<title>"
python "<SKILLS_ROOT>/codex-spec-driven-development/scripts/check_spec.py" --project-root <path> --changed-files <csv>

Output Contract

  • init_spec.py returns JSON with status, spec_path, and slug.
  • check_spec.py returns JSON with schema_version, overall, matched_specs, matched_acceptance_criteria, unmapped_files, and suggested_actions.

Prototype Flow

  1. Run $hook to detect domains and readiness.
  2. Run $init-profile if profile is missing.
  3. Run $genome and $init-docs if context/docs are missing.
  4. Run $spec to lock requirements and acceptance criteria.
  5. Run $plan, then $sdd or inline execution.
  6. Run $check-full and update role docs/handoff.

Reference Files

  • references/spec.schema.json: required spec markdown contract and traceability fields.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work — guides completion of development work by presenting structured options for merge, PR, or cleanup

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

Use when a project has 50+ files, missing context, or explicit $codex-genome request; generates multi-layer project context to reduce hallucination.

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

Use for DESIGN.md visual identity contracts; author, scaffold, lint, diff, and export design contracts with the upstream spec and CLI.

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

Use when the task involves reading, creating, or editing `.docx` documents, especially when formatting or layout fidelity matters; prefer `python-docx` plus the bundled `scripts/render_docx.py` for visual checks.

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

Use when code changes may require documentation updates; maps git diff to candidate docs without auto-editing documentation.

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

Use for documents, reports, memos, guides, academic papers, or formal text that needs clear structure, reliable tone, formatting, and diagrams.

The English summary is being prepared. Showing the original description.

Bang-isme/CodexAI---Skills10Updated Oct 5, 2026

See all skills by Bang-isme

Report a problem with this skill