Documentation • 中文文档 • Live Examples • Tutorials
Ship faster with higher quality. Lean specs that both humans and AI understand.
LeanSpec brings agile principles to SDD (Spec-Driven Development)—small, focused documents (<2,000 tokens) that keep you and your AI aligned.
# Try with a tutorial project
npx lean-spec init --example dark-theme
cd dark-theme && npm install && npm start
# Or add to your existing project
npm install -g lean-spec && lean-spec initVisualize your project:
lean-spec board # Kanban view
lean-spec stats # Project metrics
lean-spec ui # Web UI at localhost:3000Next: Your First Spec with AI (10 min tutorial)
High velocity + High quality. Other SDD frameworks add process overhead (multi-step workflows, rigid templates). Vibe coding is fast but chaotic (no shared understanding). LeanSpec hits the sweet spot:
- Fast iteration - Living documents that grow with your code
- AI performance - Small specs = better AI output (context rot is real)
- Always current - Lightweight enough that you actually update them
📖 Compare with Spec Kit, OpenSpec, Kiro →
Works with any AI coding assistant via MCP or CLI:
{
"mcpServers": {
"lean-spec": { "command": "npx", "args": ["@leanspec/mcp"] }
}
}Compatible with: VS Code Copilot, Cursor, Windsurf, Claude Code, Gemini CLI, and more.
| Feature | Description |
|---|---|
| 📊 Kanban Board | lean-spec board - visual project tracking |
| 🔍 Smart Search | lean-spec search - find specs by content or metadata |
| 🔗 Dependencies | Track spec relationships with depends_on and related |
| 🎨 Web UI | lean-spec ui - browser-based dashboard |
| 📈 Project Stats | lean-spec stats - health metrics and bottleneck detection |
| 🤖 AI-Native | MCP server + CLI for AI assistants |
📖 Full Documentation · CLI Reference · First Principles · FAQ · 中文文档
💬 Discussions · 🐛 Issues · 🤝 Contributing · 📋 Changelog · 📄 LICENSE
If you find LeanSpec helpful, feel free to add me on WeChat (note "LeanSpec") to join the discussion group.
如果您觉得 LeanSpec 对您有帮助,欢迎添加微信(备注 "LeanSpec")加入交流群。

