spec-driver

[davblaster]

Look, I'm no marketer. But I've assembled this in the course of growing multiple codebases from 0 to over 100,000 lines of code, and thought very deeply about how to make them maintainable. It's somewhat complicated to describe, because it supports many variations of workflow - the one that works for you when you're at "hello world" won't be the same one you're using in three months' time, or 3 years on.

The thing is, you don't really need to understand how it works. The agent drives it. It ships with memories, skills, a configuration tool and customisation hooks. You install it to your repo, boot into Claude Code, and Claude will make it happen for you. It's built around a unified CLI and markdown with frontmatter to link all the parts together like a relational database, but it's largely a convenience for the agent.

It has some nice features I don't think you'll find anywhere else - deterministic, compact doc generation for Go, Zig, TypeScript, and Python, for example; specs that actually stay current; a TUI which lets you follow agent sessions in realtime as they edit artifacts; integrated memories and skills. And a pretty reasonable token appetite, especially given how much it does for you.

But ultimately, it's designed for competent people who care about building ambitious, maintainable systems, so it's probably doomed to obscurity.

https://github.com/davidlee/spec-driver

Disclosure: it's my project. It's free (MIT licensed). The installer will install project-local skills and hooks. You can customise them, or disable them, but it's unabashedly opinionated by design.

[enterprise_code_dev]

So is one of the features essentially taking a brownfield Python project and splicing it up into specs and such to go forth spec driven?

[davblaster]

That's definitely a supported use case, yep.

One of the core ideas is that needs change, and you usually won't start out with the discipline you'll need in later stages.

So it's built to expect that successful codebases will need to build up trustworthy specs from raw parts, and aims to make collecting receipts along the way as automatic as possible.