DoneSpec v0.1.0 — Initial MVP

DoneSpec is a deterministic validation system for AI agent task completion.

Core philosophy:

Done means deterministically verified.

What is included

• donespec validate done.json
• Human-readable CLI output
• JSON output with --json
• Deterministic validation engine
• Checker registry architecture
• JSON Schema validation
• GitHub Action integration
• Example task specs
• Self-validation spec
• Pytest test suite
• Ruff linting and formatting
• OSS-ready documentation

Supported MVP checks

• command
• file_exists
• regex_in_file
• regex_absent
• file_not_modified
• http_check

Install locally

pip install donespec

For local development:

git clone https://github.com/xryv/DoneSpec.git
cd DoneSpec
python -m pip install -e ".[dev]"
donespec validate done.json

Status

This is the first working MVP release.

DoneSpec is intentionally small, local-first, deterministic, and designed as infrastructure for validating AI coding agent outputs.