mad — MultiAgent Decanting

Plugin mad (MultiAgent Decanting). Orquestração multi-agente para Claude Code em modo decanting nativo. O Arquiteto coordena especialistas via Agent tool — sem claude -p, sem processos em background, sem tmux. Cada feature é uma sessão viva que externaliza o aprendizado obrigatoriamente ao terminar. Windows nativo, macOS e Linux.

A ideia em 30 segundos

Um único Claude Code interativo é o Arquiteto: ele conversa com você, escreve specs e delega trabalho a especialistas (pipeline-dev, qa-tester, …) invocados pelo Agent tool nativo do Claude Code.

Cada especialista vive uma sessão completa enquanto trabalha numa feature e, antes de devolver controle, decanta: grava o que decidiu, o que aprendeu e onde parou em arquivos versionados (memory/<agente>/). A próxima invocação começa fresca lendo o decantado. Memória mora em arquivo, não na sessão.

Resultado: sem context rot acumulado, sem conhecimento tácito perdido, custo de tokens limitado por feature, e tudo auditável.

Por que não o plugin antigo (multiagentes-giordano v0.2.0)

	v0.2.0	multiagents-decanting v1.0
Sessão viva	claude -p --resume (processo OS)	Agent tool nativo + SendMessage opcional
Dashboard	tmux/Tilix (Linux-only)	HTML + WebSocket + PWA (Win/Mac/Linux)
Memória	MEMORY.md único	arquivos especializados + trust.json
Observabilidade	logs livres	OpenTelemetry GenAI nativo
Custo	sem teto	budget enforcement + circuit breaker
Confiança	—	trust ladder por agente

Os dois coexistem (prefixos /multiagente- vs /mad-). Veja _spec/10_MIGRACAO_E_COEXISTENCIA.md.

Instalação

mad é distribuído pelo hub de ferramentas do Giordano (giordanorec/ai-coding-tools) — adicione o catálogo uma vez e instale o que quiser:

/plugin marketplace add giordanorec/ai-coding-tools
/plugin install mad

Ou pela CLI:

claude plugin marketplace add giordanorec/ai-coding-tools
claude plugin install mad

O mesmo catálogo traz outros plugins do Giordano (instale sob demanda): claude-brainstorm-multiagent (ideação multi-agente), multiagentes-giordano (fluxo multi-agente legado em tmux). Reinicie/abra uma sessão nova para carregar. Depois: /mad-init.

Requisitos

Plug-and-play — os dois comandos acima e funciona. Não precisa instalar mais nada:

• Claude Code logado (o mad roda dentro da sua assinatura via Agent tool nativo — sem claude -p, sem API paga).
• Python 3.9+ — os scripts usam só a biblioteca padrão (stdlib). Zero pip install. (Já vem no Linux/macOS.)
• git — normalmente já presente.

Sem Docker, sem dependências extras. Único opcional: o auto-refresh ao vivo do dashboard usa a lib websockets — a página abre e funciona sem ela; para o tempo-real, rode mad bootstrap (instala websockets no ambiente) uma vez.

Atualizar

Numa máquina que já tem uma versão antiga instalada, atualize o catálogo e o plugin:

claude plugin marketplace update giordanorec
claude plugin update mad@giordanorec

Reabra a sessão para carregar. O estado do projeto (memória, docs, specs, reports) é preservado — a atualização só troca os arquivos do plugin. Alternativa de dentro do Claude Code: /mad-upgrade (checa a última release no GitHub, mostra o CHANGELOG e aplica preservando a memória).

Aviso automático de versão nova

Sim — a partir da v1.24, ao abrir uma sessão num projeto mad, o plugin checa (no máximo 1×/dia, em silêncio, sem travar) se há release mais nova no GitHub e, se houver, avisa sugerindo /mad-upgrade. Sem telemetria: é só uma consulta à API pública de releases do repositório.

Início rápido

cd meu-projeto
claude
> /mad-init        # Discovery + estrutura + agentes + dashboard
> /mad-dashboard   # abre o painel local
> Descreva sua primeira feature — o Arquiteto coordena.

Comandos

Comando	O que faz
/mad-init	Discovery e scaffold do projeto
/mad-enable <agente>	Habilita um especialista adicional
/mad-inspect <agente>	Estado completo de um agente
/mad-dashboard	Abre/encerra o dashboard local
/mad-decant <agente>	Força decanting retroativo
/mad-doctor	Diagnóstico verde/amarelo/vermelho
/mad-trust <agente>	Trust score e histórico
/mad-upgrade	Atualiza o plugin (preserva memória)
/mad-explain <conceito>	Explica um conceito em PT-BR acessível
/mad-tutorial	Walkthrough guiado de 5-7 min

Conceitos

• decanting — protocolo obrigatório de extração de aprendizado ao fim de cada feature.
• blast radius — fricção proporcional ao risco: reversível-baixo é autônomo, irreversível-alto sempre pede confirmação humana.
• trust ladder — autonomia que escala com competência demonstrada (trust.json por agente).
• guardrails — poucos e catastróficos (force-push, rm -rf, secret commit, identity change). Proteção contra acidente, não contra agente malicioso.

Rode /mad-explain <conceito> para qualquer um deles em linguagem acessível.

Filosofia

Em domínio onde a fronteira anda rápido, abstrações grossas e controles uniformes convertem velocidade alheia em dívida própria. Construa menos, nos lugares certos.

Thin wrapper sobre o Claude Code: usamos Agent tool, MCP, hooks e Skills como vêm. O plugin só abstrai convenção de pastas, protocolo de boot/decanting, dashboard, uma CLI fina e templates.

Aviso

Este plugin orquestra agentes que executam código, fazem chamadas pagas a APIs e modificam seu sistema de arquivos. Os guardrails já vêm ligados; monitore o dashboard e revise commits antes de push. MIT — os autores não respondem por uso indevido.

Licença

MIT © 2026 Giordano Ribeiro Eulalio Cabral.