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.

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

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.

.warroom/
├── architecture.md   # doc viva (Recon)
├── manifest.json     # arquivos analisados + hashes + commit (base de drift)
├── findings.json     # achados estruturados (severidade, evidência, status)
└── audit/            # saídas dos especialistas + Report de Confiança (só com /warroom-audit)

Veja um exemplo real em examples/. Os Markdown renderizam direto no GitHub,
Confluence, Notion ou qualquer viewer (diagramas Mermaid inclusos).

Domínios

Os agentes são neutros ao domínio por padrão. Para reintroduzir um vocabulário específico
(termos, métricas de escala, regulação), use um domain pack — veja
packs/edtech como exemplo e template para FinTech, HealthTech, etc.

Migração do v1

O v1 instalava agentes manualmente em ~/.claude/agents/ e ativava tudo com a frase
ativar modo war room: [feature] via um arquivo de memória. Isso foi substituído:

Pode remover o trigger de memória antigo e os agentes copiados à mão — o plugin cuida de tudo.

Roadmap

• v2.1 — Confiança: verificação adversarial dos achados (mata falso-positivo), rubrica de
  severidade calibrada, eval harness na CI.
• v2.2 — Escala: /warroom-refresh (detecção de drift via manifest.json), análise multi-repo
  e visão de portfólio.

Contribuição

Contribuições são bem-vindas! Leia o Guia de Contribuição. Algumas ideias:
novos agentes (Performance Profiler, Accessibility Auditor), novos domain packs, exemplos reais
anonimizados, melhorias nos templates de saída.

Star History