What is SpecWeave?
SpecWeave is the AI development framework that doesn't lose your work.
Every AI coding tool promises productivity. But after the chat ends, your specs disappear into chat history, your architecture decisions are forgotten, and new team members start from zero.
SpecWeave is the only framework where AI decisions become permanent, searchable documentation.
The Problem: Lost Work
Traditional AI-assisted development:
- Tell AI: "Build me a feature"
- AI generates code
- Test it manually
- Fix bugs as they appear
- (Maybe) document it later
- Repeat for next feature
The result:
- No documentation = regression risk
- No specs = unclear requirements
- Manual testing = inconsistent quality
- Context bloat = expensive AI costs
- No architecture = technical debt
- New team members = 2 weeks onboarding
The Solution: Permanent Knowledge
SpecWeave enforces Spec-Driven Development:
Key Principles
- Plan > Code - The plan is the source of truth; code is its derivative. Bad plans create orders of magnitude more rework than bad code — review the plan, not just the code (learn more)
- Specification Before Implementation - Define WHAT and WHY before HOW
- One Increment at a Time - Each feature is a focused, reviewable unit of work — controllable through your sprint or external tools (GitHub, JIRA, ADO)
- Living Documentation - Specs evolve with code, never diverge
- Context Precision - Load only what's needed (70%+ token reduction)
- Test-Validated Features - Every feature proven through automated tests
- Regression Prevention - Document existing code before modification
- Framework Agnostic - Works with ANY tech stack (TypeScript, Python, Go, Rust, Java, etc.)
How It Works
1. One Command Creates Foundation
/specweave:increment "Add dark mode toggle"
AI agents (PM, Architect, Planner) create:
.specweave/increments/0001-dark-mode/
├── spec.md <- WHAT: User stories, acceptance criteria
├── plan.md <- HOW: Architecture, ADRs, tech decisions
└── tasks.md <- DO: Tasks with embedded tests
2. One Command Builds
/specweave:do
Autonomous execution through all tasks with quality validation.
3. One Command Closes
/specweave:done 0001
Three quality gates validate completion:
- All tasks complete
- 60%+ test coverage
- Living docs updated
4. Auto-Sync Everywhere
Your work syncs to GitHub Issues, JIRA, and Azure DevOps automatically.
Who Should Use SpecWeave?
Perfect For
- Enterprise teams building production systems
- Startups needing scalable architecture from day one
- Solo developers building complex applications
- Regulated industries (healthcare - HIPAA, finance - SOC 2)
- Teams migrating brownfield codebases to modern practices
Use Cases
- Greenfield projects: Start with comprehensive specs
- Brownfield projects: Document existing code before modification
- Iterative development: Build documentation gradually
- Compliance-heavy: Maintain audit trails and traceability
Core Features
| Feature | Benefit | Uniqueness |
|---|---|---|
| 70%+ Token Reduction | Plugin architecture loads only active increment + relevant agent = ~15K tokens (vs 200K+) | ⭐ Unique |
| Brownfield Excellence | Import existing docs (Notion, Confluence, Wiki), create retroactive specs, ADRs | ⭐ Unique |
| Living Documentation | Specs auto-update after every task via hooks—never drift from code | ⭐ Unique |
| External Sync | Push specs to GitHub/JIRA/ADO, read status back—keep existing workflows | Strong |
| Quality Gates | Three-gate validation (tasks + 60%+ tests + docs) before closing | Strong |
| 68+ AI Agents | PM, Architect, Tech Lead, QA, Security, DevOps work autonomously (Claude Opus 4.6) | Good |
| Universal Stack | Works with ANY tech stack and ANY AI tool (Claude, Cursor, Copilot) | Expected |
What You Get vs. Current State
| Before | After SpecWeave |
|---|---|
| Specs in chat history | Permanent, searchable specs |
| Manual JIRA/GitHub updates | Auto-sync on every task |
| Tests? Maybe later... | Tests embedded in tasks (60%+ enforced) |
| Architecture in your head | ADRs captured automatically |
| "Ask John, he knows" | Living docs, always current |
| Onboarding: 2 weeks | Onboarding: 1 day |
Getting Started
npm install -g specweave
cd your-project
specweave init .
Then in Claude Code:
/specweave:increment "Add dark mode toggle"
/specweave:do
/specweave:done 0001
Pro tip: Use /specweave:next to flow through the entire cycle. One command auto-closes completed work and suggests what's next — review specs/tasks when needed, otherwise just keep clicking "next".
Next: Key Features ->