Claude Code Compound Engineering

O plugin Compound Engineering estende o Claude Code com agentes especializados, comandos slash, habilidades e fluxos de trabalho estruturados para ciclos de Planear, Trabalhar, Rever e Compor.

Instalacao

Passo	Comando
Instalar Claude Code	Siga a configuracao em claude.ai/code
Clonar plugin	git clone https://github.com/anthropics/claude-code-plugins
Adicionar ao Claude Code	Adicione o caminho do plugin nas configuracoes do Claude Code
Verificar	Execute /help no Claude Code para ver os comandos disponiveis

Ciclo de Fluxo de Trabalho Principal

Fase	Comando Slash	Descricao
Planear	/plan	Transformar descricoes de funcionalidades em planos de implementacao estruturados
Trabalhar	/lfg	Engenharia autonoma completa — executar planos com coordenacao multi-agente
Rever	/review-pr	Revisao abrangente de PR usando agentes especializados em paralelo
Compor	/compound	Documentar problemas resolvidos para construir conhecimento institucional

Comandos Slash

Planeamento e Arquitetura

Comando	Descricao
/plan	Criar planos de implementacao estruturados com detalhe ao nivel de ficheiro
/brainstorm	Explorar requisitos e abordagens antes de planear
/deepen-plan	Melhorar um plano com agentes de pesquisa em paralelo para profundidade e boas praticas
/plan_review	Ter multiplos agentes especializados a rever um plano em paralelo

Desenvolvimento e Execucao

Comando	Descricao
/lfg	Fluxo completo de engenharia autonoma — planear, implementar, testar, rever
/resolve_parallel	Resolver todos os comentarios TODO usando processamento paralelo
/resolve_pr_parallel	Resolver todos os comentarios de PR usando processamento paralelo
/resolve_todo_parallel	Resolver todos os todos pendentes do CLI usando processamento paralelo

Revisao e Qualidade

Comando	Descricao
/review-pr	Revisao abrangente de PR com agentes especializados (codigo, seguranca, desempenho)
/code-review	Rever uma alteracao de codigo especifica contra o plano e padroes
/test-browser	Executar testes de navegador em paginas afetadas pelo PR ou branch atual
/reproduce-bug	Reproduzir e investigar bugs usando logs, consola e capturas de ecra

Documentacao e Conhecimento

Comando	Descricao
/compound	Documentar um problema resolvido para conhecimento institucional
/changelog	Criar changelogs envolventes para merges recentes no main
/deploy-docs	Validar e preparar documentacao para GitHub Pages
/release-docs	Construir e atualizar site de documentacao com componentes atuais

Utilitarios

Comando	Descricao
/generate_command	Criar um novo comando slash personalizado
/triage	Triagem e categorizacao de descobertas para o sistema de todos do CLI
/feature-video	Gravar um video de demonstracao de funcionalidade e adicionar a descricao do PR
/agent-native-audit	Executar revisao abrangente de arquitetura nativa de agentes

Agentes Especializados

Agentes de Revisao de Codigo

Agente	Finalidade
code-reviewer	Reve bugs, erros de logica, seguranca e qualidade de codigo
code-simplifier	Simplifica codigo para clareza mantendo funcionalidade
silent-failure-hunter	Identifica falhas silenciosas e tratamento de erros inadequado
comment-analyzer	Analisa comentarios quanto a precisao e manutenibilidade
pr-test-analyzer	Reve qualidade e completude da cobertura de testes
type-design-analyzer	Analise especializada de design de tipos e invariantes
code-simplicity-reviewer	Passagem final para conformidade YAGNI e complexidade minima

Agentes de Arquitetura e Seguranca

Agente	Finalidade
architecture-strategist	Avalia decisoes de design de sistema e limites de componentes
security-sentinel	Auditorias de seguranca, avaliacao de vulnerabilidades, conformidade OWASP
performance-oracle	Analisa desempenho, algoritmos, gargalos, escalabilidade
agent-native-reviewer	Garante que funcionalidades sao acessiveis a agentes, nao apenas humanos
pattern-recognition-specialist	Deteta padroes de design, anti-padroes e duplicacao de codigo

