spec

Capture and structure product work into a complete, testable specification.

4|1|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/doodledood/codex-workflow --skill spec-doodledood
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/doodledood/codex-workflow/tree/main/skills/spec
Command: npx skills add https://github.com/doodledood/codex-workflow --skill spec-doodledood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Build requirements specification through structured discovery interview. Use when defining scope, gathering requirements, or specifying WHAT work should accomplish - features, bugs, refactors, infrastructure, migrations, performance, documentation, or any other work type. Triggers: spec, requirements, define scope, what to build.

Core Features & Use Cases

  • Interactive todo-driven discovery to expand and refine requirements
  • Interview logs and external memory to track decisions and iterations
  • Phase-based workflow including Phase 1 setup, Phase 2 context gathering, Phase 3 iterative interview, Phase 4 finalize
  • Generates /tmp/spec-... and /tmp/spec-interview-... files to persist progress

Quick Start

Start the discovery interview by providing the work name and initial user request to begin structured discovery.

Frequently Asked Questions about spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I define project scope and gather requirements for a new feature?

To define project scope, you need structured discovery interviews that capture product work into a complete, testable specification with well-defined requirements and traceable decisions. This process uses iterative interview rounds to expand todos and finalize the spec.

What is a structured discovery interview for requirements specification?

A structured discovery interview for requirements specification is a phase-based workflow that gathers context, iteratively refines requirements through interactive todos, and logs decisions to external memory. It ensures each requirement is testable and verifiable before finalization.

How do I create testable requirements with traceable decisions for my product?

You create testable requirements with traceable decisions by enforcing a formal specification workflow with phase-based setup, context gathering, iterative interviews, and finalization steps. Interview logs track decisions and iterations to ensure verifiable requirements.

Can I use this requirements specification workflow for infrastructure and migration projects?

Yes, you can use this requirements specification workflow for infrastructure, migrations, refactors, features, bugs, performance, and documentation work. It applies to any project requiring clear scope, well-defined requirements, and traceable decisions.

How do I start a discovery interview to specify what to build?

To start a discovery interview, provide the work name and initial user request. This begins the structured discovery process, generating temporary spec and interview files to persist progress through the iterative phases.

Does the specification workflow persist progress if the discovery interview is interrupted?

Yes, the specification workflow persists progress by generating spec and interview files in the temporary directory. These files act as external memory to track decisions, iterations, and todos throughout the phase-based workflow.