SpecSafe is a skills-first TDD framework that keeps AI coding agents aligned with your intent.

SpecSafe

SpecSafe is a skills-first TDD framework for AI-assisted development. It gives your AI coding agent structured workflows so that every feature starts with a clear spec, gets validated by tests, and ships as intended.

The Problem

AI coding agents are powerful, but without structure they drift:

Vague requirements lead to features nobody asked for
Skipped tests let regressions slip through
Unplanned architecture creates technical debt from day one

The result? You spend more time correcting the AI than you saved by using it.

How SpecSafe Fixes This

SpecSafe introduces a two-phase workflow that mirrors how experienced teams already work:

Planning Phase -- Define what you are building, why, and how it should behave. SpecSafe captures this in a structured spec before any code is written.
Development Phase -- Implement using a strict red-green-refactor TDD cycle. Tests are generated from the spec, code is written to pass them, and QA validates the result.

Every step is driven by skills -- focused instructions your AI tool loads on demand. No prompt engineering required.

What You Get

8 AI personas that guide planning, coding, testing, and QA
22 skills covering the full development lifecycle
Support for 8 AI tools: Claude Code, Cursor, OpenCode, Aider, Zed, Gemini CLI, Continue, and Antigravity
A single source of truth (PROJECT_STATE.md) that tracks every spec from idea to completion

Quick Start

Install SpecSafe globally and initialize your project:

npm install -g @specsafe/cli
specsafe init

The init command walks you through an interactive setup -- it asks for your project name, detects which AI tools you use, and installs the appropriate skill files automatically. That's it. Your AI tool now has access to SpecSafe skills like /specsafe-new, /specsafe-spec, /specsafe-test, /specsafe-code, and more.

Works with existing projects

You can run specsafe init inside any existing project directory. SpecSafe adds a specs/ folder and configuration files without touching your source code.

Next Steps

Installation -- Prerequisites and setup details
Quick Start -- Walk through your first spec from creation to completion
Project Structure -- Understand what SpecSafe creates in your project

Introduction