Skip to main content

Verify your AI specs before execution. Tool-agnostic specification verification for SDD workflows.

Project description

specverify

Verify your AI specs before execution.

The missing layer between writing specifications and handing them to coding agents.

The Problem

Every SDD tool writes specs. No SDD tool verifies them.

You use GSD, BMAD, Spec Kit, Superpowers — they all produce specifications. Then you hand those specs to a coding agent and hope for the best. When the agent produces wrong code, you tweak the prompt. But the problem isn't the agent. It's the spec.

What specverify Does

specverify adds a verification step between your spec-writing tool and your coding agent:

Your SDD Tool → Write Spec → specverify → Pass? → Execute with Agent

The core test: "Can a different AI session generate functionally equivalent code from this specification alone — without additional context?"

If yes, the spec passes. If not, specverify tells you what's missing.

Install

pip install specverify

Or with npm:

npm install specverify

Features (coming in v1.0)

  • 13-item Spec Gate — Structural completeness verification
  • Adversarial Review — Cross-model validation (different AI attacks your spec)
  • Clarity Gate integration — Epistemic quality checks
  • Tool-agnostic — Works with any SDD workflow
  • Git-verified proof — Built and validated with two case studies (46 endpoints in 4.5 hours, hackathon battle test)

Status

🚧 Under active development. Full release planned for April 2026.

Follow progress: github.com/frmoretto/specverify

Background

specverify is the operationalized tool from the Stream Coding methodology's Spec Gate protocol. The concept was first presented at AI Engineer Europe 2026.

Author

Francesco Marinoni Moretto
LinkedIn · GitHub

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

specverify-0.0.1.tar.gz (3.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

specverify-0.0.1-py3-none-any.whl (4.5 kB view details)

Uploaded Python 3

File details

Details for the file specverify-0.0.1.tar.gz.

File metadata

  • Download URL: specverify-0.0.1.tar.gz
  • Upload date:
  • Size: 3.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for specverify-0.0.1.tar.gz
Algorithm Hash digest
SHA256 a876f8d6aacfdec827dc4900468d68082f8e000eafe7ecdbdb9633e8554c4bc2
MD5 148df9f9fec8f5088a47fa6fc9065068
BLAKE2b-256 62f781cf28bc9c024503ca936082d25c147b16a937ef158cb820f4bee2a3745e

See more details on using hashes here.

File details

Details for the file specverify-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: specverify-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 4.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for specverify-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 041b78c997c0fce5f8100d6dd3e5177863be6d4b061ccc90caba4bcb81abe9a8
MD5 7140a20a02dc5f0031ba42fc943dc60b
BLAKE2b-256 de9865a8c89e059f324bc9fca6f12c4103318ee556fd43a22f1e340b95877a5b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page