Skip to content

codervisor/lean-spec

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LeanSpec

LeanSpec Logo

CI Status npm version npm downloads License

Documentation中文文档Live ExamplesTutorials


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

Kanban Board View


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")加入交流群。

WeChat Contact | 微信联系