LeanSpec

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.

Quick Start

# 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 init

Visualize your project:

lean-spec board    # Kanban view
lean-spec stats    # Project metrics
lean-spec ui       # Web UI at localhost:3000

Next: Your First Spec with AI (10 min tutorial)

Why LeanSpec?

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 →

AI Integration

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.

📖 Full AI integration guide →

Features

| 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 |

Documentation

📖 Full Documentation · CLI Reference · First Principles · FAQ · 中文文档

Community

💬 Discussions · 🐛 Issues · 🤝 Contributing · 📋 Changelog · 📄 LICENSE

Contact Me | 联系我

If you find LeanSpec helpful, feel free to add me on WeChat (note "LeanSpec") to join the discussion group.

如果您觉得 LeanSpec 对您有帮助，欢迎添加微信（备注 "LeanSpec"）加入交流群。