Revisores Especificos por Linguagem

Agente	Finalidade
kieran-rails-reviewer	Revisao rigorosa de convencoes e qualidade Rails
kieran-python-reviewer	Revisao rigorosa de convencoes e qualidade Python
kieran-typescript-reviewer	Revisao rigorosa de convencoes e qualidade TypeScript
dhh-rails-reviewer	Revisao Rails da perspetiva do DHH — detecao de anti-padroes
julik-frontend-races-reviewer	Detecao de condicoes de corrida no frontend em JS/Stimulus

Agentes de Dados e Implantacao

Agente	Finalidade
data-integrity-guardian	Migracoes de base de dados, restricoes de dados, integridade referencial
data-migration-expert	Valida mapeamentos de ID, seguranca de rollback, transformacoes de dados
deployment-verification-agent	Checklists pre/pos-implantacao, verificacao SQL, planos de rollback

Agentes de Pesquisa

Agente	Finalidade
framework-docs-researcher	Obtem documentacao abrangente de frameworks e boas praticas
learnings-researcher	Pesquisa aprendizados institucionais em docs/solutions/
best-practices-researcher	Recolhe boas praticas externas de documentacao e OSS
git-history-analyzer	Analise arqueologica do historico git e evolucao do codigo
repo-research-analyst	Analise abrangente da estrutura e padroes do repositorio

Agentes de Design

Agente	Finalidade
figma-design-sync	Sincroniza implementacao com designs do Figma
design-implementation-reviewer	Verifica se a UI corresponde as especificacoes do Figma
design-iterator	Refinamento iterativo de design atraves de N ciclos de captura-analise-correcao

Habilidades

Habilidades de Desenvolvimento

Habilidade	Gatilho
frontend-design	Construir componentes web com alta qualidade de design
agent-native-architecture	Projetar aplicacoes onde agentes sao cidadaos de primeira classe
dspy-ruby	Framework Ruby para aplicacoes LLM composiveis e type-safe
andrew-kane-gem-writer	Escrever gems Ruby seguindo padroes Andrew Kane
dhh-rails-style	Escrever codigo Ruby/Rails no estilo DHH da 37signals

Habilidades de Fluxo de Trabalho

Habilidade	Gatilho
brainstorming	Explorar intencao e abordagens antes da implementacao
git-worktree	Gerir Git worktrees para desenvolvimento paralelo isolado
file-todos	Gerir sistema de acompanhamento de tarefas baseado em ficheiros
every-style-editor	Rever e editar texto para o guia de estilo da Every
compound-docs	Capturar problemas resolvidos como documentacao categorizada

Habilidades de Integracao de Ferramentas

Habilidade	Gatilho
agent-browser	Automacao de navegador usando o CLI agent-browser da Vercel
rclone	Carregar e sincronizar ficheiros entre provedores de armazenamento em nuvem
gemini-imagegen	Gerar e editar imagens usando a API Gemini
xcode-test	Compilar e testar aplicacoes iOS no simulador
skill-creator	Guia para criar novas habilidades eficazes

Hooks

Hook	Evento	Finalidade
SessionStart	Inicializacao de sessao	Configurar contexto, carregar memorias
PreToolUse	Antes da execucao da ferramenta	Validar, bloquear comandos perigosos
PostToolUse	Apos execucao da ferramenta	Processar resultados, acionar acoes subsequentes
Stop	Conclusao do agente	Verificacoes finais, limpeza
UserPromptSubmit	Utilizador envia mensagem	Pre-processar entrada do utilizador

Fluxo de Revisao Multi-Agente

O comando /review-pr lanca multiplos agentes especializados em paralelo:

