jaydenluckertjes-ai/Carmack-Council

O que Carmack-Council faz?

Construa aplicações multiagente com Claude Code usando um framework simples e testado em batalha, inspirado nos princípios de engenharia de John Carmack.

Visão Geral

O framework Carmack-Council permite que você defina e coordene múltiplos agentes Claude Code para trabalhar em conjunto em tarefas complexas. Cada agente tem um papel específico, um conjunto de ferramentas e uma forma de se comunicar com outros agentes.

Princípios

• Simplicidade: Mantenha a estrutura do projeto enxuta e fácil de entender.
• Modularidade: Cada agente é independente e pode ser desenvolvido separadamente.
• Foco em Resultados: Os agentes são orientados a entregar valor, evitando complexidade desnecessária.

Estrutura do Projeto

carmack-council/
├── agents/
│   ├── architect/
│   │   ├── config.json
│   │   └── tools/
│   ├── coder/
│   │   ├── config.json
│   │   └── tools/
│   └── reviewer/
│       ├── config.json
│       └── tools/
├── council/
│   └── rules.yaml
└── .env

Como Usar

1. Clone o repositório: git clone https://github.com/jaydenluckertjes-ai/Carmack-Council
2. Instale as dependências: npm install ou pip install -r requirements.txt
3. Configure os agentes: Edite os arquivos config.json em cada diretório de agente.
4. Defina as regras do conselho: Edite council/rules.yaml para definir como os agentes interagem.
5. Execute: Use o comando claude code --multi-agent para iniciar a sessão.

Configuração de Agente

Cada agente possui um arquivo config.json com as seguintes propriedades:

{
  "name": "Arquiteto",
  "role": "Define a arquitetura do sistema e toma decisões de alto nível",
  "tools": ["read", "write", "bash"],
  "model": "claude-sonnet-4-20250514"
}

Comunicação entre Agentes

Os agentes se comunicam através de mensagens no formato agent-to-agent usando canais nomeados definidos no council/rules.yaml.

Exemplos

• Geração de Código: O arquiteto define a estrutura, o coder implementa e o revisor valida.
• Revisão de PR: Um agente analisa o código, outro sugere melhorias e um terceiro aprova.

Contribuição

Contribuições são bem-vindas! Siga as diretrizes de contribuição no repositório.

Licença

MIT