Introducing SpecWeave - Spec-Driven Development for AI Era
We're excited to introduce SpecWeave, a revolutionary framework that replaces vibe coding with Spec-Driven Development.
The Problem: Vibe Coding Doesn't Scale
Traditional development with AI assistants suffers from:
- ❌ No source of truth - Specifications drift from implementation
- ❌ Context overload - Loading entire codebases wastes tokens
- ❌ Brownfield chaos - Modifying existing code causes regressions
- ❌ Tech stack assumptions - Tools assume Next.js, ignore Python/Go
- ❌ Documentation debt - Docs become outdated immediately
The Solution: SpecWeave
SpecWeave is a specification-first AI development framework where:
✅ Specifications are SOURCE OF TRUTH - Code expresses specs in a language ✅ Context Precision - Load only what's needed (70%+ token reduction) ✅ Regression Prevention - Document before modifying (brownfield-ready) ✅ Framework-Agnostic - Works with ANY tech stack (TypeScript, Python, Go, Rust, Java) ✅ Living Documentation - Auto-updates via Claude Code hooks ✅ Test-Validated - E2E tests ensure features work (closed-loop validation)
Key Features
1. Framework-Agnostic Commands
/create-project --type python --framework fastapi
/create-increment "user authentication"
/review-docs --increment 003
Commands detect your tech stack and adapt automatically.
2. Selective Agent Installation
Install ONLY the agents you need:
# Python API project: 7 agents (1,050 tokens)
npx specweave install --detect
# vs Loading ALL 19 agents (2,600 tokens) ❌
60% token reduction on agents!
3. Context Manifests
# .specweave/increments/001-auth/context-manifest.yaml
spec_sections:
- .specweave/docs/internal/strategy/auth/
documentation:
- .specweave/docs/internal/architecture/auth-system.md
max_context_tokens: 10000
Load exactly what's needed - 70%+ token savings.
4. Increment Lifecycle
backlog → planned → in-progress → completed → closed
Track features with WIP limits, transfer leftovers, maintain focus.
5. Flexible Documentation
Supports BOTH approaches:
- Enterprise: Comprehensive upfront (500-600+ pages)
- Startup: Incremental/evolutionary (build as you go)
Tech Stack Support
SpecWeave works with ANY language/framework:
| Language | Frameworks | Agent |
|---|---|---|
| TypeScript | Next.js, NestJS, Express | nextjs, nodejs-backend |
| Python | FastAPI, Django, Flask | python-backend |
| Go | Gin, Echo, Fiber | (coming soon) |
| Rust | Actix, Rocket | (coming soon) |
| .NET | ASP.NET Core | dotnet-backend |
| Java | Spring Boot | (coming soon) |
Getting Started
# Install SpecWeave
npx specweave init
# Create your first project
/create-project --type python --framework fastapi
# Start building
/create-increment "user authentication"
What's Next?
- 🔧 Integration Agents - JIRA, Azure DevOps, GitHub sync
- 📊 Diagram Agents - C4 diagrams, sequence diagrams
- 🎨 Figma Integration - Design to code workflow
- 🧪 Test Import - Import existing tests to SpecWeave
- 🚀 Deployment Intelligence - Cost optimization, Hetzner/AWS/Railway
Learn More
Join the revolution. Build production software with confidence, clarity, and continuous validation.
⭐ Star us on GitHub if you like SpecWeave!