convez.ai
AgenteDevOps & InfraestruturaIntermediário
RandMelville

Claude War Room

RandMelville/claude-war-room

Mapeie e audite legados complexos com 6 agentes paralelos em 1 comando

Ver no GitHub
BomPluginScore · de 0 a 100

Orquestrador de 6 agentes IA especializados que mapeiam repositórios legados em minutos, gerando documentação viva com análise 360° de arquitetura, segurança, concorrência e riscos. Um comando executa engenharia reversa, auditorias paralelas e gera relatórios estruturados persistidos em .warroom/.

Instalação

$npx convez-ai RandMelville/claude-war-room

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
62
Forks
16
Acompanhando
1
Saúde
71%
Último commit
há 4 meses
Versão
v2.1.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Documentar repositories legados sem documentação
  • Auditar riscos de segurança, escalabilidade e concorrência
  • Onboarding de novos devs em codebases desconhecidos
  • Gerar roadmap técnico de dívida técnica

Veredito

Solução sólida e bem-arquitetada para desvendar legados complexos com paralelismo inteligente. Valor real para times herdando sistemas documentados. Integração nativa ao Claude Code reduz fricção, mas exige repositório bem-estruturado para máxima eficácia.

README

A tradução para o português deste README ainda está na fila.

Claude War Room

Contexto instantâneo e confiável de qualquer codebase legado — direto no Claude Code.

CI License: MIT Claude Code Agents PRs Welcome PT-BR

🇧🇷 Português | 🇺🇸 English

Herdou um repo sem doc, sem contexto, sem ninguém pra explicar? Aponte o War Room nele.


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

#AgenteO que fazO que produz
1ReconMapeia fluxos, regras de negócio e arquitetura a partir do códigoDoc de arquitetura com diagramas Mermaid
2Scalability ArchitectIdentifica gargalos de infra, limites de conexão, falta de cacheInventário de gargalos + simulação de carga
3Concurrency SpecialistCaça race conditions, deadlocks e inconsistênciasMapa de escritas + recomendações de locking
4Chaos Engineer / SRESimula falhas catastróficas e avalia resiliênciaCatálogo de desastres + plano de resiliência
5Security AuditorAudita OWASP Top 10, secrets, authz e privacidade (LGPD/GDPR)Vulnerabilidades + plano de remediação
6Quality & Stability LeadConsolida tudo em linguagem de negócioReport 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.

.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:

v1v2.0
git clone + install.sh/plugin install
ativar modo war room: X/warroom-audit X
Execução sequencial (estourava contexto)Fan-out paralelo
Saída só no chatPersistida em .warroom/ (commitável)
Acoplado a EdTechCore agnóstico + domain packs

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

Star History Chart


Construído por @RandMelville · MIT

Ver o original no GitHub

Bom para

Relacionados