O Caminho Completo, Sem Ilusão
O mapa da estrada completo: da máquina zerada até uma operação de agentes rodando em paralelo, com cada etapa na ordem certa e sem atalhos.
O que é
O Caminho Completo, Sem Ilusão
Você vai montar, do zero, um time de agentes funcionando nas entregas da sua empresa. Isso significa instalar o Claude Code, clonar o Centro de Treinamento com os 49 agentes prontos, configurar as squads por função, criar o Design System, ativar as frentes de entrega e acompanhar tudo em paralelo pelo Agent View — passo a passo, na ordem certa.
A ilusão que corre por aí é a de que basta um comando e a empresa se automatiza sozinha. Não é assim. O caminho tem trabalho real — e é exatamente isso que vira vantagem: o que dá trabalho pra você montar dá trabalho pro concorrente copiar. A dificuldade não é o obstáculo, é o fosso que protege o que você construiu.
O tutorial cobre quatro conceitos centrais: o CT (Centro de Treinamento) que comanda tudo; a divisão entre a camada de administração (CT) e a camada de produção (projeto); o team-os-creator que cria e instala agentes; e o team-os que monta a Smart Memory na primeira execução dentro de um projeto.
Antes de começar, você vai precisar de um computador com Node.js e Git instalados, uma conta Claude e disposição pra construir em etapas — sem pular passo. Todo o repositório é aberto: github.com/joaoguirunas/team-os.
Como funciona
Principais recursos
Base técnica em minutos
Instale o Claude Code e clone o Centro de Treinamento com um comando. Você parte de zero e termina com o motor e os 49 agentes prontos na sua máquina.
Duas camadas sem confusão
No CT você administra — cria, atualiza e conserta agentes. No projeto você produz. Entender essa divisão evita meses de erro sobre o que fica onde.
Squads organizadas por função
Instale apenas as squads que resolvem a sua maior dor primeiro: Dev, Sites, Social, Tráfego ou PM. Divisão de papel, não super-agente.
Design System como base comum
Crie a identidade visual antes de produzir qualquer entrega. Sites, Social e Tráfego herdam a mesma base e saem alinhados desde o primeiro arquivo.
Smart Memory que lembra
O time-os lê o código do projeto e monta a memória automaticamente. O time começa sabendo do contexto, em vez de recomeçar do zero toda vez.
Escala pelo Agent View
Despache várias frentes ao mesmo tempo e acompanhe cada sessão pelo Agent View. Uma pessoa coordena muitas entregas em paralelo, sem perder o fio.
Nível: intermediário · Siga no seu ritmo, uma etapa por vez.
Pré-requisitos
- •Um computador (Mac ou Windows) e uma conta Claude
- •Uma pasta onde vão morar os seus projetos
- •Node.js e Git instalados (nodejs.org e git-scm.com)
- •Disposição pra construir em etapas, sem pular passo
Conceitos-chave
CT (Centro de Treinamento)
O centro que comanda tudo — uma pasta que fica ao lado dos seus projetos. É de lá que você administra o time.
Duas camadas
No CT você administra; no projeto você produz. Essa divisão é o que mantém a organização do time ao longo do tempo.
team-os-creator
A fábrica que cria, atualiza e instala agentes. Vive exclusivamente no CT e é o ponto de entrada para qualquer mudança no time.
team-os
A skill que liga o time dentro de um projeto e monta a Smart Memory na primeira vez que é executada.
Passo a passo
Passo 1 — Base técnica
Instale o Claude Code e clone o Centro de Treinamento. Sem a base, nada roda. O Claude Code é o motor que executa os agentes; o git clone copia o CT com os 49 agentes prontos para uso imediato.
npm install -g @anthropic-ai/claude-code git clone https://github.com/joaoguirunas/team-os.git
Passo 2 — Entenda as duas camadas
Abra o Claude Code dentro do CT e confira o menu. Digite / e veja os comandos /team-os e /team-os-creator. No CT você administra (cria e conserta), no projeto você produz (os agentes trabalham). Entender essa divisão evita meses de confusão sobre o que fica onde.
claude
Passo 3 — Monte o time por função
Liste as suas entregas recorrentes, quebre cada uma em funções e instale a squad que resolve a sua maior dor primeiro. Squads disponíveis: Dev, Sites, Social, Tráfego e PM. O segredo não é um super-agente, é divisão de papel.
/team-os-creator *install
Passo 4 — Crie o Design System
Antes de produzir qualquer entrega, monte a identidade visual em claude.ai/design (projeto do tipo Design System) e mande pro Claude Code com 'Send to Claude Code'. Sem identidade, Sites, Social e Tráfego vão produzir muita coisa com cara diferente. O Design System é a base que todos herdam.
Passo 5 — Ative as frentes de entrega
Com time e identidade prontos, ligue as frentes — cada uma tem tutorial próprio. Sites: gere o KV de Site, deixe o squad de Sites construir e publique com GitHub + Vercel. Social: o squad de conteúdo produz reels e carrosséis de ponta a ponta. Sistemas: escreva um PRD e deixe o squad de Dev construir o que a empresa precisa. Tráfego: gere o KV de Tráfego pra manter a mesma identidade em toda campanha.
Passo 6 — Construa a Smart Memory
Dentro de cada projeto, rode /team-os. Na primeira vez ele lê o código e monta a memória em docs/smart-memory/. Preencha os campos marcados como TODO com o que o código não revela (propósito, regras, tom). É o que faz o time começar sabendo do projeto, em vez de recomeçar do zero toda vez.
/team-os
Passo 7 — Escale acompanhando em paralelo
Despache e acompanhe várias frentes ao mesmo tempo pelo Agent View. Cada tarefa vira uma linha na tela; você espia, responde o que precisa e sai — as sessões seguem rodando sem você. É assim que uma pessoa dá conta de coordenar muitas entregas ao mesmo tempo.
claude agents
Plano de entregas antes de executar
Somos um time. Estas são as minhas entregas recorrentes: [liste as suas]. Quebre cada uma nas funções que ela exige e me diga qual squad resolve cada frente. No fim, sugira por onde começar considerando a minha maior dor.
Frente 1 — Site (Agent View)
Monte a estrutura da página inicial do site seguindo o Design System.
Frente 2 — Social (Agent View)
Escreva o roteiro de um reel sobre o serviço principal, no tom da marca.
Frente 3 — Sistemas (Agent View)
Rascunhe o PRD do sistema interno que a empresa precisa, começando pelo problema.
Erros comuns
- •Pular o Design System pra "ir logo pro site": depois tudo sai desalinhado e você refaz. Identidade primeiro.
- •Criar agente solto no projeto: sempre parta do CT — nasce lá, vai pro projeto.
- •Achar que é rápido: expectativa realista evita frustração. É construção, não mágica.
- Claude Code instalado e CT clonado
- Entendi as duas camadas (administrar x produzir)
- Primeira squad instalada por função
- Design System criado e enviado pro Claude Code
- Uma frente de entrega ativa (site, social, sistema ou tráfego)
- Smart Memory construída no projeto
- Agent View acompanhando em paralelo
- •Repositório do time de agentes — Centro de Treinamento e os 49 agentes (https://github.com/joaoguirunas/team-os)
- •Claude Code — o motor que roda os agentes e abre o Agent View (https://www.npmjs.com/package/@anthropic-ai/claude-code)
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.