‹ BackHN Continuity

Thread

OpenSpec – A lightweight and configurable AI spec framework

204 points · 100 comments · etoxin

  1. twen_ty · · focus · HN ↗
    Can someone tell me how this stuff is any different from the 90's let's use UML for code gen and how it's not going to fail in the same way?

    In my experience, spec drift is the main reason why none of these tools work. Maybe they work for one shot greenfield feature generation but in a large, multi developer long lived code bases, specs rot and end up being more pain than they are worth.

    1. spinningslate · · focus · HN ↗
      that's a good question. UML - at least the mainstream version pushed by e.g. Rational - failed for many reasons. A couple pertinent to this discussion:

      1. Lack of closed loop between the "spec" and working code (your spec rot point). The Rational Unified Process(RUP) was a grossly inefficient, heavily manual undertaking. Mapping between artefacts - e.g. "Platform Independent Models" and "Platform Specific Models" was a manual, largely heuristic based approach. As a consequence the models were not generally kept up to date as the project evolved.

      2. User experience mismatch. Developers were asked to create diagrams instead of writing code. Tool usability was poor ("write code with a mouse") and the artefacts didn't fit well with necessary tools like diffing and source code control (try diffing an xml file textually).

      Coding agents have some potential for alleviating (1) in that they can read the result code and, at least to some extent, ensure spec and code are in sync.

      (2) is more open. Some users - those proportionally more interested in solving the problem than designing/writing code - are more comfortable with natural-language-based specs and exploration. Those more experienced/comfortable with code will likely see those specs more akin to UML diagrams: a distraction from the real thing.

      1. 0x445442 · · focus · HN ↗
        This is what I've been mulling over for months. Surely there's a better, more rigorous specification format than Markdown prose that already exists in the industry and is useful to the agents. Formal Use Cases perhaps? Probably not Gherkin but maybe some other spec DSL.
        1. marton78 · · focus · HN ↗
          EARS: <a href="https:&#x2F;&#x2F;en.wikipedia.org&#x2F;wiki&#x2F;Easy_Approach_to_Requirements_Syntax" rel="nofollow">https:&#x2F;&#x2F;en.wikipedia.org&#x2F;wiki&#x2F;Easy_Approach_to_Requirements_...
Open on Hacker News to reply ↗

Unofficial Hacker News client; not affiliated with Y Combinator.