claude-war-room

---

Você lidera times com repositórios legados que ninguém documentou. O War Room entra nesse território desconhecido e devolve um mapa confiável: o que o sistema faz, como funciona, quais as regras de negócio e onde estão as minas terrestres — em minutos, persistido como documentação viva que o time inteiro herda.

Recon primeiro Doc viva do codebase em 1 comando

War Room sob demanda 6 agentes caçando riscos em paralelo

Persistente Tudo salvo em .warroom/

Domínio-agnóstico Packs opcionais (EdTech…)

---

Instalação

A partir da v2.0, o War Room é um plugin do Claude Code. No Claude Code:

/plugin marketplace add RandMelville/claude-war-room
/plugin install claude-war-room

Pré-requisitos: Claude Code CLI instalado. Sem git clone, sem editar caminhos internos, sem script.

Vindo da v1? Veja Migração do v1.

---

Os dois comandos

/warroom — Recon (o herói)

/warroom                # mapeia o repositório inteiro
/warroom src/billing    # foca num módulo/feature

Roda o agente Recon (engenharia reversa) e persiste a doc viva em .warroom/: stack, fluxos com diagramas Mermaid, integrações, regras de negócio e dívida técnica. É o que você roda no dia 1 de um repo legado.

/warroom-audit — War Room completo

/warroom-audit                  # auditoria 360° de riscos
/warroom-audit Autenticação     # foca numa feature

Reusa o mapa do Recon e dispara 6 agentes (4 especialistas em paralelo + consolidação) para produzir um Report de Confiança com severidades e plano de ação, mais findings.json estruturado.

---

Como funciona

graph TD
    CMD["/warroom-audit [escopo]"] --> R

    R["RECON\nEngenharia Reversa\n(mapa do território)"]

    R --> A2["ARQUITETO-INFRA\nEscalabilidade"]
    R --> A3["DEV-CONCURRENCY\nConcorrência"]
    R --> A4["SRE-CHAOS\nChaos Engineering"]
    R --> A5["SEC-AUDIT\nSegurança"]

    A2 --> L["LEAD-REPORT\nConsolidação + findings.json"]
    A3 --> L
    A4 --> L
    A5 --> L

    L --> OUT[".warroom/\narchitecture.md · audit/ · findings.json"]

    style CMD fill:#1a1a2e,stroke:#e94560,color:#fff
    style R fill:#0f3460,stroke:#e94560,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 L fill:#e94560,stroke:#0f3460,color:#fff
    style OUT fill:#0f3460,stroke:#e94560,color:#fff

Map → fan-out paralelo → reduce. O Recon cria o mapa; os 4 especialistas o analisam em paralelo (cada um com um viés proposital); o Lead consolida tudo em linguagem de negócio. Rodar em paralelo corta tempo e evita estourar a janela de contexto — o gargalo do modo sequencial do v1.

---

Os 6 Agentes

#	Agente	O que faz	O que produz
1	Recon	Mapeia fluxos, regras de negócio e arquitetura a partir do código	Doc de arquitetura com diagramas Mermaid
2	Scalability Architect	Identifica gargalos de infra, limites de conexão, falta de cache	Inventário de gargalos + simulação de carga
3	Concurrency Specialist	Caça race conditions, deadlocks e inconsistências	Mapa de escritas + recomendações de locking
4	Chaos Engineer / SRE	Simula falhas catastróficas e avalia resiliência	Catálogo de desastres + plano de resiliência
5	Security Auditor	Audita OWASP Top 10, secrets, authz e privacidade (LGPD/GDPR)	Vulnerabilidades + plano de remediação
6	Quality & Stability Lead	Consolida tudo em linguagem de negócio	Report de Confiança + findings.json

---

O que é gerado (.warroom/)

Os artefatos são criados no repositório que você analisa e foram desenhados para serem commitados — o time inteiro herda o contexto.