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ê
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?
Aprofunde com acompanhamento direto na mentoria ou siga o passo a passo completo, do zero ao avançado, no curso online.