Como montar seu Centro de Treinamento de Agentes
Uma fonte, uma verdade. Monte a sede central de onde você cria, atualiza e instala agentes em qualquer projeto.
O que é
Como montar seu Centro de Treinamento de Agentes
Você vai montar o Centro de Treinamento de Agentes (o CT) na sua máquina: uma pasta que fica ao lado dos seus projetos e funciona como a sede de onde você cria, atualiza e instala agentes de IA em qualquer trabalho. O CT já vem pronto do repositório github.com/joaoguirunas/team-os, com 49 agentes organizados em 5 squads, 49 skills e hooks de qualidade automáticos.
A maioria das pessoas que começa com agentes de IA acaba com uma bagunça: um agente numa pasta, outro em outra, cada um com regras diferentes, impossível de manter. O Centro de Treinamento resolve isso com um princípio simples — uma fonte só, uma verdade só. Você mantém tudo num lugar central e, quando muda alguma coisa lá, a mudança se espalha para todos os projetos. É exatamente essa estrutura que a equipe usa para manter padrão nos projetos dos clientes.
O CT opera em duas camadas: dentro dele você administra (cria e conserta agentes); dentro do projeto você produz (os agentes trabalham de verdade). Tudo flui numa direção só — nasce no CT e vai para os projetos, nunca o contrário. As três funções principais são criar agentes no padrão do time, atualizar com propagação automática e instalar squads inteiras em projetos novos em minutos.
Para completar o tutorial você precisa ter Node.js, Git e Claude Code instalados. Não é necessário saber programar — você vai digitar comandos prontos e o Claude faz o trabalho.
Como funciona
Principais recursos
Fonte única de agentes
Todos os agentes vivem no CT. Qualquer correção feita aqui se propaga automaticamente para todos os projetos onde a squad está instalada.
49 agentes em 5 squads
Dev, Sites, Social, Tráfego e PM prontos para uso. Cada agente tem papel definido, lê a memória compartilhada e registra entregas no lugar certo.
Command Center integrado
O painel /team-os-creator escaneia todos os projetos ao redor do CT e mostra quais squads estão instaladas, em dia ou com drift — tudo numa tela só.
Instalação guiada por perguntas
O comando /team-os-creator *install conduz a instalação com preview e confirmação antes de copiar qualquer arquivo para o projeto destino.
Hooks de qualidade automáticos
Travas que impedem agentes de publicar ou executar ações fora do padrão — proteção que acompanha cada squad instalada.
Memória compartilhada (Obsidian)
A pasta docs/smart-memory funciona como o cérebro do time: os agentes leem esse contexto antes de trabalhar para manter coerência entre projetos.
Nível: iniciante · Tempo estimado: 20 a 30 min
Pré-requisitos
- •Node.js — o ambiente que roda as ferramentas. Baixe em nodejs.org (versão LTS).
- •Git — o sistema que baixa e versiona código. Já vem no Mac; no Windows, instale em git-scm.com.
- •Claude Code — a ferramenta de agentes da Anthropic. Instale pelo terminal com: npm install -g @anthropic-ai/claude-code. Depois conecte com uma conta Claude ativa.
Conceitos-chave
CT ao lado dos projetos, não dentro
Se você abrir a sua pasta de trabalho, vai ver os projetos dos clientes e, no meio deles, mais uma pasta: o Centro de Treinamento. Por fora parece só mais um projeto. Por dentro, é o que comanda todos os outros.
Duas camadas: administrar e produzir
No CT você administra — cria e conserta agentes. No projeto você produz — os agentes trabalham de verdade. O CT é a oficina; o projeto é o canteiro de obras.
Fluxo numa direção só
Tudo nasce no CT e vai para os projetos. Você nunca cria agente solto dentro de um projeto — sempre parte do CT para manter a fonte única.
Passo a passo
Montando o Centro de Treinamento
Passo 1 — Baixe o Centro de Treinamento
Abra o terminal e vá para a pasta onde ficam (ou vão ficar) seus projetos. Rode o comando abaixo para clonar o repositório com toda a estrutura de agentes pronta. Em poucos segundos você tem o CT inteiro na sua máquina, ao lado dos seus projetos.
git clone https://github.com/joaoguirunas/team-os.git
Passo 2 — Conheça a estrutura por dentro
Entre na pasta que foi criada e olhe o conteúdo. A pasta que importa é a .claude, e dentro dela existem três elementos: agents (49 especialistas organizados em 5 squads: Dev, Sites, Social, Tráfego e PM), skills (49 conhecimentos ativáveis com uma barra, como pesquisa profunda e design de frontend) e hooks (travas de qualidade automáticas que impedem ações fora do padrão). Há também a pasta docs/smart-memory — a memória compartilhada do time em formato Obsidian, que os agentes leem antes de trabalhar.
Passo 3 — Abra o Claude Code dentro do CT
Ainda no terminal, dentro da pasta do CT, abra o Claude Code. Aqui você abre o Claude 'puro', sem nenhuma squad — porque neste momento você está administrando a fábrica, não produzindo. Digite / para ver o menu de comandos. Você vai encontrar dois comandos especiais: /team-os (o comando de orquestração, que também vai para os projetos) e /team-os-creator (a fábrica de agentes, exclusiva do CT — ela nunca é copiada para um projeto). Se você vê os dois no menu, seu Centro de Treinamento está montado.
claude
Passo 4 — Abra o Command Center
Rode a fábrica sem nenhum argumento. Ele faz um escaneamento das pastas ao lado do CT e abre o Command Center: um painel que mostra quais projetos já têm agentes instalados, quais estão em dia e onde existe drift (algo desatualizado em relação ao CT). É o raio-x da sua estrutura numa tela só.
/team-os-creator
Passo 5 — Instale uma squad num projeto
Quando quiser levar um time para um projeto, use a função de instalação. Ele vai perguntar qual é o projeto destino e quais squads levar (Dev, Sites, Social, Tráfego, PM ou uma combinação). Depois mostra um preview do que vai acontecer e pede confirmação. Ao confirmar, ele copia os agentes da squad escolhida, leva a skill /team-os para o projeto e deposita o arquivo de configuração. A team-os-creator não é copiada (ela nunca sai do CT), e a memória compartilhada ainda não existe no projeto — ela é criada depois, na primeira vez que você rodar o /team-os lá dentro.
/team-os-creator *install
Criar um novo agente no padrão do time
/team-os-creator Quero criar um agente especialista em copy de anúncios para a squad de Tráfego. Ele deve ler a memória compartilhada ao iniciar, focar em headlines e ângulos de campanha, e registrar cada entrega no lugar certo. Me mostre o rascunho do agente antes de gerar o arquivo.
Instalar uma squad num projeto (com preview e confirmação)
/team-os-creator *install
Erros comuns
- •Criar agente solto dentro do projeto: Não faça. Agente criado na mão fica sem contrato, não conversa com a memória e briga com a squad. Sempre parta do CT.
- •Colocar o CT dentro de um projeto: Ele fica ao lado, nunca dentro. Se colocar dentro, quebra a lógica de fonte única.
- •Não ver os comandos no menu: Confirme que você abriu o claude de dentro da pasta do CT, e não de outro lugar.
- Node.js, Git e Claude Code instalados
- CT clonado ao lado dos projetos
- Comandos /team-os e /team-os-creator aparecem no menu
- Command Center abriu e mostrou o status
- Uma squad instalada num projeto de teste
- •Centro de Treinamento (team-os) — https://github.com/joaoguirunas/team-os
- •Claude Code (npmjs) — https://www.npmjs.com/package/@anthropic-ai/claude-code
- •Node.js — https://nodejs.org
- •Git — https://git-scm.com
Vá além do tutorial
Quer dominar isso na prática?
Na Formação Gestor de IA você vai do zero ao site no ar comandando equipes de agentes, sem escrever uma linha de código.