A Página que Entrega o Time Pronto
Neste tutorial você vai instalar uma squad pronta num projeto real, sem montar agentes do zero. O caminho é curto: clonar o Centro de Treinamento, abrir a
O que é
A Página que Entrega o Time Pronto
Neste tutorial você vai instalar uma squad pronta num projeto real, sem montar agentes do zero. O caminho é curto: clonar o Centro de Treinamento, abrir a fábrica, escolher uma das squads já configuradas e ligar o time. No final, o seu projeto terá exatamente o mesmo time que a equipe usa nos clientes reais — não uma versão de demonstração.
Existe uma diferença enorme entre criar um agente e instalar um time que já funciona. Na maioria dos projetos você não precisa reinventar nada: as frentes de um negócio digital — desenvolvimento, sites, social, tráfego, gestão — já estão cobertas por squads prontas, com papéis definidos, regras internas e forma de trabalhar estabelecida. Você começa a produzir hoje, com um padrão que já foi testado.
O tutorial gira em torno de quatro conceitos: o team-os (a skill que liga o time em qualquer projeto), o team-os-creator (a fábrica exclusiva do CT que instala as squads), as squads prontas (Dev, Sites, Social, Traffic e PM), e o template de time (a ideia de aplicar uma equipe pré-montada em vez de construí-la peça por peça).
Antes de começar, você precisa ter o Claude Code instalado (`npm install -g @anthropic-ai/claude-code`), o Git disponível (`git -v` responde) e uma pasta de projetos onde o CT vai ficar ao lado dos seus trabalhos.
Como funciona
Principais recursos
Squads prontas incluídas
Cinco times já configurados (Dev, Sites, Social, Traffic, PM) com especialistas, regras e forma de trabalhar definidos. Nenhuma montagem manual necessária.
Fábrica de instalação
O team-os-creator instala a squad inteira no projeto de destino, copiando agentes, skill e settings em um único comando.
Skill team-os integrada
Após a instalação, o /team-os liga o time, faz o Discovery do projeto e constrói a memória compartilhada da squad com o contexto real do negócio.
Template de time padronizado
O mesmo team-os usado nos projetos de clientes reais. O que você instala não é uma demonstração, é a operação de verdade.
Centro de Treinamento central
Repositório único que abastece todas as instalações. Alterações nos agentes se propagam pelo CT, mantendo o padrão em todos os projetos.
Nível: iniciante · Tempo estimado: 20 min
Pré-requisitos
- •Claude Code instalado — rode `claude --version` para confirmar. Se ainda não tem: `npm install -g @anthropic-ai/claude-code`
- •Git instalado — `git -v` deve responder
- •Uma pasta de projetos onde o Centro de Treinamento vai ficar ao lado dos seus trabalhos
Conceitos-chave
team-os
A skill que liga o time dentro de um projeto. Ela vai para todos os projetos onde você instala uma squad e é o que acende a operação.
team-os-creator
A fábrica, exclusiva do Centro de Treinamento. É por ela que você escolhe e instala a squad pronta — ela nunca sai do CT.
Squad pronta
Um dos 5 times que já vêm no CT (Dev, Sites, Social, Traffic, PM), cada um com seus especialistas, regras e forma de trabalhar já definidos.
Template de time
A ideia de que a squad é uma equipe pré-montada e padronizada que você aplica a um projeto — não algo que você constrói peça por peça.
Passo a passo
Instalando o time de agentes pronto
Passo 1 — Trazer o Centro de Treinamento
Entre na sua pasta de projetos e clone o CT. As squads prontas moram dentro do repositório github.com/joaoguirunas/team-os — cloná-lo traz todas elas para a sua máquina de uma vez. O CT precisa ficar ao lado dos projetos, porque é a fonte que abastece cada instalação. Ao final, você terá uma pasta `team-os` nova ao lado dos seus projetos.
git clone https://github.com/joaoguirunas/team-os.git
Passo 2 — Abrir a fábrica no CT
Entre no CT, abra o Claude Code e chame a creator sem argumento. Chamar a creator sem argumento abre o Command Center — o painel que mostra o estado da operação. É um bom hábito olhar esse painel antes de instalar, para saber o que você já tem e o que ainda está limpo. Você verá o painel de status com os projetos ao lado do CT e o que cada um tem instalado.
cd team-os claude /team-os-creator
Passo 3 — Instalar a squad pronta
Dispare a instalação e escolha a squad que faz sentido para o seu projeto. Aqui está o pulo do gato: você não cria nada — você seleciona uma squad que já existe e a creator a instala inteira, no padrão. A ferramenta pergunta o destino, pergunta qual squad, mostra o preview e só age depois da sua confirmação. Em ordem você verá: a pergunta do projeto de destino, a escolha da squad (Dev, Sites, Social, Traffic, PM ou combinação), o preview, a sua confirmação e a cópia dos agentes, da skill `/team-os` e do `settings.json`. A `team-os-creator` não vai junto — ela nunca sai do CT.
/team-os-creator *install
Passo 4 — Ligar o time no projeto
Saia do CT, entre no projeto que você equipou, abra o Claude Code e rode `/team-os`. A squad pronta chegou, mas ainda está desligada. O `/team-os` acende o time. Na primeira vez, ele faz o Discovery: lê o código do projeto e monta a memória compartilhada, para que a squad pronta comece já sabendo o contexto do seu negócio específico. Você verá o scan do ambiente, a proposta de construir a memória, a leitura do código e o painel final perguntando o objetivo da sessão. A partir daí, a squad pronta está trabalhando no seu projeto.
/team-os
Mapear agentes instalados
Liste os agentes instalados neste projeto e, em uma linha cada, o que cada um resolve. Depois me diga se falta alguma função para as minhas entregas recorrentes: site, social e tráfego.
Primeira entrega real com a squad
Somos um time. Quero publicar a primeira página do meu site esta semana. Distribua as tarefas entre os agentes certos, me mostre quem faz o quê e comece pela estrutura. Só me pergunte o que você não consegue deduzir do projeto.
Erros comuns
- •"Instalei a squad mas ela não conhece meu projeto": você provavelmente não rodou o /team-os ainda, ou pulou o Discovery. É o /team-os que constrói a memória do projeto.
- •"Quero mudar um agente da squad pronta": não edite direto no projeto. A alteração se faz no CT e se propaga pela creator, para não perder o padrão.
- •"A skill /team-os não aparece no projeto": ela só chega via *install. Confirme que a instalação terminou e que você está no projeto certo.
- •Clonar o CT dentro de um projeto: confirme com `pwd` que você está na pasta que contém seus projetos, não dentro de um deles.
- •Procurar a creator num projeto: a team-os-creator é exclusiva do CT.
- •Escolher a squad errada para o tipo de projeto: se é um site de cliente, comece pela Sites; se é gestão, PM. Você pode instalar mais squads depois.
- •Esperar que a squad já saiba tudo sem rodar o /team-os: o template traz os papéis e as regras; o contexto do SEU projeto só entra quando você liga o time.
- CT clonado ao lado dos projetos
- Command Center aberto com /team-os-creator
- Squad pronta escolhida e instalada com /team-os-creator *install
- Confirmei que é o mesmo team-os usado nos clientes
- /team-os rodado no projeto e memória construída
- Entendi o conceito de "template de time"
- •Repositório do time de agentes — Centro de Treinamento e squads prontas (https://github.com/joaoguirunas/team-os)
- •Claude Code — o motor que roda os agentes (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.