Começando
Fique pronto em apenas 5 minutos
Pré-requisitos
Claude Code CLI instalado
npm install -g @anthropic/claude-code
API Key da Anthropic
https://console.anthropic.com
Repositório Git
Projeto existente ou novo
Sua linguagem/framework preferido
Funciona com qualquer stack
Quick start: 3 passos
Baixe o scaffold
Baixe o pacote .claude/ que funciona com qualquer linguagem
✅ Você deve ter agora um diretório .claude/
Configure seu projeto
Extraia e copie para seu projeto, customize a constitution
$ unzip documentation-first-approach.zip
$ cp -r .claude /path/to/your/project/
$ cp CLAUDE.md /path/to/your/project/
# Your project structure:
your-project/
├── .claude/ ← New!
├── CLAUDE.md ← New!
├── specs/ ← Will be created
└── src/ ← Your code✅ Setup completo! Pronto para criar sua primeira feature
Crie sua primeira feature
Use os commands /vision e /feature para começar a construir
3.1. Inicie o Claude Code:
$ claude3.2. Defina sua visão (se projeto novo):
You: /vision Create a task management app with user
authentication, CRUD operations, and real-time
updates
Claude: [Creates specs/01_introduction/...]3.3. Crie sua primeira feature:
You: /feature User can create a new task with title,
description, and due date
Claude: [Analyzes requirement]
Complexity: LOW
Creating specification...
→ changes/create-task-001/proposal.md
→ changes/create-task-001/spec.md
→ changes/create-task-001/tasks.md
Ready to implement!3.4. Implemente a feature:
You: /code
Claude: [Reads spec, generates tasks, implements]
✅ Task 1: Create Task entity
✅ Task 2: Create task factory
✅ Task 3: Create use case
✅ Task 4: Write tests
✅ All tests passing (95% coverage)
Feature complete!3.5. Revise o código gerado:
src/task-management/tasks/task/
├── index.ts # Exports
├── criar-task.ts # Factory
├── registrar-task.ts # Use case
├── Task.ts # Entity
└── task.spec.ts # Tests (95% coverage)🎉 Parabéns!
Você acabou de criar sua primeira feature usando a Documentation-First Approach!
Cheat sheet de commands
commands essenciais para começar
/visionDefine visão e objetivos do projeto/stackDefine tech stack e constraints/featureCria uma nova feature (cenário BDD)/codeImplementa código a partir das especificações/actorDocumenta um ator/sistema externo/containerDocumenta um building block de alto nível/componentDocumenta um módulo de código/ruleCria/atualiza uma quality rule/adrCria um architecture decision recordSolução de problemas
Claude não reconhece os commands
Solution: Garanta que CLAUDE.md está na raiz do projeto e o diretório .claude/ existe. Reinicie o Claude Code CLI.
Código gerado não combina com meu estilo
Solution: Customize .claude/rules/ com seus padrões de código e atualize constitution.md com seus princípios.
Testes estão falhando após implementação
Solution: Verifique cenários BDD na spec. Garanta que o framework de testes está configurado corretamente. Execute o orchestrator para quebrar em tarefas menores.
Specs estão muito verbosas / não detalhadas o suficiente
Solution: Ajuste complexidade em constitution.md: LOW = capítulos mínimos (apenas 6, 10), MEDIUM = padrão (3, 5, 6, 8, 9, 10), HIGH = todos os 12 capítulos Arc42.
Como migro um projeto existente?
Solution: Comece com /vision para documentar o sistema existente. Use /container para documentar cada componente principal. Refatore gradualmente usando documentation-first. Veja receita: "Migrating Legacy Code".
O que vem depois?
Entrar na comunidade
Discord, fórum e contribuições
em breveTutoriais
Construa um app TODO, checkout de e-commerce e muito mais
em breveReceitas
Como migrar código legado, integrar desenvolvedores e melhores práticas
em brevePesquisa & Dados
Benchmarks, estudos de caso e artigos
em breve