Como dividir seu time de agentes por função
Não instale 49 agentes de uma vez. Identifique sua entrega mais custosa e traga só a squad que resolve aquela frente.
O que é
Como dividir seu time de agentes por função
Ao fim deste tutorial você vai ter clareza sobre quais funções o seu time de agentes precisa cobrir e qual squad instalar primeiro no seu projeto. Não se trata de sair instalando 49 agentes de uma vez — o processo é o contrário: você olha para o seu dia, identifica a tarefa que mais consome tempo e instala apenas a squad que resolve aquela frente. O resultado concreto é uma squad configurada num projeto real seu, pronta para entrar em operação na próxima etapa.
Numa empresa de verdade ninguém é bom em tudo — e com agentes é exatamente igual. Quando você usa um agente genérico para tudo, ele faz tudo mais ou menos. Quando você divide por função — um pesquisa, um escreve, um revisa, um publica — cada agente fica bom no que faz, e você ganha eficiência operacional: mais entregas saindo com menos retrabalho, sem precisar acompanhar cada passo individualmente.
Os conceitos centrais deste tutorial são: Squad (grupo de agentes que cobre uma frente inteira da empresa), Função (o papel específico dentro de uma entrega), CT — Centro de Treinamento (a pasta que comanda e distribui as squads), e Instalação (o ato de levar uma squad do CT para dentro de um projeto com o comando `/team-os-creator *install`).
Antes de começar, você precisa ter o Claude Code instalado, o repositório team-os clonado localmente e um projeto real já existente numa pasta. Reserve também 20 minutos sem interrupção para a parte de caneta e papel — mapear suas entregas recorrentes é o passo mais importante e não envolve o terminal.
Como funciona
Principais recursos
Mapear entregas recorrentes
Você lista tudo o que a sua empresa entrega de forma repetida — posts, landing pages, relatórios — separando o que se repete do que acontece uma vez só.
Quebrar entregas em funções
Cada entrega é decomposta em etapas sequenciais (pesquisar, escrever, revisar, publicar), revelando quantos ofícios diferentes ela exige.
Escolher a squad certa
Você casa a entrega mais custosa com uma das 5 squads do team-os (Dev, Sites, Social, Tráfego ou PM) e foca onde o impacto é maior.
Instalar com um comando
A squad sai do CT e entra no seu projeto via `/team-os-creator *install`, copiando agentes, a skill `/team-os` e o arquivo de configuração automaticamente.
Time pronto para operar
Depois da instalação, o time pode ser acionado com `/team-os` no projeto e dividir qualquer entrega entre os agentes por função sem intervenção manual.
Nível: iniciante · Tempo estimado: 25 min
Pré-requisitos
- •Claude Code instalado na sua máquina.
- •O Centro de Treinamento (CT) clonado ao lado dos seus projetos a partir do repositório github.com/joaoguirunas/team-os.
- •Um projeto real seu já existindo numa pasta — site de um cliente, operação de conteúdo ou sistema interno.
- •20 minutos sem interrupção para mapear suas entregas com calma. Essa parte é caneta e papel, não terminal.
git clone https://github.com/joaoguirunas/team-os.git
Conceitos-chave
Squad
Um grupo de agentes que cobre uma frente inteira da empresa. O CT vem com 49 agentes organizados em 5 squads: Dev (sistemas e software), Sites (landing pages e sites), Social (conteúdo e redes), Tráfego (anúncios e campanhas) e PM (gestão de projetos).
Função
O papel específico dentro de uma entrega. "Escrever o texto" é uma função. "Revisar" é outra. Uma squad já traz várias funções embutidas, prontas para operar em sequência.
CT (Centro de Treinamento)
A pasta clonada do repositório team-os que fica ao lado dos seus projetos e comanda tudo. É de lá que as squads são instaladas nos projetos — ela é a fonte da verdade.
Instalar
O ato de levar uma squad de dentro do CT para dentro de um projeto seu, executando o comando `/team-os-creator *install` com o Claude Code aberto na pasta do CT.
Passo a passo
Passo 1 — Liste suas entregas recorrentes
Numa folha, escreva tudo o que a sua empresa entrega de forma repetida — não o que acontece uma vez por ano, mas o que acontece toda semana ou todo mês (exemplos: posts para o Instagram, landing page para lançamento, relatório de campanha, correção de bug). O time de agentes não existe para tarefas soltas; ele existe para o que se repete, que é onde a divisão de funções paga o investimento. Espere uma lista de 5 a 15 entregas — se passou muito disso, você provavelmente misturou tarefa única com entrega recorrente e deve voltar e cortar as pontuais.
Passo 2 — Quebre cada entrega em funções
Pegue uma entrega e escreva as etapas que ela percorre do começo ao fim. Um post, por exemplo: pesquisar o tema → escrever a legenda → revisar → adaptar o formato → publicar. Essa quebra revela que uma entrega não é um trabalho só — são vários ofícios em sequência, o que justifica ter uma squad em vez de um agente único. Cada entrega deve virar uma sequência de 3 a 6 funções, e você vai começar a perceber que as mesmas funções (pesquisar, escrever, revisar) reaparecem em entregas diferentes.
Passo 3 — Ache a tarefa que mais consome o dia
Olhe a sua lista e circule a entrega que hoje toma mais tempo da equipe ou mais te trava. Uma só. Você não vai montar o time inteiro de uma vez — isso é receita de confusão. O critério é tempo e travamento, não empolgação: comece pela dor maior, prove o valor ali e expanda depois. Normalmente a entrega circulada é conteúdo, sites ou algum trabalho de sistema.
Passo 4 — Escolha a squad que cobre essa frente
Case a entrega circulada com uma das 5 squads: conteúdo e redes → Social; site ou landing → Sites; software ou integração → Dev; anúncios → Tráfego; coordenação de várias frentes → PM. Cada squad já vem com as funções daquela frente prontas e no padrão do sistema — você não precisa montar agente por agente. Anote o nome da squad escolhida.
Passo 5 — Instale a squad no projeto
Abra o Claude Code dentro da pasta do CT e rode o comando de instalação. Ele vai perguntar qual é o projeto destino, depois quais squads levar; escolha a squad definida no Passo 4, confirme o preview e aguarde. Ao final, dentro do projeto vão aparecer a pasta de agentes, a skill `/team-os` e o arquivo `settings.json`. A smart-memory ainda não aparece — isso é normal, ela é construída quando você roda `/team-os` no projeto pela primeira vez.
/team-os-creator *install
Instalar a squad no projeto (rodar de dentro do CT)
/team-os-creator *install
Revisar entregas e mapear squads com ajuda do Claude Code
Vou te passar as entregas recorrentes da minha empresa. Para cada uma, quebre em funções (pesquisar, escrever, revisar, publicar, etc.) e me diga qual das 5 squads do team-os (Dev, Sites, Social, Tráfego, PM) cobre melhor essa frente. Entregas: 1) ... 2) ...
Acionar o time instalado e dividir uma entrega por função
/team-os Objetivo desta sessão: produzir a landing page do próximo lançamento. Divida a tarefa entre os agentes da squad — quem pesquisa referências, quem estrutura as seções, quem escreve o copy e quem revisa antes de entregar. Me mostre o plano com o agente responsável por cada função antes de começar.
Erros comuns
- •"Instalei e não vejo a memória do time.": A smart-memory não vem na instalação — ela nasce quando você roda `/team-os` no projeto pela primeira vez.
- •"Instalei todas as squads e me perdi.": Escolha uma frente para trabalhar de verdade esta semana e ignore o resto até dominar.
- •"O comando não aparece no menu.": Você está com o Claude Code aberto fora da pasta do CT. Feche e reabra dentro da pasta clonada.
- •"Não sei qual squad escolher.": Volte ao Passo 3. A dúvida quase sempre some quando você define qual é a entrega mais custosa.
- •Passo 1 — listar áreas ("marketing") em vez de entregas ("3 reels por semana"): Seja concreto — o que sai e com que frequência.
- •Passo 2 — pular a revisão porque "a gente faz de cabeça": Se é um passo, escreva. Ele vai virar um agente.
- •Passo 3 — escolher a tarefa mais legal em vez da mais custosa: O critério é tempo e travamento, não empolgação.
- •Passo 4 — querer instalar todas as squads logo de início: Menos é mais no começo — cada squad instalada é um time que alguém da equipe vai coordenar.
- •Passo 5 — rodar `*install` de dentro do projeto em vez do CT: A instalação parte sempre do CT, que é a fonte da verdade.
- Listei minhas entregas recorrentes (só as que se repetem).
- Quebrei cada entrega nas suas funções.
- Circulei a única entrega que mais consome o dia.
- Escolhi a squad que cobre essa frente.
- Rodei `/team-os-creator *install` de dentro do CT.
- Confirmei que a pasta de agentes, a skill `/team-os` e o `settings.json` estão no projeto.
- •Centro de Treinamento (team-os) — https://github.com/joaoguirunas/team-os
- •Claude Code — 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.