LeanSpec — Desenvolvimento Orientado a Especificações com IA

Sobre

LeanSpec é um framework leve e flexível para Spec-Driven Development (SDD) — Desenvolvimento Orientado a Especificações — projetado especificamente para fluxos de trabalho modernos com assistentes de IA. O projeto aplica princípios ágeis ao processo de especificação, promovendo documentos pequenos, focados e compreensíveis tanto por humanos quanto por modelos de linguagem.

Repositório: github.com/codervisor/lean-spec
Documentação oficial: lean-spec.dev
Licença: MIT
Linguagem principal: TypeScript (67,9%)

Conceito Central

O LeanSpec parte de um princípio simples: specs pequenas (menos de 2.000 tokens) produzem melhores resultados com IA, são mais fáceis de manter atualizadas e eliminam o “context rot” — a degradação causada por contextos longos e desatualizados.

Problema que resolve

Abordagem	Problema
Frameworks SDD tradicionais	Adicionam overhead de processo, templates rígidos e workflows multi-etapas
Vibe coding (sem especificação)	Rápido, mas caótico — sem entendimento compartilhado entre humano e IA
LeanSpec	Ponto de equilíbrio: iteração rápida com qualidade e alinhamento

Instalação e Início Rápido

Instalação

# Testar com projeto de exemplo
npx lean-spec init --example dark-theme
cd dark-theme && npm install && npm start
 
# Adicionar a um projeto existente
npm install -g lean-spec && lean-spec init

Comandos Principais

lean-spec board    # Visualização Kanban do projeto
lean-spec stats    # Métricas e saúde do projeto
lean-spec ui       # Interface web em localhost:3000
lean-spec search   # Busca specs por conteúdo ou metadados

Integração com IA

O LeanSpec é compatível com qualquer assistente de código via MCP (Model Context Protocol) ou CLI.

Configuração MCP

{
  "mcpServers": {
    "lean-spec": { "command": "npx", "args": ["@leanspec/mcp"] }
  }
}

Assistentes Compatíveis

VS Code Copilot
Cursor
Windsurf
Claude Code
Gemini CLI
E outros assistentes com suporte a MCP ou CLI

Funcionalidades

Funcionalidade	Comando / Descrição
Kanban Board	`lean-spec board` — rastreamento visual de tarefas
Busca inteligente	`lean-spec search` — busca por conteúdo ou metadados
Dependências	Rastreamento de relações entre specs com `depends_on` e `related`
Interface Web	`lean-spec ui` — dashboard em navegador
Estatísticas	`lean-spec stats` — métricas de saúde e detecção de gargalos
Nativo para IA	Servidor MCP + CLI para assistentes de IA

Estrutura do Repositório

lean-spec/
├── .lean-spec/        # Configurações internas do LeanSpec
├── bin/               # Executáveis CLI
├── docs-site/         # Código do site de documentação
├── docs/agents/       # Documentação para agentes IA
├── packages/          # Pacotes do monorepo
├── specs/             # Especificações do próprio projeto
├── scripts/           # Scripts auxiliares
├── AGENTS.md          # Instruções para agentes IA
├── CHANGELOG.md       # Histórico de versões
└── README.md          # Documentação principal

Princípios de Design

Documentos vivos: As specs crescem junto com o código, não são artefatos estáticos
Tamanho controlado: Limite de ~2.000 tokens por spec para máxima eficiência com IA
Agnóstico de ferramenta: Funciona com qualquer assistente de IA via MCP ou CLI
Dependências explícitas: Relacionamentos entre specs rastreados com campos depends_on e related

Alisson's Notes

Explorador

Lean Spec