AI-SDD CLI — Spec-Driven Development no seu Terminal

Pré-requisitos

Node.js (versão LTS mais recente)
Agente de IA para código instalado: Claude Code, Cursor, Gemini CLI, Codex CLI, GitHub Copilot, Qwen Code, Windsurf

Instalação

# Abra seu terminal e vá para o diretório do projeto, ou crie um novo
mkdir meu-novo-projeto
cd meu-novo-projeto
npx ai-sdd --lang pt  # Selecione seu agente de IA da lista

# Inicie seu Assistente de IA
claude  # ou gemini, etc.

# Pronto! Agora é só conversar com seu agente:
# Inicie uma especificação para um aplicativo web de Calculadora de Aposentadoria

Dois Caminhos

# Inicie o agente de IA e comece o desenvolvimento spec-driven imediatamente
/sdd:spec-init "Construir uma Calculadora de Aposentadoria" # A spec é iniciada
/sdd:spec-requirements calculadora-aposentadoria              # Requisitos são gerados
/sdd:spec-design calculadora-aposentadoria                    # Design é criado
/sdd:spec-tasks calculadora-aposentadoria                     # Divide em tarefas
/sdd:spec-impl calculadora-aposentadoria                      # Executa com TDD

# Primeiro estabeleça o contexto do projeto, depois prossiga com o desenvolvimento
/sdd:steering                                  # A IA aprende o contexto do projeto existente

/sdd:spec-init "Adicionar Checkout como Convidado ao e-commerce existente"
/sdd:spec-requirements checkout-convidado
/sdd:validate-gap checkout-convidado               # Opcional: Analisar existente vs requisitos
/sdd:spec-design checkout-convidado
/sdd:validate-design checkout-convidado            # Opcional: Validar integração do design
/sdd:spec-tasks checkout-convidado                 # Divide em tarefas de implementação
/sdd:spec-impl checkout-convidado                  # Executa com TDD

Artefatos Gerados

Gerado em aproximadamente 10 minutos:

requirements.md

Requisitos no formato EARS

design.md

Arquitetura com diagramas Mermaid

tasks.md

Tarefas de implementação com dependências

Casos de Uso

Em vez de executar comandos, converse com seu agente de IA. Aprove cada fase antes de prosseguir para a próxima.

Você "Inicie uma spec para uma Calculadora de Aposentadoria"

AI Gera requirements.md e revisa com você

Você "Os requisitos estão bons — aprove"

AI ✅ Requisitos aprovados. Gerando design.md...

Você "Design está sólido — aprove"

AI ✅ Design aprovado. Dividindo em tasks.md...

Você "Tarefas estão corretas — aprove"

AI ✅ Tarefas aprovadas. Implementando com TDD...

O que commitar (e o que não commitar)

npx ai-sdd monta a camada de ferramentas do agente — .claude/, CLAUDE.md, .sdd/settings/. As specs e os arquivos de steering são criados separadamente, conforme você executa os comandos de spec e steering. Esses sim são a linguagem compartilhada do projeto. Commite os artefatos, não as ferramentas.

Adicione estas linhas ao seu .gitignore:

# Arquivos de agente AI-SDD (Claude Code — regenere com `npx ai-sdd`)
CLAUDE.md
.claude/
.sdd/settings/

Cada desenvolvedor executa npx ai-sdd para montar os arquivos do agente localmente.

Mantenha .sdd/specs/ e .sdd/steering/ no controle de versão.

Alguns times preferem versionar CLAUDE.md e .claude/commands/ para compartilhar instruções e comandos customizados. Escolha o que funciona para o seu time — os arquivos de spec e steering foram projetados para serem commitados como sua trilha de auditoria spec-as-code.

Saiba mais

ai-sdd.com npm i ai-sdd

Um framework para agentes de IA que implementa Spec-Driven Development (SDD)