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.
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.
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.
Interview → constitution → specify → plan → tasks
SpecKit generate-greenfield · speckit-greenfield-v1
- 1 Interviewno file yet
- 2 Constitutionwrites specs/memory/constitution.md
- 3 Specifywrites spec.md
- 4 Planwrites plan.md
- 5 Taskswrites tasks.md
- Completehand 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.
- 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>. - Constitution → specs/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.
- Specify → spec.md: prioritised user stories with independent tests and Given / When / Then scenarios, edge cases, technology-neutral FR-###, key entities, measurable SC-###, assumptions.
- Plan → plan.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.
- Tasks → tasks.md: Setup → Foundational → one phase per user story → Polish, with
T001numbering,[P]parallel markers,[US1]story tags, and a file path on every task.
Folder layout and CLI compatibility
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 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/
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.
Spec Kit workflow vs the MySpec bundle
| Spec Kit workflow | MySpec workflow | |
|---|---|---|
| Unit of work | One feature per session, numbered | One product / bundle per session |
| Constitution | Shared, versioned, Articles + Governance; gates re-checked in every plan | Per bundle, nine sections |
| Requirements | User stories P1–P3, FR-/SC-, Given / When / Then | FR-/NFR- with EARS+, requirement diagrams |
| Design | plan.md with Constitution Check and Complexity Tracking | solution.md with C4 diagrams and Success Criteria |
| Tasks | Phases per story, T001 [P] [US1], file paths | Outcome-named milestones, estimates, Gantt, QA milestone |
| Best when | Your repo already runs Spec Kit, or you ship feature by feature | You are specifying a whole system and want the richest bundle |
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.
Other workflows
The default four-file bundle: interview → constitution → requirements → solution → tasks.
GitHub Spec Kit's feature-scoped flow: interview → constitution → specify → plan → tasks.
OpenSpec's change-proposal flow: explore → proposal → delta specs → design → tasks.
Files this workflow writes
Project vision, core principles, and the MUST / MUST NOT constraints every later file has to obey.
User roles, FR-/NFR- requirements with EARS+ acceptance criteria; a coded AR-/BR-/CR- delta for brownfield changes.
Architecture, modules, data model, and API design with Mermaid flowchart, ER and sequence diagrams - plus C4 diagrams when your organisation enables them.
Ordered, sized implementation tasks grouped into milestones, traced back to requirement IDs.
Why a brownfield change is needed, what changes, the technical solution, and its impact on existing code.
Spec Kit's prioritised user stories and success criteria, or OpenSpec's ADDED / MODIFIED / REMOVED / RENAMED requirement deltas.
Spec Kit's technical plan: technical context, constitution gates, architecture, data model, and key decisions.
OpenSpec's optional context, goals / non-goals, decisions, and risks for a change.
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.