A Fábrica de Agentes

team-os-creator

A fábrica de agentes. É exclusiva do CT — nunca é copiada para um projeto de destino. Ela fica só no Centro de Treinamento.

Command Center

O painel que aparece quando você chama a creator sem nenhum argumento. É o raio-x da operação: quais projetos têm time instalado e onde existe drift.

Drift

Quando algo num projeto ficou desatualizado em relação ao CT. A fonte da verdade é sempre o CT; o drift mostra onde a realidade se afastou dela.

As três funções

Criar (gera agentes e squads novos no padrão), atualizar (propaga uma correção do CT para todos os projetos onde o agente já foi instalado) e instalar (leva uma squad inteira para um projeto novo).

Passo 1 — Abrir o Claude Code dentro do CT

Entre na pasta do Centro de Treinamento e abra o Claude Code puro. A fábrica só existe dentro do CT — é aqui que você administra, não onde produz. Abrir o `claude` puro (sem `/team-os`) é a postura de administrador: você está mexendo na fábrica, não gerando entregável de cliente. O Claude Code abre no contexto da pasta do CT; digite a barra `/` e confirme que `/team-os-creator` aparece no menu de comandos.

cd team-os
claude

Passo 2 — Abrir o Command Center

Chame a creator sem nenhum argumento. Sem argumento, a creator não instala nada — ela escaneia silenciosamente as pastas irmãs ao CT e mostra o estado de tudo. É como bater o olho no painel de um carro antes de dirigir: você vê quais projetos têm time, quais têm agentes e onde há drift, tudo numa tela. Você verá um painel de status listando os projetos ao lado do CT, o que cada um tem instalado e onde existe defasagem em relação ao CT.

/team-os-creator

Passo 3 — Instalar uma squad num projeto

Dispare a instalação com o argumento `*install`. Essa é a função que você mais vai usar — ela leva uma squad inteira, padronizada, para um projeto sem você copiar arquivo na mão. A creator conduz o processo por perguntas e nunca age sem sua confirmação. Ela pergunta qual é o projeto de destino, quais squads levar (Dev, Sites, Social, Traffic, PM ou combinação), mostra um preview do que vai acontecer e espera sua confirmação. Depois copia os agentes das squads escolhidas, leva a skill `/team-os` para o projeto e deposita o `settings.json`. A própria `team-os-creator` não é copiada e a memória compartilhada também não vem — ela ainda não existe no projeto.

/team-os-creator *install

Passo 4 — Entender por que o agente já nasce pronto

Abra um dos arquivos de agente que foram para o projeto e observe que ele já traz as instruções de como ler a memória e onde registrar o trabalho. Esse é o valor central da fábrica: um agente gerado pela creator não é um arquivo solto — ele nasce dentro do padrão, conhecendo as regras do time. Isso garante que ele funcione desde o primeiro dia, sem você ter que explicar o sistema para cada novo especialista. Você verá os arquivos dos agentes da squad que você instalou.

ls .claude/agents

Passo 5 — Fixar as regras invisíveis

Estas regras não geram erro quando quebradas — o sistema continua rodando, mas o time trava sem você entender por quê. Grave as três: (1) O lead orquestra, nunca executa — com o time ligado, a sessão principal não escreve código nem redige nada, ela despacha um agente para cada ação; se o lead começa a executar, ele para de coordenar e o time engasga. (2) Fronteiras de autoridade — cada papel tem o seu limite: só o devops faz `git push`, só o arquiteto cria e valida story, só o QA emite veredicto formal; isso impede que um agente pise no trabalho do outro. (3) Sempre via creator — nunca crie agente solto nem copie arquivo de agente na mão de um projeto para outro; o fluxo é sempre uma direção: nasce no CT, vai para os projetos.