Quick Start — Context Engineering

Comece aqui! Estrutura de projeto e comandos essenciais do Claude CLI.

📁 Estrutura de Projeto Completa

Esta é a estrutura recomendada para um projeto que utiliza o Context Engineering Framework.
Clique nos arquivos .md para baixar o template correspondente.

meu-projeto/
│
├── .claude/                          # ⚙️ Configuração Claude CLI
│   ├── settings.json                 # Ver Guia MCP
│   └── commands/                     # Comandos customizados (opcional)
│
├── .github/                          # 🔄 CI/CD
│   └── workflows/
│       ├── ci.yml
│       └── deploy.yml
│
├── docs/                             # 📚 Documentação do Projeto
│   │
│   ├── context/                      # 📝 FASE 01 - Ideação
│   │   ├── document_context.md       # Documento de contexto principal
│   │   ├── flow.excalidraw           # Diagrama de fluxo (opcional)
│   │   └── mindmap.md                # Mapa mental (opcional)
│   │
│   ├── architecture/                 # 🏗️ FASE 02 - Contexto Técnico
│   │   ├── technical_context.md      # Especificação técnica completa
│   │   ├── architecture.excalidraw   # Diagrama de arquitetura
│   │   └── c4/                       # Diagramas C4 (opcional)
│   │       ├── context.md
│   │       ├── container.md
│   │       └── component.md
│   │
│   ├── adrs/                         # 📋 Architecture Decision Records
│   │   ├── ADR-001-stack-choice.md
│   │   ├── ADR-002-database.md
│   │   └── ADR-template.md
│   │
│   ├── guidelines/                   # 📏 Padrões do Projeto
│   │   ├── coding.md                 # Padrões de código
│   │   ├── testing.md                # Padrões de teste
│   │   ├── api.md                    # Padrões de API
│   │   ├── git.md                    # Convenções Git
│   │   └── devops.md                 # Padrões DevOps
│   │
│   ├── libs/                         # 📚 FASE 03 - Documentação de Libs
│   │   ├── spring-boot-3.3.md        # Gerado via Context7 MCP
│   │   ├── vue-3.5.md                # Gerado via Context7 MCP
│   │   ├── postgresql-16.md          # Gerado via Firecrawl MCP
│   │   └── ...
│   │
│   ├── stacks/                       # 📦 Templates de Stack (opcional)
│   │   ├── java-spring.md            # Stack Java Spring
│   │   ├── python.md                 # Stack Python
│   │   ├── node.md                   # Stack Node.js
│   │   ├── angular.md                # Stack Angular
│   │   ├── vue.md                    # Stack Vue.js
│   │   └── streamlit.md              # Stack Streamlit
│   │
│   ├── prps/                         # 📋 PHASE 04 - Product Requirement Prompts
│   │   ├── PRP-001-auth.md           # PRP par feature
│   │   ├── PRP-002-dashboard.md
│   │   ├── PRP-003-api-crud.md
│   │   └── ...
│   │
│   └── rag/                          # 📂 Sources Externes (RAG)
│       ├── confluence/               # Exports Confluence
│       ├── requirements/             # PRDs, specs, exigences
│       ├── meetings/                 # Comptes-rendus
│       └── legacy/                   # Docs système ancien
│
├── src/                              # ⚡ PHASE 05 - Code source
│   ├── main/
│   │   ├── java/                     # ou /ts, /py, etc.
│   │   │   └── com/projeto/
│   │   │       ├── config/
│   │   │       ├── controller/
│   │   │       ├── service/
│   │   │       ├── repository/
│   │   │       ├── model/
│   │   │       └── dto/
│   │   └── resources/
│   │       ├── application.yml
│   │       └── db/migration/
│   └── test/
│       └── java/
│           └── com/projeto/
│
├── frontend/                         # (se aplicável)
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── services/
│   │   └── stores/
│   └── package.json
│
├── infra/                            # 🔧 Infraestrutura
│   ├── docker/
│   │   ├── Dockerfile
│   │   └── docker-compose.yml
│   ├── k8s/                          # Kubernetes manifests
│   │   ├── deployment.yml
│   │   └── service.yml
│   └── terraform/                    # IaC (opcional)
│
├── scripts/                          # 🔨 Scripts utilitários
│   ├── setup.sh
│   └── deploy.sh
│
├── CLAUDE.md                         # 🤖 REGRAS PARA O AGENTE IA
├── README.md                         # 📖 Documentação pública
├── CHANGELOG.md                      # 📝 Histórico de mudanças
├── .env.example                      # 🔐 Variáveis de ambiente (template)
├── .gitignore
└── pom.xml / package.json / etc.     # Configuração do build

🖥️ Claude CLI — Guia Completo de Comandos

O Claude CLI é a ferramenta de linha de comando para interagir com Claude. Abaixo estão todos os comandos e como usá-los com a estrutura do Context Engineering.

Instalação e Setup Inicial

# Instalar Claude CLI (via npm)
npm install -g @anthropic-ai/claude-cli

# Fazer login
claude login

# Verificar instalação
claude --version

# Iniciar em modo interativo
claude

# Iniciar com prompt direto
claude "explique este código"

Comandos Slash (/) — Dentro do Claude CLI

Quando estiver no modo interativo do Claude CLI, use estes comandos:

Contexto e Arquivos

Execução e Automação

Memória e Histórico

