
A Página que Entrega o Time Pronto
Instale uma squad completa no seu projeto em minutos — o mesmo time usado nos clientes reais, pronto para produzir desde o primeiro dia.
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?
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.