OpenSpec
Hacker ApprovedThe most recommended of 3 spec frameworks
Keeps AI coding agents focused with lightweight change specs, lighter than Spec-Kit. Critics say spec files pile up and become hard to maintain.
Keeps AI coding agents focused with lightweight change specs, lighter than Spec-Kit. Critics say spec files pile up and become hard to maintain.
69 people gave an opinion
- recommend it
- 49
- criticize it
- 20
- approval share
- 71%
Recommended in 10 of 13 months
- November 2025: not recommended
- December 2025: not recommended
- January 2026: recommended
- February 2026: recommended
- March 2026: recommended
- April 2026: recommended
- May 2026: recommended
- June 2026: recommended
- July 2026: recommended
- August 2026: recommended
- September 2026: recommended
- October 2026: recommended
- November 2026: not recommended (month in progress)
Why it carries the badge
- 49 people recommend itNeeds 10 or more, met.
- 2.5 recommenders for every criticNeeds 2 to 1 or better, met.
- Recommended in 10 of 13 monthsNeeds 4 or more, met.
The same three rules apply to every product, and the badge can’t be bought. How the badge works
What people say about it
The reasons people give, with the number of comments that give each one. Open a reason to read what they said.
Why people recommend it
Each mark is one comment
Keeps agents focused and on track
“I find it works far better to have a proposal and a list of tasks the ai stays more focused.”
Comment from 6 Feb 2026 in “GPT-5.3-Codex” “the OpenSpec change process is super valuable for keeping agents on track”
Comment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework” “If you want a system that actually stays stable, use OpenSpec”
Comment from 15 Feb 2026 in “Breaking the Spell of Vibe Coding” Lighter than alternatives like Spec-Kit
“It works fairly well, and it is definitely less heavy than SpecKit.”
Comment from 16 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework” “it is one of the simpler frameworks for SDD, versus eg speckit”
Comment from 18 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework” “I think it has the most sane ceremony and its model fits my mental model really well.”
Comment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework” Clarifies requirements before implementation
“find the more time I put iterating/scrutinizing the spec artifacts before I let the agent implement the better understanding I have and the better results I get”
Comment from 14 Aug 2026 in “Understanding Is the New Bottleneck” “I use open spec to negotiate requirements before the handoff, it's helped me a lot.”
Comment from 25 Apr 2026 in “I Cancelled Claude: Token Issues, Declining Quality, and Poor Support” “I personally like using openspec for this, because it makes the model iteratively ask you architectual decisions”
Comment from 18 Oct 2026 in “Show HN: Sphinx – A hook that quizzes you on your AI's code before shipping” Records reasoning and system behavior
“Using OpenSpec keeps things as constrained as possible with the side effect of recording what your system does.”
Comment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework” “I like it because it explicitly captures my reasoning in the documents it produces”
Comment from 10 Sep 2026 in “Creativity is the new moat”
What people warn about
Each mark is one comment
Many generated markdown files to review
“every change, medium or larger, turns into a large set of multiple markdown documents, each that need review”
Comment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework” “One of my frustration with openspec is the number of files that are generated from the proposal”
Comment from 9 Mar 2026 in “Ask HN: What Are You Working On? (March 2026)” “Every time I look at those spec files it's somehow exhausting.”
Comment from 17 Aug 2026 in “Software Engineering fundamentals matter more” Maintaining specs gets hard as projects grow
“As soon as the project grows to 'relevant' size of complexity, maintaining specs is just as hard as whatever other methodology offers.”
Comment from 14 Feb 2026 in “Breaking the Spell of Vibe Coding” “I enjoy the OpenSpec format but I think maintaining the main specs is not worth it.”
Comment from 3 May 2026 in “Specsmaxxing – On overcoming AI psychosis, and why I write specs in YAML” Docs cover usage, not the software
“The documentation is entirely about how to use it, how to manage the skills and configure it.”
Comment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework” “All the docs here are the templates rather than the actual file”
Comment from 16 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”
Other spec frameworks people recommend
The two most recommended other spec frameworks, with the same counts for each, so you can compare like for like. The tick on each bar marks the 2 to 1 line the badge needs.
| Product | Recommend | Criticize | Approval | Months | Owned | Badge |
|---|---|---|---|---|---|---|
| OpenSpecThis page | 49 | 20 | 71% | 10 | — | Approved |
| GitHub Spec Kit | 39 | 22 | 64% | 10 | — | — |
| Verified Spec-Driven Development (VSDD) | 5 | 1 | 83% | 3 | — | — |
What people said
40 of the 92 comments that mention it, newest first. Each links to the original comment.
“I've recently adopted openspec for one of our repos and it's worked great.”
“I personally like using openspec for this, because it makes the model iteratively ask you architectual decisions”
“I have personally been leaning into spec driven development, which I have found success with.”
“Plan mode is not dead, it just moved to OpenSpec and other similar tools.”
“it is one of the simpler frameworks for SDD, versus eg speckit”
“I like the overall idea of this, but the writing of the spec to me is more like building the thing than the implementation itself”
“The whole point about OpenSpec is that you create a new change, with a new spec, and then the LLM modifies the code accordingly.”
“the OpenSpec change process is super valuable for keeping agents on track”
“The documentation is entirely about how to use it, how to manage the skills and configure it.”
“it changes bit by bit in every meeting and before you know your specs are not aligned”
“I use it at a much smaller scale. I think that's also the right place, because its a CLI tool + skills that generate md files.”
“every change, medium or larger, turns into a large set of multiple markdown documents, each that need review”
“Using OpenSpec keeps things as constrained as possible with the side effect of recording what your system does.”
“I think it has the most sane ceremony and its model fits my mental model really well.”
“it can validate the shape without having to spend tokens reading the files”
“All the docs here are the templates rather than the actual file”
“It works fairly well, and it is definitely less heavy than SpecKit.”
“I like it because it explicitly captures my reasoning in the documents it produces”
“to be useful for raising my interface to projects up a layer of abstraction”
“having the intent develop alongside the code in the repository seems to have ensured that agents have a more holistic view of the project”
“Every time I look at those spec files it's somehow exhausting.”
“find the more time I put iterating/scrutinizing the spec artifacts before I let the agent implement the better understanding I have and the better results I get”
“the Workflow is not too heavy while execution still churning good result given the spec is done well”
“I've only exceptionally rarely seen claude do something wrong based on spec docs when it's fully spec'd out.”
“I enjoy the OpenSpec format but I think maintaining the main specs is not worth it.”
“I use open spec to negotiate requirements before the handoff, it's helped me a lot.”
“I'm experimenting with openspec with my team now on a brownfield project and have some good results.”
“I use openspec to create context and a sequential task list that I feed to ralph loops”
“I like openspec, it lets you tune the workflow to your liking and doesn’t get in the way.”
“for small things it does work for me, but there is still something left for LLMs to truly capture major issues”
“One of my frustration with openspec is the number of files that are generated from the proposal”
“they can also largely be mitigated by using frameworks such as Openspec or Spec-Kit”
“Strangely, taking the time to lay out the steps in a large task helps immensely.”
“You work high level, create a spec and break it down into beads (small tasks).”
“If you want a system that actually stays stable, use OpenSpec”
“As soon as the project grows to 'relevant' size of complexity, maintaining specs is just as hard as whatever other methodology offers.”
“I find it works far better to have a proposal and a list of tasks the ai stays more focused.”
“It uses deterministic AST parsing and static analysis for the core spec generation.”
“With a more disciplined way of creating and persisting locally the specs for the work”
“Works pretty great for me, especially Spec-driven development using OpenSpec”
Counts come from 1,795,640 Hacker News comments, November 2025 to November 2026. How we count. Report a mistake.