Usage Overview

LeanSpec provides multiple ways to work with specs, depending on your preferred workflow and use case.

Quick Start

If you're new to LeanSpec, start with:

1. AI Coding Workflow - Learn the recommended workflow for AI-assisted development
2. CLI Usage - Master the essential CLI commands
3. Spec Structure - Understand how to structure your specs

Core Workflows

AI-Powered Development

LeanSpec is designed for AI-first workflows:

• AI Coding Workflow - The recommended SDD workflow
• MCP Integration - Connect AI agents to your specs
• Visual Mode - Browse specs in a web interface

Command Line Interface

Master the CLI for daily spec management:

• Creating & Managing Specs - Create, update, and manage specs
• Finding Specs - Search and discover specs
• Project Management - Track status, dependencies, and health

Spec Structure

Understand how to write effective specs:

• Spec Structure - Anatomy of a LeanSpec

Advanced Features

Once you're comfortable with the basics:

• Templates - Customize spec templates
• Custom Fields - Extend frontmatter
• Variables - Use dynamic variables
• Frontmatter Guide - Advanced frontmatter
• Agent Configuration - Configure AI agents

Choose Your Path

For AI Coding:

1. Read AI Coding Workflow
2. Set up MCP Integration
3. Start creating specs with lean-spec create

For Team Management:

1. Learn CLI Usage
2. Use Visual Mode for overview
3. Track progress with Project Management

For Power Users:

1. Master all CLI commands
2. Customize with Advanced Features
3. Integrate deeply with your toolchain