# OpenSpec

49 Hacker News commenters recommended OpenSpec and 20 criticized it, November 2025 to November 2026. It was recommended in 10 of 13 months. It meets the Hacker Approved badge rule.

**Verdict:** Keeps AI coding agents focused with lightweight change specs, lighter than Spec-Kit. Critics say spec files pile up and become hard to maintain.

## Why people recommend it

- Keeps agents focused and on track (3 comments): "I find it works far better to have a proposal and a list of tasks the ai stays more focused." ([source](https://news.ycombinator.com/item?id=46910224)) "the OpenSpec change process is super valuable for keeping agents on track" ([source](https://news.ycombinator.com/item?id=49739689)) "If you want a system that actually stays stable, use OpenSpec" ([source](https://news.ycombinator.com/item?id=47025140))
- Lighter than alternatives like Spec-Kit (3 comments): "It works fairly well, and it is definitely less heavy than SpecKit." ([source](https://news.ycombinator.com/item?id=49734393)) "it is one of the simpler frameworks for SDD, versus eg speckit" ([source](https://news.ycombinator.com/item?id=49750578)) "I think it has the most sane ceremony and its model fits my mental model really well." ([source](https://news.ycombinator.com/item?id=49734964))
- Clarifies requirements before implementation (3 comments): "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" ([source](https://news.ycombinator.com/item?id=49293441)) "I use open spec to negotiate requirements before the handoff, it's helped me a lot." ([source](https://news.ycombinator.com/item?id=47897291)) "I personally like using openspec for this, because it makes the model iteratively ask you architectual decisions" ([source](https://news.ycombinator.com/item?id=50141113))
- Records reasoning and system behavior (2 comments): "Using OpenSpec keeps things as constrained as possible with the side effect of recording what your system does." ([source](https://news.ycombinator.com/item?id=49735497)) "I like it because it explicitly captures my reasoning in the documents it produces" ([source](https://news.ycombinator.com/item?id=49649736))

## What people warn about

- Many generated markdown files to review (3 comments): "every change, medium or larger, turns into a large set of multiple markdown documents, each that need review" ([source](https://news.ycombinator.com/item?id=49736016)) "One of my frustration with openspec is the number of files that are generated from the proposal" ([source](https://news.ycombinator.com/item?id=47306024)) "Every time I look at those spec files it's somehow exhausting." ([source](https://news.ycombinator.com/item?id=49329140))
- Maintaining specs gets hard as projects grow (2 comments): "As soon as the project grows to 'relevant' size of complexity, maintaining specs is just as hard as whatever other methodology offers." ([source](https://news.ycombinator.com/item?id=47019109)) "I enjoy the OpenSpec format but I think maintaining the main specs is not worth it." ([source](https://news.ycombinator.com/item?id=47999279))
- Docs cover usage, not the software (2 comments): "The documentation is entirely about how to use it, how to manage the skills and configure it." ([source](https://news.ycombinator.com/item?id=49738746)) "All the docs here are the templates rather than the actual file" ([source](https://news.ycombinator.com/item?id=49734593))

## Alternatives hackers recommend

- [GitHub Spec Kit](https://hackerapproved.com/p/spec-kit.md): 39 recommend
- [Verified Spec-Driven Development (VSDD)](https://hackerapproved.com/p/verified-spec-driven-development.md): 5 recommend

## Cite as

Hacker Approved, "OpenSpec", https://hackerapproved.com/p/openspec/ (counts from 1,795,640 Hacker News comments, November 2025 to November 2026).