![\"LeanSpec](\"https://github.com/codervisor/lean-spec-docs/blob/main/static/img/logo-with-bg.svg\"){kind=logo}
\n\n \n
\n ![\"CI](\"https://img.shields.io/github/actions/workflow/status/codervisor/lean-spec/ci.yml?branch=main\")
![\"npm](\"https://img.shields.io/npm/v/lean-spec.svg\")
\n ![\"npm](\"https://img.shields.io/npm/dm/lean-spec.svg\")
\n ![\"License\"](\"https://img.shields.io/badge/license-MIT-blue.svg\"){kind=icon}
\n
\n Documentation\n •\n 中文文档\n •\n Live Examples\n •\n Tutorials\n
\n\n---\n\n**Ship faster with higher quality. Lean specs that both humans and AI understand.**\n\nLeanSpec brings agile principles to SDD (Spec-Driven Development)—small, focused documents (<2,000 tokens) that keep you and your AI aligned.\n\n---\n\n## Quick Start\n\n```bash\n# Try with a tutorial project\nnpx lean-spec init --example dark-theme\ncd dark-theme && npm install && npm start\n\n# Or add to your existing project\nnpm install -g lean-spec && lean-spec init\n```\n\n**Visualize your project:**\n\n```bash\nlean-spec board # Kanban view\nlean-spec stats # Project metrics\nlean-spec ui # Web UI at localhost:3000\n```\n\n**Next:** [Your First Spec with AI](https://www.lean-spec.dev/docs/tutorials/first-spec-with-ai) (10 min tutorial)\n\n---\n\n## Why LeanSpec?\n\n**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:\n\n- **Fast iteration** - Living documents that grow with your code\n- **AI performance** - Small specs = better AI output (context rot is real)\n- **Always current** - Lightweight enough that you actually update them\n\n📖 [Compare with Spec Kit, OpenSpec, Kiro →](https://www.lean-spec.dev/docs/guide/why-leanspec)\n\n---\n\n## AI Integration\n\nWorks with any AI coding assistant via MCP or CLI:\n\n```json\n{\n \"mcpServers\": {\n \"lean-spec\": { \"command\": \"npx\", \"args\": [\"@leanspec/mcp\"] }\n }\n}\n```\n\n**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.\n\n📖 [Full AI integration guide →](https://www.lean-spec.dev/docs/guide/usage/ai-coding-workflow)\n\n---\n\n## Agent Skills\n\nTeach your AI assistant the Spec-Driven Development methodology:\n\n```bash\n# Recommended (uses skills.sh)\nlean-spec skill install\n\n# Or directly via skills.sh\nnpx skills add codervisor/lean-spec -y\n```\n\nThis installs the **leanspec-sdd** skill which teaches AI agents:\n- When to create specs vs. implement directly\n- How to discover existing specs before creating new ones\n- Best practices for context economy and progressive disclosure\n- Complete SDD workflow (Discover → Design → Implement → Validate)\n\n**Compatible with:** Claude Code, Cursor, Windsurf, GitHub Copilot, and other [Agent Skills](https://skills.sh/) compatible tools.\n\n📖 [View skill documentation →](skills/leanspec-sdd/SKILL.md)\n\n---\n\n## Features\n\n| Feature | Description |\n| ------------------- | ------------------------------------------------------------------------------------------------- |\n| **📊 Kanban Board** | `lean-spec board` - visual project tracking |\n| **🔍 Smart Search** | `lean-spec search` - find specs by content or metadata |\n| **🔗 Dependencies** | Track spec relationships with `depends_on` and `related` |\n| **🎨 Web UI** | `lean-spec ui` - browser-based dashboard |\n| **📈 Project Stats** | `lean-spec stats` - health metrics and bottleneck detection |\n| **🤖 AI-Native** | MCP server + CLI for AI assistants |\n| **🖥️ Desktop App** | Desktop app repo: [codervisor/lean-spec-desktop](https://github.com/codervisor/lean-spec-desktop) |\n\n\n ![\"Kanban](\"https://github.com/codervisor/lean-spec-docs/blob/main/static/img/ui/ui-board-view.png\")
\n
\n ![\"WeChat](\"https://github.com/codervisor/lean-spec-docs/blob/main/static/img/qr-code.png\")
\n