CoRaSy Squad

Um time de desenvolvimento dentro da pasta do seu projeto. Você não vai contratar quatro pessoas — vai conversar com elas.

versão 0.4.0

O que é

Quatro agentes com papéis de verdade, que moram na pasta do seu projeto e rodam no programa que você já usa — Claude Code, Cursor, Warp, Zed, Codex, Gemini CLI, Copilot, Antigravity. Com a sua assinatura ou a sua chave de API.

| | Quem | O que faz | |---|---|---| | 🎯 | Ares | decide o quê construir, e organiza em projeto e tarefas | | 🏛️ | Lucy | decide como, e detalha cada tarefa até dar para executar | | 🔨 | Vulcan | escreve o código | | 🔍 | Vera | aprova ou reprova — e ninguém carimba o próprio trabalho |

A diferença entre pedir código para uma IA e usar o Squad é a mesma que existe entre um freelancer e uma empresa:

| Você sozinho com uma IA | Você com o Squad | |---|---| | Pede, recebe, testa você mesmo | Um especifica, outro escreve, uma terceira reprova | | Descobre o erro em produção | O erro é reprovado antes de chegar em você | | Repete a mesma explicação toda semana | O time anota, e não esquece a sua decisão |

🔴 Ele se adapta ao SEU sistema. A primeira coisa que a Lucy faz é estudar o seu produto inteiro — rodando os comandos, não lendo o README — e se especializar nele.

Instalar

cd /caminho/do/seu/projeto
npx corasy-squad init

Ele detecta os programas que você tem e escreve a configuração de cada um. O que você não tiver, ele pula.

Precisa de Node 18 ou mais novo. Nada é instalado "no computador" — tudo vive na pasta do seu projeto, versionado no seu Git, e você edita com um editor de texto quando quiser.

Falar com o time

npx corasy-squad lucy

Você conversa com a Lucy. Direto. Ela responde, ela lê e escreve os seus arquivos, e quando precisa do Vulcan, é ela quem chama.

🔴 Por que isto importa mais do que parece. Em quase todos os outros programas, "subagente" quer dizer delegação: você fala com o agente principal, ele abre a Lucy, lê a resposta dela e te repassa. Você nunca falou com ela — falou com alguém que falou com ela. Aqui você fala.

Dentro da conversa:

| | | |---|---| | /time | quem existe, e quem pode ser acionado | | /config | qual modelo cada um usa | | /custo | o gasto, com a assinatura separada da API | | /doutor | o que está quebrado agora | | /trocar vulcan | passa a falar com outro, direto |

Ctrl+C sai. npx corasy-squad lucy --retomar continua de onde parou — e se o turno foi cortado no meio de uma ferramenta, o agente é avisado de que não se sabe se ela completou, em vez de repetir às cegas.

Qual modelo cada agente usa

Em .squad/projeto.yml. O que o agente não declara, ele herda do padrão.

motor:
  provedor: "api"
  base_url: "https://openrouter.ai/api/v1"
  api_key_env: "OPENROUTER_API_KEY"
  modelo: "anthropic/claude-sonnet-4.5"

  max_passos: 20            # idas e vindas com ferramenta, por turno
  max_usd_sessao: 5         # o que pode sair da sua chave, por sessão

  agentes:
    lucy:
      provedor: "claude-cli"      # a assinatura que você já paga
      modelo: "opus"
    vulcan:
      provedor: "api"             # escreve muito: modelo barato
      base_url: "https://api.deepseek.com/v1"
      api_key_env: "DEEPSEEK_API_KEY"
      modelo: "deepseek-chat"

É aqui que mora a economia: raciocínio caro onde ele importa, volume onde ele é barato. Num time que trabalha o dia inteiro, quem escreve faz a maior parte das chamadas.

Não sabe o que tem na sua máquina? npx corasy-squad doutor diz — e diz também o que está inteiro, não só o que falta.

Prefere clicar? CoRaSy → Configurações → Time mostra tudo isso numa tela. 🔴 Mas o arquivo é a verdade: o site é espelho e editor, e nada muda na sua máquina até você rodar npx corasy-squad config puxar, que pergunta item a item antes de escrever.

E os outros programas?

Continuam funcionando — o AGENTS.md, o .cursor/ e o .claude/ continuam sendo escritos, e abrir o Cursor nesta pasta traz o time.

