fassi.dev
Voltar aos projetos
2026Open source · v0.1.0

Squad Code MCP

Execute sessões do Claude Code como um esquadrão de mãe, líder, trabalhadores e juiz sobre um broker MCP compartilhado, com uma TUI de terminal para observá-los trabalhar e responder suas perguntas.

Problema

Executar várias sessões do Claude Code em uma funcionalidade significava ser o roteador eu mesmo. Eu copiava contexto entre terminais, respondia a mesma pergunta duas vezes e perdia o rastreamento de quem estava fazendo o quê. Nada mantinha as sessões em seus papéis, e nada registrava o que tinha acontecido.

Solução

Um broker MCP, bifurcado de claude-peers, que cada sessão se junta com um nome e um papel. As mensagens fluem em uma estrela: a mãe fala comigo, o líder divide a especificação em tickets, cada trabalhador pega um ticket em sua própria worktree git, e o juiz aprova a entrega ou a envia de volta para refatoração. O broker é o único escritor de estado, e mantém um log de eventos append-only. Perguntas sobem a cadeia, e cada nível tenta responder antes de escalar. Uma TUI separada lê o log, e através dela eu respondo perguntas e aprovo gates.

Resultado

Uma funcionalidade de dois tickets foi do pontapé inicial até aprovação de entrega usando apenas o terminal da mãe e a TUI, verificado com sessões reais. Cada papel recebe suas habilidades de um arquivo JSON, e squad start <role> inicia uma sessão com seu nome, sua worktree e suas permissões. Perguntas e ações irreversíveis agora me esperam em um único lugar em vez de estarem espalhadas por quatro terminais.

Como funciona

  1. 01Executar 'squad start' inicia cada sessão com um papel, sua própria worktree e suas habilidades base
  2. 02A mãe abre uma funcionalidade e o líder a divide em tickets
  3. 03Trabalhadores implementam um ticket cada um e enviam o resultado ao juiz
  4. 04Perguntas sobem trabalhador → líder → mãe → eu, e cada nível responde o que pode
  5. 05A mãe para em um gate antes da entrega final, e eu a aprovo na TUI

Construído com

MCPClaude CodeBunTypeScriptSQLiteGit worktreesTUI