Aprendizado@joaoguirunas

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.

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

  1. 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.

  2. 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.

  3. 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.

  4. 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

  1. 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
  2. 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
  3. 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
  4. 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.

  5. 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.

  6. 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
  7. 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)

Próximo passo

Veja os outros recursos do catálogo

Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.

Voltar ao catálogo

Formação Gestor de IA

Aprenda a montar recursos como este, do zero

Quero ser Gestor de IA

Formação Gestor de IA

Falta um passo pro checkout

Deixa seu nome e WhatsApp. Você vai direto pro pagamento e a gente te acompanha de perto na entrada.

Com DDD. Só usamos pra te acompanhar na formação.