Skip to main content
WORKFLOW · Greenfield · GITHUB SPEC KIT COMPATIBLE

The Spec Kit Workflow

GitHub Spec Kit's feature-scoped flow: interview → constitution → specify → plan → tasks.

DEFINITION // GEO SNIPPETENTITY EXTRACT

The Spec Kit workflow is MySpec's implementation of GitHub Spec Kit's feature-scoped methodology: a product interview, then a project-wide constitution.md, and per feature a spec.md, a plan.md with Constitution Check gates, and a phased tasks.md - written to the numbered specs/NNN-feature/ directories the specify CLI and its slash commands read.

THINK OF IT AS - ONE BINDER OF RULES, ONE DRAWER PER FEATURE

The Spec Kit firm keeps a single ring binder of house rules on the shelf and opens a new, numbered drawer for every job: 001-, 002-… Each drawer holds the brief, the plan, and the schedule for that one feature, and each plan starts with a checklist ticked against the binder. MySpec's own workflow, by contrast, puts the rules inside every bundle. Same discipline, different filing.

SECTION 01 SPEC KIT

What Spec Kit is

GitHub Spec Kit is an open-source toolkit for Spec-Driven Development. Its specify CLI scaffolds a repository with templates, and a set of slash commands walk an AI coding agent through the method: establish a constitution, specify a feature, clarify it, plan it, break it into tasks, implement. Its strengths are a clear feature scope and a constitution that is versioned like code. What it does not do is interview you - the CLI provides templates; the thinking is yours.

MySpec's Spec Kit workflow keeps the templates and the layout and adds the interviewing, the specialist generators, and the independent reviewer on every file. The comparison of the two approaches is on Spec-Kit vs MySpec.

SECTION 02 STAGES

Interview → constitution → specify → plan → tasks

SpecKit generate-greenfield · speckit-greenfield-v1

  1. 1 Interview
    no file yet
  2. 2 Constitution
    writes specs/memory/constitution.md
  3. 3 Specify
    writes spec.md
  4. 4 Plan
    writes plan.md
  5. 5 Tasks
    writes tasks.md
  6. Complete
    hand off via MCP or ZIP

Every file-writing stage runs three substages - collect (clarifying questions) → generate (draft the file) → review (an independent reviewer checks it against the template and your answers). You approve, edit, or send it back before the next stage starts.

  1. Interview - one feature, not a roadmap. The Greenfield Product Interviewer focuses on a single feature: problem, user-facing surface, personas, the one to three key journeys (they become the P1/P2/P3 user stories), and the smallest valuable slice. If the project already has a constitution, the interviewer reads it first and never asks a question it already answers. It ends by deriving a short kebab-case name; the workflow prefixes the next free three-digit number to form <FEAT_DIR>.
  2. Constitutionspecs/memory/constitution.md. On the first feature: collect → generate → review. On later features the constitution already exists, so the stage skips collect and only edits it when an amendment is needed - bumping the SemVer footer and the Sync Impact Report.
  3. Specifyspec.md: prioritised user stories with independent tests and Given / When / Then scenarios, edge cases, technology-neutral FR-###, key entities, measurable SC-###, assumptions.
  4. Planplan.md: technical context, the Constitution Check (Simplicity, Anti-Abstraction, Integration-First gates), architecture and data-model diagrams, modules, a testing strategy mapped to the user stories, key decisions, and complexity tracking for any gate the design breaks.
  5. Taskstasks.md: Setup → Foundational → one phase per user story → Polish, with T001 numbering, [P] parallel markers, [US1] story tags, and a file path on every task.
SECTION 03 ON DISK

Folder layout and CLI compatibility

Spec Kit layout as MySpec writes it tree
specs/
├── memory/
│   └── constitution.md          # one per project; later features read and only amend it
├── 001-photo-albums/            # <FEAT_DIR>: 3-digit prefix + kebab-case short name
│   ├── spec.md
│   ├── plan.md
│   └── tasks.md
└── 002-share-links/
    ├── spec.md
    ├── plan.md
    └── tasks.md
Spec Kit slash commands ↔ MySpec stages text
Spec Kit command      MySpec stage         File written
/speckit.constitution constitution         specs/memory/constitution.md
/speckit.specify      specify              specs/<FEAT_DIR>/spec.md
/speckit.clarify      (collect substages)  - folded into every stage's questions
/speckit.plan         plan                 specs/<FEAT_DIR>/plan.md  (research, data-model, contracts folded in)
/speckit.tasks        tasks                specs/<FEAT_DIR>/tasks.md
/speckit.implement    your coding agent    reads the bundle via MCP or .specs/
ONE PATH DIFFERENCE TO KNOW

MySpec spec paths must be rooted at specs/, so the shared constitution is stored as specs/memory/constitution.md. Upstream Spec Kit's CLI looks for it at .specify/memory/constitution.md. After downloading (the MCP server mirrors it to .specs/memory/constitution.md), copy or symlink it into .specify/memory/ if you run the specify commands locally. Feature directories match as-is.

Where Spec Kit's /speckit.plan can spread planning across plan.md, research.md, data-model.md, and contracts/, MySpec writes one comprehensive plan.md - research becomes the Key Decisions table, the data model an erDiagram section, contracts the API / Protocol Design section - so the reviewer can check the plan as a whole.

SECTION 04 COMPARED

Spec Kit workflow vs the MySpec bundle

Spec Kit workflowMySpec workflow
Unit of workOne feature per session, numberedOne product / bundle per session
ConstitutionShared, versioned, Articles + Governance; gates re-checked in every planPer bundle, nine sections
RequirementsUser stories P1–P3, FR-/SC-, Given / When / ThenFR-/NFR- with EARS+, requirement diagrams
Designplan.md with Constitution Check and Complexity Trackingsolution.md with C4 diagrams and Success Criteria
TasksPhases per story, T001 [P] [US1], file pathsOutcome-named milestones, estimates, Gantt, QA milestone
Best whenYour repo already runs Spec Kit, or you ship feature by featureYou are specifying a whole system and want the richest bundle
SECTION 05 HAND-OFF

Implementing the feature

Point your coding agent at the feature directory: through the MySpec MCP server it can read_spec_file the plan and tasks directly, or download them into .specs/001-photo-albums/. Spec Kit's /speckit.implement then works on the same files it always has. Later features start a new session in the same project; the interviewer picks up the existing constitution automatically.

WORKFLOWS MYSPEC · SPEC KIT · OPENSPEC

Other workflows

SPEC FILES FIELD GUIDE

Files this workflow writes

Let the AI Architect write it for you

MySpec interviews you, then drafts every spec file with collect → generate → review gates. Free during Open Beta.