Mas lá vale o que aquele programa oferece, e a gente não promete nada além disso. O motor acima é o único lugar onde tudo funciona igual em qualquer máquina.

Conectar ao CoRaSy

O time conversa, mas para escrever — criar tarefa, mudar status, registrar o que fez — ele precisa de uma conta no CoRaSy.

1. No CoRaSy: Configurações → Conectar sua IA
2. Clique em Criar o time do Squad — os quatro nascem de uma vez
3. Copiar tudo e colar em ~/.corasy-squad.env (o instalador já criou esse arquivo para você, fora da pasta do projeto)
4. Na pasta do seu projeto:

npx corasy-squad sincronizar

Ele liga cada alma ao agente correspondente. Cada agente tem credencial própria — e assina o que faz no CoRaSy.

🔴 Nunca cole isso dentro de arquivo que vai para o Git — nem no .mcp.json, nem no .env do projeto. É o jeito mais comum de uma chave acabar publicada sem ninguém perceber.

O primeiro comando

Abra o seu programa na pasta do projeto e diga:

Lucy, leia o README e faça o setup.

O setup acontece uma vez. São nove passos, e ela não pula nenhum. No fim, o time deixou de ser genérico: sabe o nome do seu produto, os comandos que funcionam, as armadilhas que existem — e a Lucy propôs quais gerentes o seu projeto precisa além dos quatro. Se você aprovar, ela escreve as almas deles.

Depois disso, o dia a dia é só conversar:

Ares, quero um app de pomodoro para crianças medirem tempo de estudo.

O que fica na sua pasta

.squad/
├── agentes/       🔵 as 4 almas          — do produto, atualizáveis
├── meus-agentes/  🟢 os que a Lucy criou — SEUS, nunca tocados
├── regras/        🟢 tudo sobre você e o seu sistema — SEUS
├── metodo/        🔵 como o setup funciona
├── skills/        🔵 os rituais do time
└── mcp/           🔵 as ferramentas do CoRaSy

🔵 = do produto, substituído quando você atualiza 🟢 = seu, nunca substituído

Essa separação está declarada em .squad-manifesto, e é ela que permite atualizar o time sem apagar meses do seu contexto.

npx corasy-squad atualizar

Comandos

| | | |---|---| | npx corasy-squad lucy | fala com a Lucy, direto (troque pelo nome de qualquer um) | | npx corasy-squad lucy --retomar | continua a conversa de onde parou | | npx corasy-squad init | instala nesta pasta | | npx corasy-squad atualizar | traz o que mudou, sem tocar no que é seu | | npx corasy-squad sincronizar | liga as almas aos agentes do CoRaSy | | npx corasy-squad exportar | regera os arquivos de cada programa a partir de .squad/ | | npx corasy-squad doutor | o que está quebrado, e o que está inteiro | | npx corasy-squad config | qual modelo cada agente usa | | npx corasy-squad config puxar <arquivo> | traz o que você mudou no site, perguntando item a item | | npx corasy-squad custo | o gasto registrado, mesmo com o terminal já fechado | | npx corasy-squad provar | conferir que as travas sabem reprovar | | npx corasy-squad retrato | o retrato do seu time, numa página |

Editou uma alma? Rode exportar e todos os programas se atualizam.

O que ele NÃO faz

• Não publica, não envia, não cobra, não apaga nada sem você mandar na conversa
• Não guarda sua chave em lugar nenhum além do arquivo que você criou
• Não vê dados de outro cliente — o isolamento é decidido pelo servidor do CoRaSy, não por o agente se comportar
• Não roda para sempre. Teto de passos, de tokens e de dinheiro por sessão. Quando estoura, ele para e diz por quê — e não inventa uma conclusão para parecer que terminou
• Não se reconfigura sozinho. Peça "põe o Vulcan no DeepSeek" e ele propõe; nada muda sem você digitar "sim"
• Não finge que sabe. Se a execução foi cortada no meio de uma ferramenta, ele diz que não sabe se ela completou, e verifica antes de repetir

⚠️ Uma coisa honesta sobre as travas: em alguns programas (Claude Code) o Squad instala ganchos que impedem de verdade uma ação errada. Nos outros, a trava vive escrita na alma — e depende do modelo obedecer. O AGENTS.md gerado diz qual dos dois você tem, na sua pasta.

Suporte

Abra um chamado no portal de feedback do CoRaSy. Todo mundo é atendido — cliente ou não.

Software proprietário. Ver LICENÇA.