Configuração e MCPs

Modo de Edição

Git e Commits

🔄 Workflow Completo por Fase

Fase 01 — Ideação (Criar document_context.md)

# 1. Iniciar Claude CLI na pasta do projeto
cd meu-projeto
claude

# 2. Criar documento de contexto via conversa
> Preciso criar um sistema de gestão de tarefas. Me ajude a documentar os requisitos.

# 3. Salvar o resultado
> Salve isso em docs/context/document_context.md

# Ou usar prompt direto:
claude "Crie um document_context.md para um sistema de gestão de tarefas" > docs/context/document_context.md

Fase 02 — Contexto Técnico

# 1. Carregar documento de contexto
claude
> /read docs/context/document_context.md

# 2. Gerar especificação técnica
> Com base neste contexto, crie o technical_context.md definindo a stack, arquitetura e decisões técnicas

# 3. Gerar CLAUDE.md
> Agora crie o CLAUDE.md com as regras para desenvolvimento deste projeto

# 4. Gerar guidelines
> Crie os arquivos de guidelines: coding.md, testing.md, api.md, git.md, devops.md

# 5. Criar ADR
> Crie o ADR-001 documentando a escolha da stack

Fase 03 — Preparação (Docs de Libs)

# 1. Com Context7 MCP instalado
claude
> /read docs/architecture/technical_context.md

# 2. Gerar docs das bibliotecas
> Use o Context7 para buscar a documentação do Spring Boot 3.3 e salve em docs/libs/spring-boot-3.3.md

# 3. Repetir para cada lib
> Busque docs do Vue 3.5 e salve em docs/libs/vue-3.5.md

Fase 04 — Planeamento (PRPs)

# 1. Carregar todo o contexto
claude
> /read docs/context/document_context.md
> /read docs/architecture/technical_context.md
> /read docs/libs/

# 2. Criar PRPs
> Liste as features do projeto e crie um PRP para cada uma

# 3. Salvar PRPs
> Salve o PRP de autenticação em docs/prps/PRP-001-auth.md

Fase 05 — Desenvolvimento

# 1. Iniciar desenvolvimento de uma feature
claude
> /read CLAUDE.md
> /read docs/prps/PRP-001-auth.md
> /read docs/guidelines/

# 2. Executar o PRP
> /execute docs/prps/PRP-001-auth.md

# 3. Ou usar modo plan
> /plan
> Implementar o sistema de autenticação conforme PRP-001
> /do

# 4. Revisar alterações
> /diff

# 5. Aplicar e commitar
> /apply
> /commit

🎯 Comandos por Caso de Uso

Iniciar Projeto Novo

# Criar estrutura de pastas
mkdir -p meu-projeto/{docs/{context,architecture,adrs,guidelines,libs,prps},src,frontend,infra}
cd meu-projeto

# Iniciar Claude e criar documentação base
claude
> Estou iniciando um novo projeto. Me ajude a criar a estrutura de documentação.
> /read docs/  # verificar o que já existe

Continuar Projeto Existente

cd meu-projeto
claude
> /read CLAUDE.md
> /read docs/architecture/technical_context.md
> O que devo fazer agora?

Implementar Feature

claude
> /read CLAUDE.md
> /read docs/prps/PRP-002-dashboard.md
> /execute docs/prps/PRP-002-dashboard.md

Debugging

claude
> /read src/services/auth.ts
> /run npm test -- --grep "auth"
> Me ajude a debugar este erro: [colar erro]

Code Review

claude
> /review
> Revise as alterações que fiz hoje
> /diff

Criar Commit

claude
> /diff
> /commit
# Claude gera mensagem de commit baseada nas alterações

Criar PR

claude
> /pr
# Claude cria PR com descrição baseada nos commits

⚙️ Configuração Avançada

Arquivo .claude/settings.json (por projeto)

{
  "model": "claude-sonnet-4-20250514",
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "./docs", "./src"]
    }
  },
  "contextFiles": [
    "CLAUDE.md",
    "docs/architecture/technical_context.md"
  ],
  "permissions": {
    "allowedCommands": ["npm", "mvn", "gradle", "git"],
    "allowFileWrites": true
  }
}

Arquivo ~/.claude/settings.json (global)

{
  "defaultModel": "claude-sonnet-4-20250514",
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    }
  },
  "theme": "dark",
  "autoSave": true
}

Comandos Customizados (.claude/commands/)

Crie arquivos .md em .claude/commands/ para comandos personalizados:

<!-- .claude/commands/new-feature.md -->
# Criar Nova Feature

1. Leia o CLAUDE.md
2. Leia o technical_context.md
3. Crie um novo PRP em docs/prps/
4. Liste os arquivos que serão criados/modificados
5. Peça confirmação antes de implementar

Uso:

claude
> /new-feature dashboard de métricas

📊 Tabela de Referência Rápida

🔗 Referências

• Claude CLI Docs
• Guia Completo de MCPs
• MCP Servers Repository

📎 Referência de Templates

Cada arquivo .md na estrutura tem um template disponível para download:

Templates por Stack (Fase 02)

Configuração Claude CLI

Próximos Passos

Agora que você conhece a estrutura e os comandos, explore:

• Framework Completo — As 5 fases em detalhes, templates e padrões
• Guia de MCPs — Configuração completa de MCPs para Claude CLI

Context Engineering Framework v4.0 — InfoWhere × Claude