Começando

Fique pronto em apenas 5 minutos

⏱️ Tempo até primeira feature: ~5 minutos📦 Sem setup complexo necessário🚀 Funciona com seu projeto existente

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

1

Baixe o scaffold

Baixe o pacote .claude/ que funciona com qualquer linguagem

ir para página de download →

✅ Você deve ter agora um diretório .claude/

2

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

3

Crie sua primeira feature

Use os commands /vision e /feature para começar a construir

3.1. Inicie o Claude Code:

$ claude

3.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 record

Soluçã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?

Aprender fundamentos

Entenda os frameworks Arc42, C4, BDD e ADR

ler documentação →

Explorar ferramentas

15 commands, 9 agents, 39 quality rules

ver ferramentas →

Entrar na comunidade

Discord, fórum e contribuições

em breve

Tutoriais

Construa um app TODO, checkout de e-commerce e muito mais

em breve

Receitas

Como migrar código legado, integrar desenvolvedores e melhores práticas

em breve

Pesquisa & Dados

Benchmarks, estudos de caso e artigos

em breve