内容摘录
LeanSpec
<p align="center">
<img src="https://github.com/codervisor/lean-spec-docs/blob/main/static/img/logo-with-bg.svg" alt="LeanSpec Logo" width="120" height="120">
</p>
<p align="center">
<a href="https://github.com/codervisor/lean-spec/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/codervisor/lean-spec/ci.yml?branch=main" alt="CI Status"></a>
<a href="https://www.npmjs.com/package/lean-spec"><img src="https://img.shields.io/npm/v/lean-spec.svg" alt="npm version"></a>
<a href="https://www.npmjs.com/package/lean-spec"><img src="https://img.shields.io/npm/dm/lean-spec.svg" alt="npm downloads"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
</p>
<p align="center">
<a href="https://www.lean-spec.dev"><strong>Documentation</strong></a>
•
<a href="https://www.lean-spec.dev/zh-Hans/docs/guide/"><strong>中文文档</strong></a>
•
<a href="https://web.lean-spec.dev"><strong>Live Examples</strong></a>
•
<a href="https://www.lean-spec.dev/docs/tutorials/first-spec-with-ai"><strong>Tutorials</strong></a>
</p>
---
**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
**Visualize your project:**
**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:
**Compatible with:** VS Code Copilot, Claude Code, Gemini CLI, Cursor, Windsurf, Kiro CLI, Kimi CLI, Qodo CLI, Amp, Trae Agent, Qwen Code, Droid, and more.
📖 Full AI integration guide →
---
Agent Skills
Teach your AI assistant the Spec-Driven Development methodology:
This installs the **leanspec-sdd** skill which teaches AI agents:
When to create specs vs. implement directly
How to discover existing specs before creating new ones
Best practices for context economy and progressive disclosure
Complete SDD workflow (Discover → Design → Implement → Validate)
**Compatible with:** Claude Code, Cursor, Windsurf, GitHub Copilot, and other Agent Skills compatible tools.
📖 View skill documentation →
---
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 |
| **🖥️ Desktop App** | Desktop app repo: codervisor/lean-spec-desktop |
<p align="center">
<img src="https://github.com/codervisor/lean-spec-docs/blob/main/static/img/ui/ui-board-view.png" alt="Kanban Board View" width="800">
</p>
---
Requirements
Runtime
**Node.js**: >= 20.0.0
**pnpm**: >= 10.0.0 (preferred package manager)
Development
**Node.js**: >= 20.0.0
**Rust**: >= 1.70 (for building CLI/MCP/HTTP binaries)
**pnpm**: >= 10.0.0
**Quick Check:**
---
Desktop App
The desktop application has moved to a dedicated repository:
https://github.com/codervisor/lean-spec-desktop
Use that repository for desktop development, CI, and release workflows.
---
Developer Workflow
Common development tasks using pnpm:
See package.json for all available scripts.
---
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"）加入交流群。
<p align="center">
<img src="https://github.com/codervisor/lean-spec-docs/blob/main/static/img/qr-code.png" alt="WeChat Contact | 微信联系" height="280">
</p>