┌─────────────────────────────────────────────────┐
│                  /review-pr                      │
├─────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐      │
│  │ Code     │  │ Security │  │ Perf     │      │
│  │ Reviewer │  │ Sentinel │  │ Oracle   │      │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘      │
│       │              │              │            │
│  ┌────┴─────┐  ┌────┴─────┐  ┌────┴─────┐      │
│  │ Silent   │  │ Type     │  │ Pattern  │      │
│  │ Failure  │  │ Design   │  │ Recog.   │      │
│  └────┬─────┘  └────┬─────┘  └────┴─────┘      │
│       └──────────┬───┘──────────────┘            │
│            Consolidated Report                   │
└─────────────────────────────────────────────────┘

Casos de Uso Comuns

Desenvolvimento de Funcionalidades

# 1. Fazer brainstorm da abordagem
/brainstorm

# 2. Criar um plano estruturado
/plan

# 3. Aprofundar com agentes de pesquisa
/deepen-plan

# 4. Executar de forma autonoma
/lfg

# 5. Rever o PR
/review-pr

# 6. Documentar o que aprendeu
/compound

Resolver Comentarios de PR

# Resolver todos os comentarios de PR em paralelo
/resolve_pr_parallel

# Ou resolver TODOs em todo o codigo
/resolve_parallel

Criar Comandos Personalizados

# Gerar um novo comando slash
/generate_command

# Criar uma nova habilidade
Use a habilidade skill-creator para orientacao

Configuracao

Estrutura do Plugin

compound-engineering/
├── plugin.json          # Manifesto do plugin
├── commands/            # Definicoes de comandos slash
│   ├── lfg.md
│   ├── plan.md
│   ├── review-pr.md
│   └── ...
├── agents/              # Definicoes de agentes
│   ├── code-reviewer.md
│   ├── security-sentinel.md
│   └── ...
├── skills/              # Definicoes de habilidades
│   ├── frontend-design/
│   ├── agent-native-architecture/
│   └── ...
└── hooks/               # Hooks de eventos
    ├── session-start.md
    └── ...

Configuracao de Agentes

Os agentes sao definidos em ficheiros Markdown com frontmatter YAML:

---
name: "code-reviewer"
description: "Reviews code for bugs, logic errors, and quality"
tools:
  - Glob
  - Grep
  - Read
  - Task
model: sonnet  # or opus, haiku
---

Boas Praticas

• Comece com /brainstorm antes de saltar para a implementacao — revela casos extremos cedo
• Use /plan para tudo nao trivial — mesmo funcionalidades “simples” beneficiam de pensamento estruturado
• Execute /review-pr antes de fazer merge — a revisao multi-agente deteta problemas que revisoes de passagem unica nao encontram
• Documente com /compound — conhecimento institucional previne a repeticao de erros
• Use /deepen-plan para funcionalidades complexas — agentes de pesquisa adicionam profundidade a partir de documentacao e boas praticas
• Aproveite a resolucao paralela — /resolve_parallel trata TODOs mais rapido que correcoes sequenciais
• Crie habilidades personalizadas para padroes repetidos — encapsule conhecimento de dominio para reutilizacao
• Use modelo haiku para agentes rapidos — minimize custo e latencia para tarefas diretas

Resolucao de Problemas

Problema	Solucao
Agente nao encontrado	Verifique o caminho do plugin nas configuracoes do Claude Code e reinicie
Comando nao reconhecido	Execute /help para listar comandos disponiveis, verifique plugin.json
Agente retorna vazio	Verifique disponibilidade do modelo, pode precisar de chave API para opus/sonnet
Revisao multi-agente lenta	Use modelo haiku para agentes rapidos, sonnet para os criticos
Habilidade nao ativa	Verifique se a descricao da habilidade corresponde a formulacao do seu prompt
Hook nao dispara	Verifique se o tipo de evento do hook corresponde (PreToolUse vs PostToolUse)
Plano muito vago	Use /deepen-plan com agentes de pesquisa para mais detalhe
Revisao perde contexto	Forneca o URL do PR ou nome do branch explicitamente ao /review-pr