hn.today

Show HN: Specification First Agentic Development Plugin and Prove

spec-first.dev28 points20 comments
Screenshot of Show HN: Specification First Agentic Development Plugin and Prove

Spec-first is an open-source, MIT-licensed plugin and workflow for developing software with AI agents. Its central argument is that agents should agree on a checked specification before writing code, replacing loosely directed “vibe coding” with a repeatable path from an idea to a verified pull request. The user describes a feature; the agent first reads project files and stored preferences, then creates a YAML spec with the goal, evidence from specific files and lines, implementation steps, and completion criteria. A separate reviewer, without the original conversation, checks the spec against the code and may cut unsupported work or add missing requirements. Only then does an agent implement the plan and its tests.

Each spec gets its own branch and Git worktree, allowing independent tasks to proceed in parallel. The workflow records non-obvious design choices, tracks resumable state, and runs declared build and test checks before allowing a commit; failed checks block delivery. A successful run produces a commit and pull request containing the spec. Larger efforts can be divided into dependent or independent specs, with compatible tasks built concurrently and the merged result verified. The plugin supports Claude Code directly, while other agents can use the same repository files and a Git hook. Its creators say the method was used to build Agent Smith and report more than 1,300 completed specs, 1,190 decision records, and 650 specs that passed the gate.

Read on spec-first.dev20 comments on Hacker News

Summary generated by AI from the linked article. hn.today is not affiliated with Hacker News or Y Combinator.

More in AI

The daily digest

Today's best Hacker News stories, summarized and screenshotted, one email a day.