Aprendizado@joaoguirunas

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

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

01

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.

02

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.

03

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.

04

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

01

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
02

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
03

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
04

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.

05

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.

06

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
07

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.
Checklist final
  • 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?

Aprofunde com acompanhamento direto na mentoria ou siga o passo a passo completo, do zero ao avançado, no curso online.