HN Showcase
Back to browse
GitHub Repository

Antidote for fluffy specs, a toolkit for fact-driven development with AI agents

182 starsRust

Replacing spec-driven development with just facts

by everlier·May 4, 2026·7 points·4 comments
Visit ProjectView on HN

AI Analysis

●●SolidBig BrainSolve My Problem

Replaces vague specs with verifiable shell commands agents can actually check.

Strengths
  • •Atomic facts with @draft/@spec/@implemented tags map cleanly to agent workflows.
  • •Shell command verification prevents agents from hallucinating implementation status.
  • •Rust binary with zero config works across Linux, macOS, and Windows immediately.
Weaknesses
  • •Requires agents to adopt a new workflow; existing teams may resist the paradigm shift.
  • •No integration with popular IDEs or existing spec tools like OpenAPI or Swagger.
Target Audience

Developers using AI coding agents

Similar To

Cursor · Continue · Sourcegraph Cody

Post Description

I had a lot of issues with spec-driven approaches, agents are too readily producing fluff, large projects have so many specs agents start making mistakes maintaining them. There's a constant consistency tax.

In the end every spec is just a bunch of facts, so I decided to leave that and throw away everything else while making it friendlier for agentic use.

Introducing facts - skills and CLI for agents to use facts-driven development. https://github.com/av/facts

Similar Projects