OpenSpec
Open-source spec-driven development framework that structures AI coding agent work into proposals, designs and tasks.
Liked for forcing upfront planning through a proposal, design and task flow before an agent writes code1234, and for keeping coding agents on track with specs committed alongside the code.567 The main caveat is that specs can drift far from the code on long projects8, and one commenter found the documentation links confusing.9
Why people recommend it
Upfront planning · 3
The proposal, design, specs and tasks flow helps users think through and agree on a change before implementation.
“The power is that you do a lot of upfront thinking.”
“I use openspec in addition with the /grill-me skill and it really helps clearing the path before starting to code.”
Show 1 more
“using Open Spec to negotiate requirements before the handoff, has helped me a lot”
Constrains agents · 3
Users say it keeps agents like Claude Code focused and gives them a fuller view of the project.
“Using OpenSpec keeps things as constrained as possible with the side effect of recording what your system does.”
“we all agreed to use OpenSpec early on, and to commit the specs alongside the code”
Show 1 more
“Easily my favorite spec driven development framework.”
Specs as documentation · 3
Committing specs with the code records intent and what the system does.
“we all agreed to use OpenSpec early on, and to commit the specs alongside the code”
“Using OpenSpec keeps things as constrained as possible with the side effect of recording what your system does.”
Show 1 more
“The power is that you do a lot of upfront thinking.”
Light ceremony · 2
Commenters describe its process as sane and lighter than alternatives like GSD.
“Easily my favorite spec driven development framework.”
“How does it compare to GSD (opengsd.net)? Just from the command set it seems a lot lighter but also less expressive.”
Token savings · 1
Small per-task contexts fed into a loop script save tokens.
“I use this to produce the task list which I then feed into a Ralph loop using a bash script.”
Brownfield support · 1
One user prefers it because it also works on existing codebases.
“I prefer https://github.com/Fission-AI/OpenSpec because it works also on brown-field.”
Caveats and dissent
Spec drift · 1
A solo user on two long projects found the specs diverged heavily from the code and dropped them, keeping only the process flow.
“What I did find very useful and have retained is the process flow.”
Confusing docs · 1
Documentation links pointed to templates rather than the actual concept pages.
“Somehow not very confidence inspiring...”
Less expressive · 1
One commenter thought its command set looked less expressive than GSD's.
“How does it compare to GSD (opengsd.net)? Just from the command set it seems a lot lighter but also less expressive.”
Reasoning not captured · 1
The default schema does not record the reasoning behind decisions unless customized.
“I use and love openspec”
Developer-oriented · 1
It is a CLI tool that generates Markdown files, not something to hand to business users.
“The power is that you do a lot of upfront thinking.”
Often compared with
Who recommends it in their own words
Threads where it came up
- OpenSpec – A lightweight and configurable AI spec framework 8 mentions
- Aidlc: Adaptive workflow steering rules for AI coding agents 1 mention
- AI is a tool and using it well takes skill 1 mention
- We Are Not All Terrible Developers 1 mention
- How much of F-Droid is LLM generated? 1 mention
- Creativity is the new moat 1 mention
Data: openspec.json. Quotes are verbatim; the verdict and theme labels are written by a model from these comments, and every clause links to its sources.
All comments 23
“I prefer https://github.com/Fission-AI/OpenSpec because it works also on brown-field.”
“I use something similar (openspec change specifications rather than a literal ROADMAP.md file)”
“I use a tool called openspec to drive the framework of creating proposal, design, and task documents, ahead of driving the implementation.”
“How does it compare to GSD (opengsd.net)? Just from the command set it seems a lot lighter but also less expressive.”
“What I did find very useful and have retained is the process flow.”
“The power is that you do a lot of upfront thinking.”
“I use this to produce the task list which I then feed into a Ralph loop using a bash script.”
“Using OpenSpec keeps things as constrained as possible with the side effect of recording what your system does.”
“Easily my favorite spec driven development framework.”
“it seems to share a similar philosophy to what I've been working on this year.”
“Somehow not very confidence inspiring...”
“Writing good specifications is the key detail here.”
“I personally use the tool openspec, and I like it because it explicitly captures my reasoning in the documents it produces”
“I have found using openspec (no affiliation, just enjoy the tool) to be useful”
“I experiment with different plan-build-evaluate frameworks like GSD, OpenSpec, Superpowers.”
“I use and love openspec”
“we all agreed to use OpenSpec early on, and to commit the specs alongside the code”
“I use openspec in addition with the /grill-me skill and it really helps clearing the path before starting to code.”
“You should take a look at OpenSpec[0]. It implements your points 1-3.”
“We use openspec with our projects at work.”
“I use OpenSpec for my spec management”
“using Open Spec to negotiate requirements before the handoff, has helped me a lot”
“I used openspec and love it.”