Hacker ApprovedDepartments

OpenSpec

Hacker Approved

The 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%
Each figure is one person. RecommendsCriticizes

Recommended in 10 of 13 months

  1. November 2025: not recommended
  2. December 2025: not recommended
  3. January 2026: recommended
  4. February 2026: recommended
  5. March 2026: recommended
  6. April 2026: recommended
  7. May 2026: recommended
  8. June 2026: recommended
  9. July 2026: recommended
  10. August 2026: recommended
  11. September 2026: recommended
  12. October 2026: recommended
  13. 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.

OpenSpec compared with 2 alternatives
ProductRecommendCriticizeApprovalMonthsOwnedBadge
OpenSpecThis page492071%10—Approved
GitHub Spec Kit392264%10——
Verified Spec-Driven Development (VSDD)5183%3——
See all 3 spec frameworks, ranked

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.”

RecommendsComment from 28 Oct 2026 in “Show HN: Specification First Agentic Development Plugin and Prove”

“I personally like using openspec for this, because it makes the model iteratively ask you architectual decisions”

RecommendsComment from 18 Oct 2026 in “Show HN: Sphinx – A hook that quizzes you on your AI's code before shipping”

“I have personally been leaning into spec driven development, which I have found success with.”

RecommendsComment from 9 Oct 2026 in “We Are Not All Terrible Developers”

“Plan mode is not dead, it just moved to OpenSpec and other similar tools.”

RecommendsComment from 26 Sep 2026 in “Plan mode is dead”

“it is one of the simpler frameworks for SDD, versus eg speckit”

MixedComment from 18 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”

“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”

MixedComment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”

“The whole point about OpenSpec is that you create a new change, with a new spec, and then the LLM modifies the code accordingly.”

RecommendsComment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”

“the OpenSpec change process is super valuable for keeping agents on track”

MixedComment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”

“The documentation is entirely about how to use it, how to manage the skills and configure it.”

CriticizesComment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”

“it changes bit by bit in every meeting and before you know your specs are not aligned”

MixedComment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”

“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.”

RecommendsComment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”

“every change, medium or larger, turns into a large set of multiple markdown documents, each that need review”

CriticizesComment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”

“Using OpenSpec keeps things as constrained as possible with the side effect of recording what your system does.”

RecommendsComment from 17 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.”

RecommendsComment from 17 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”

“it can validate the shape without having to spend tokens reading the files”

RecommendsComment 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”

CriticizesComment from 16 Sep 2026 in “OpenSpec – A lightweight and configurable AI spec framework”

“It works fairly well, and it is definitely less heavy than SpecKit.”

RecommendsComment from 16 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”

RecommendsComment from 10 Sep 2026 in “Creativity is the new moat”

“to be useful for raising my interface to projects up a layer of abstraction”

RecommendsComment from 5 Sep 2026 in “Is AI ruining my brain?”

“having the intent develop alongside the code in the repository seems to have ensured that agents have a more holistic view of the project”

RecommendsComment from 29 Aug 2026 in “Domain-Driven Agents”

“Every time I look at those spec files it's somehow exhausting.”

CriticizesComment from 17 Aug 2026 in “Software Engineering fundamentals matter more”

“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”

RecommendsComment from 14 Aug 2026 in “Understanding Is the New Bottleneck”

“the Workflow is not too heavy while execution still churning good result given the spec is done well”

RecommendsComment from 3 Jul 2026 in “Superpowers 6”

“I've only exceptionally rarely seen claude do something wrong based on spec docs when it's fully spec'd out.”

RecommendsComment from 23 May 2026 in “- -dangerously-skip-reading-code – olano.dev”

“I enjoy the OpenSpec format but I think maintaining the main specs is not worth it.”

MixedComment from 3 May 2026 in “Specsmaxxing – On overcoming AI psychosis, and why I write specs in YAML”

“I use open spec to negotiate requirements before the handoff, it's helped me a lot.”

RecommendsComment from 25 Apr 2026 in “I Cancelled Claude: Token Issues, Declining Quality, and Poor Support”

“I'm experimenting with openspec with my team now on a brownfield project and have some good results.”

RecommendsComment from 25 Mar 2026 in “So where are all the AI apps?”

“I use openspec to create context and a sequential task list that I feed to ralph loops”

RecommendsComment from 18 Mar 2026 in “Get Shit Done: A Meta-Prompting, Context Engineering and Spec-Driven Dev System”

“I like openspec, it lets you tune the workflow to your liking and doesn’t get in the way.”

RecommendsComment from 17 Mar 2026 in “Get Shit Done: A Meta-Prompting, Context Engineering and Spec-Driven Dev System”

“for small things it does work for me, but there is still something left for LLMs to truly capture major issues”

MixedComment from 12 Mar 2026 in “Many SWE-bench-Passing PRs would not be merged”

“One of my frustration with openspec is the number of files that are generated from the proposal”

CriticizesComment from 9 Mar 2026 in “Ask HN: What Are You Working On? (March 2026)”

“they can also largely be mitigated by using frameworks such as Openspec or Spec-Kit”

RecommendsComment from 5 Mar 2026 in “The L in "LLM" Stands for Lying”

“Strangely, taking the time to lay out the steps in a large task helps immensely.”

RecommendsComment from 4 Mar 2026 in “Agentic Engineering Patterns”

“You work high level, create a spec and break it down into beads (small tasks).”

RecommendsComment from 16 Feb 2026 in “Expensively Quadratic: The LLM Agent Cost Curve”

“If you want a system that actually stays stable, use OpenSpec”

RecommendsComment from 15 Feb 2026 in “Breaking the Spell of Vibe Coding”

“As soon as the project grows to 'relevant' size of complexity, maintaining specs is just as hard as whatever other methodology offers.”

CriticizesComment from 14 Feb 2026 in “Breaking the Spell of Vibe Coding”

“I find it works far better to have a proposal and a list of tasks the ai stays more focused.”

RecommendsComment from 6 Feb 2026 in “GPT-5.3-Codex”

“It uses deterministic AST parsing and static analysis for the core spec generation.”

RecommendsComment from 2 Feb 2026 in “Show HN: Reverse-engineer OpenSpec specifications from existing codebases”

“With a more disciplined way of creating and persisting locally the specs for the work”

RecommendsComment from 28 Jan 2026 in “Karpathy: A few random notes from Claude coding quite a bit last few weeks”

“Works pretty great for me, especially Spec-driven development using OpenSpec”

RecommendsComment from 20 Jan 2026 in “Ask HN: Do you have any evidence that agentic coding works?”

Counts come from 1,795,640 Hacker News comments, November 2025 to November 2026. How we count. Report a mistake.