Orquestrador de 6 agentes especializados para análise 360° de features com Claude Code.
🇧🇷 Português | 🇺🇸 English
1 comando. 6 perspectivas. 1 relatório executivo.
O Modo War Room é uma estratégia de orquestração que executa sequencialmente 6 agentes de IA especializados, cada um analisando uma dimensão diferente do seu código. O resultado é um relatório executivo completo com falhas detectadas, severidades e plano de ação.
| Zero Dependências Apenas arquivos Markdown |
Instalação em 30s Um script, pronto |
Personalizável Adapte para qualquer domínio |
Open Source MIT License |
$ claude
> ativar modo war room: Sistema de Lançamento de Notas
[1/6] DOC-REVERSE — Mapeando arquitetura e fluxos...
[2/6] ARQUITETO-INFRA — Identificando gargalos de escala...
[3/6] DEV-CONCURRENCY — Caçando race conditions...
[4/6] SRE-CHAOS — Simulando cenários de falha...
[5/6] SEC-AUDIT — Auditando vulnerabilidades de segurança...
[6/6] LEAD-REPORT — Consolidando relatório executivo...
Report de Confiança: Índice 🔴 Baixo
3 itens críticos identificados | Plano de ação gerado
graph LR
CMD["ativar modo war room: [FEATURE]"] --> A1
A1["1. DOC-REVERSE\nEngenharia Reversa"]
A2["2. ARQUITETO-INFRA\nEscalabilidade"]
A3["3. DEV-CONCURRENCY\nConcorrência"]
A4["4. SRE-CHAOS\nChaos Engineering"]
A5["5. SEC-AUDIT\nSegurança"]
A6["6. LEAD-REPORT\nRelatório Executivo"]
A1 -->|contexto + descobertas| A2
A2 -->|contexto + descobertas| A3
A3 -->|contexto + descobertas| A4
A4 -->|contexto + descobertas| A5
A5 -->|contexto + descobertas| A6
A6 -->|resultado| R["Report de Confiança\nTabela de Severidade\nPlano de Ação"]
style CMD fill:#1a1a2e,stroke:#e94560,color:#fff
style A1 fill:#16213e,stroke:#0f3460,color:#fff
style A2 fill:#16213e,stroke:#0f3460,color:#fff
style A3 fill:#16213e,stroke:#0f3460,color:#fff
style A4 fill:#16213e,stroke:#0f3460,color:#fff
style A5 fill:#e94560,stroke:#c70039,color:#fff
style A6 fill:#e94560,stroke:#0f3460,color:#fff
style R fill:#0f3460,stroke:#e94560,color:#fff
Cada agente recebe o contexto e as descobertas dos anteriores, construindo uma análise progressivamente mais profunda. O último agente consolida tudo em linguagem de negócio.
| # | Alias | Agente | O que faz | O que produz |
|---|---|---|---|---|
| 1 | DOC-REVERSE |
Reverse Engineering & Software Architect | Mapeia fluxos, regras de negócio e arquitetura a partir do código | Documento de Arquitetura com diagramas Mermaid |
| 2 | ARQUITETO-INFRA |
Cloud Scalability Architect | Identifica gargalos de infra, limites de conexão, falta de cache | Inventário de gargalos + simulação de carga |
| 3 | DEV-CONCURRENCY |
Concurrency & Distributed Systems Specialist | Caça race conditions, deadlocks e inconsistências de dados | Mapa de pontos de escrita + recomendações de locking |
| 4 | SRE-CHAOS |
Chaos Engineer SRE | Simula falhas catastróficas e avalia resiliência | Catálogo de cenários de desastre + plano de resiliência |
| 5 | SEC-AUDIT |
Security Auditor | Audita OWASP Top 10, secrets, auth bypass e conformidade LGPD | Catálogo de vulnerabilidades + plano de remediação |
| 6 | LEAD-REPORT |
Quality & Stability Lead | Consolida tudo em linguagem de negócio | Report de Confiança com plano de ação priorizado |
- Claude Code CLI instalado e configurado
- Modelo Claude Opus recomendado (os agentes usam
model: opuspor padrão) - Um repositório de código para analisar
git clone https://github.com/RandMelville/claude-war-room.git
cd claude-war-room
chmod +x install.sh
./install.shO script vai:
- Copiar os 6 agentes para
~/.claude/agents/ - Configurar o trigger de orquestração na memória do projeto
- Copie os agentes para o diretório de agentes do Claude Code:
cp agents/*.md ~/.claude/agents/- Configure o trigger de orquestração. Copie o arquivo de memória para o diretório de memória do seu projeto:
# Substitua <CAMINHO-DO-PROJETO> pelo caminho absoluto do seu projeto
# Ex: -Users-fulano-Documents-meu-projeto
PROJECT_DIR=~/.claude/projects/<CAMINHO-DO-PROJETO>/memory
mkdir -p "$PROJECT_DIR"
cp memory/feedback_war_room_mode.md "$PROJECT_DIR/"- Atualize o MEMORY.md do seu projeto (crie se não existir):
- [feedback_war_room_mode.md](./feedback_war_room_mode.md) - Comando "ativar modo war room: [FEATURE]" orquestra 6 agentes sequenciais- Abra o Claude Code no diretório do projeto que deseja analisar
- Digite o comando:
ativar modo war room: [NOME DA FEATURE]
Exemplos:
ativar modo war room: Sistema de Lançamento de Notas
ativar modo war room: Importação de CSV de Alunos
ativar modo war room: Autenticação e Autorização
ativar modo war room: API de Relatórios
- Aguarde a execução sequencial dos 6 agentes
- O relatório final será apresentado automaticamente pelo último agente
- Os 6 documentos Markdown serão gerados automaticamente na pasta
war-room/[feature]/do seu projeto
- DOC-REVERSE — Documento de arquitetura com stack, fluxos step-by-step, diagramas Mermaid, regras de negócio extraídas
- ARQUITETO-INFRA — Mapa de gargalos com pontos de ruptura, simulação de carga com 1.000 acessos simultâneos
- DEV-CONCURRENCY — Cenários de race condition com sequências temporais (T1, T2), análise de transações e locking
- SRE-CHAOS — Catálogo de desastres com sequência de falha (T+0, T+30s, T+5min), análise de timeouts e circuit breakers
- SEC-AUDIT — Catálogo de vulnerabilidades OWASP, auditoria de secrets/auth, vetores de ataque e conformidade LGPD
- LEAD-REPORT — Report de Confiança consolidado
Ao final da execução, 6 arquivos Markdown são criados automaticamente na pasta war-room/[feature]/ do seu projeto:
war-room/
└── sistema-de-notas/
├── 01-doc-reverse-arquitetura.md
├── 02-arquiteto-infra-escalabilidade.md
├── 03-dev-concurrency-race-conditions.md
├── 04-sre-chaos-cenarios-desastre.md
├── 05-sec-audit-seguranca.md
└── 06-lead-report-relatorio-executivo.md
Os documentos podem ser compartilhados diretamente via GitHub, Confluence, Notion ou qualquer viewer Markdown — os diagramas Mermaid renderizam corretamente.
Ou gere um report HTML interativo com o script incluído:
./generate-report.sh war-room/sistema-de-notas/
open war-room/sistema-de-notas/report.htmlO relatório final sempre inclui esta tabela:
| Componente | Falha Detectada | Severidade (1-10) | Ação de Curto Prazo |
|---|---|---|---|
| Serviço de Notas | Race condition em UPDATE | 9 | Adicionar optimistic locking |
| Import CSV | Estouro de memória com arquivos >5k linhas | 8 | Implementar streaming |
| API Gateway | Sem timeout para serviço de Auth | 7 | Configurar timeout de 3s |
claude-war-room/
├── README.md # Este arquivo
├── LICENSE # MIT
├── install.sh # Script de instalação
├── generate-report.sh # Gerador de report HTML interativo
├── agents/
│ ├── 01-reverse-engineering-architect.md
│ ├── 02-scalability-architect.md
│ ├── 03-concurrency-specialist.md
│ ├── 04-chaos-engineer-sre.md
│ ├── 05-security-auditor.md
│ └── 06-quality-stability-lead.md
├── memory/
│ └── feedback_war_room_mode.md
└── docs/
├── ARCHITECTURE.md # Deep dive de cada agente
├── CUSTOMIZATION.md # Como adaptar para seu domínio
└── EXAMPLES.md # Exemplos de saída
Os agentes vêm configurados para o domínio EdTech (sistemas educacionais), mas podem ser adaptados para qualquer contexto. Veja o guia completo em docs/CUSTOMIZATION.md.
Resumo rápido:
- Substitua termos de domínio (escolas, professores, notas) pelos do seu contexto
- Ajuste métricas de escala (1.000 escolas → seu volume)
- Troque
model: opuspormodel: sonnetpara reduzir custo (menor profundidade) - Adicione ou remova agentes do pipeline editando
feedback_war_room_mode.md
Após a execução do War Room, gere um report HTML com navegação, diagramas Mermaid renderizados e cores de severidade:
# Gera report.html dentro da pasta do war-room
./generate-report.sh war-room/sistema-de-notas/
# Ou especifique o caminho de saída
./generate-report.sh war-room/sistema-de-notas/ ~/Desktop/report.htmlO HTML gerado tem CSS inline e inclui:
- Sidebar de navegação entre agentes
- Diagramas Mermaid renderizados no browser
- Tabelas com cores de severidade (vermelho/amarelo/verde)
- Toggle dark/light theme
- Responsivo e pronto para impressão
Por que 6 perspectivas diferentes: Cada agente tem um "viés" proposital — o arquiteto pensa em fluxos, o SRE pensa em falhas, o especialista em concorrência pensa em race conditions, o auditor de segurança pensa como um atacante. Juntos, cobrem pontos cegos que um único prompt não conseguiria.
Por que sequencial e não paralelo: Cada agente constrói sobre as descobertas do anterior. O SRE de Chaos, por exemplo, usa o mapa de infraestrutura do Arquiteto de Escalabilidade para saber quais pontos de falha testar. O Auditor de Segurança usa o mapa de superfície para saber onde atacar. O Lead de Qualidade usa TODAS as descobertas anteriores para priorizar.
Contribuições são bem-vindas! Leia o Guia de Contribuição para começar.
Algumas ideias:
- Traduzir agentes para inglês
- Criar agentes adicionais (ex: Performance Profiler, Accessibility Auditor)
- Melhorar os templates de saída
- Adicionar exemplos reais (anonimizados)
- Adaptar para novos domínios (FinTech, HealthTech, SaaS)
