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