Squads

Claude Agent Teams

Name: Claude Agent Teams
Author: joaoguirunas

@joaoguirunas

27 agentes pré-configurados em 3 squads com smart-memory e orquestração via /team-os. Drop-in para qualquer projeto Claude Code.

Ver no GitHub Voltar

O que e

Claude Agent Teams

Claude Agent Teams é um pacote de configuração drop-in para Claude Code com 27 agentes pré-configurados organizados em três squads especializadas: Dev Squad para desenvolvimento de software, Sites Squad para projetos web e Social Squad para conteúdo e marketing.

O sistema inclui o /team-os — skill de orquestração que detecta automaticamente o estado do projeto, propõe a composição ideal do time e coordena execução em paralelo via Agent Teams nativo. Novos projetos ganham descoberta automática de arquitetura; projetos existentes retomam work-in-progress sem configuração manual.

A smart-memory compartilhada em formato Obsidian garante que todos os agentes partam do mesmo contexto — arquitetura, módulos, conventions e histórico de decisões — sem repetir descoberta a cada sessão. Mais de 40 skills especializadas são injetadas automaticamente nos agentes certos.

Como funciona

Principais recursos

27 Agentes Pré-configurados

Dev Squad (10), Sites Squad (10) e Social Squad (7) prontos para usar. Cada agente tem papel, ferramentas e contratos de comunicação definidos.

/team-os Orchestration

Skill de orquestração inteligente que detecta o estado do projeto automaticamente: bootstrap, discover, plan, dispatch e status em um único comando.

Smart Memory Compartilhada

Sistema de memória persistente em formato Obsidian. Módulos, arquitetura, stories e histórico de delegações acessíveis por todos os agentes da squad.

Execução em Paralelo

Agentes trabalham simultaneamente via Agent Teams nativo do Claude Code. Comunicação via SendMessage, coordenação via TaskList compartilhada.

40+ Skills Integradas

SEO, copywriting, acessibilidade, deploy, design system, UX research e muito mais. Cada skill é injetada automaticamente no agente certo.

Drop-in Setup

Copie a pasta .claude/ para qualquer projeto e a squad está pronta. Sem configuração extra. Requer CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1.

Tutorial completo

Do zero ao time de agentes

Instalação, configuração e primeiro uso do /team-os — a skill que orquestra tudo.

Pré-requisitos

Claude Code instalado (npm i -g @anthropic-ai/claude-code)
Plano Claude Pro ou Team (Agent Teams requer API com suporte a sub-agentes)
macOS, Linux ou WSL2 (Windows nativo não suportado)
Git instalado

Instalação

Clone o repositório e copie a pasta .claude/ para o seu projeto:

# Clonar o repositório
git clone https://github.com/joaoguirunas/claude-agent-teams.git

# Copiar pasta .claude para o seu projeto
cp -r claude-agent-teams/.claude/ /caminho/do/seu-projeto/

# Entrar no seu projeto
cd /caminho/do/seu-projeto

Alternativa — symlink para atualizar automaticamente:

ln -s /caminho/para/claude-agent-teams/.claude /caminho/do/seu-projeto/.claude

Ativar Agent Teams

Agent Teams ainda é experimental. Ative via variável de ambiente antes de abrir o Claude Code:

# Adicionar ao ~/.zshrc ou ~/.bashrc
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

# Recarregar o shell
source ~/.zshrc

Confirme que a variável está ativa antes de abrir o Claude Code:

echo $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS
# Deve retornar: 1

Abrir o Claude Code no projeto

cd /caminho/do/seu-projeto
claude

O Claude Code abre no diretório do projeto com todos os agentes disponíveis via .claude/agents/.

Invocar o /team-os

O /team-os é a skill central que orquestra tudo. Ele detecta automaticamente o estado do projeto e roteia para a ação certa:

/team-os

O que acontece por baixo:

NEWProjeto sem smart-memory → propõe bootstrap automático com time de descoberta

NO_DISCOVERYEstrutura existe mas sem mapeamento → oferece *discover (audita código, mapeia módulos)

IN_PROGRESSStories ativas detectadas → retoma trabalho automaticamente (*resume)

READYSmart-memory OK, sem stories → pede objetivo para formar novo time

Bootstrap — primeira vez num projeto

Em projetos novos, o /team-os forma um time de descoberta que audita o código em paralelo e popula a smart-memory automaticamente:

/team-os *bootstrap

O que o bootstrap produz em docs/smart-memory/:

docs/smart-memory/
├── project/
│   ├── overview.md       ← síntese do projeto
│   ├── modules.md        ← mapa de rotas/módulos
│   ├── architecture.md   ← padrão arquitetural + ADRs
│   ├── tech-stack.md     ← dependências e versões
│   └── conventions.md    ← naming, imports, padrões
├── agents/ux/
│   └── components.md     ← catálogo de componentes UI
└── ops/
    └── teams-log.md      ← registro dos times formados

Planejar um ciclo de trabalho

Com a smart-memory populada, use *plan para quebrar um objetivo em stories acionáveis:

/team-os *plan "implementar página de preços com 3 planos e integração Stripe"

O sites-architect (ou dev-architect no Dev Squad) quebra em stories numeradas e salva em docs/smart-memory/stories/backlog/.

Despachar o time para execução

Com as stories validadas no backlog, forme o time e inicie a execução em paralelo:

/team-os *dispatch

O /team-os seleciona os agentes certos para o objetivo, forma o Agent Team e cada teammate recebe as tasks automaticamente. Acompanhe com Shift+Tab para ver todos os agentes ativos em paralelo.

Referência de comandos /team-os

/team-osFluxo inteligente — detecta estado e roteia automaticamente

/team-os *bootstrapInit + descoberta em paralelo — popula toda a smart-memory

/team-os *discoverSó auditoria — pressupõe smart-memory já inicializada

/team-os *plan "objetivo"Quebra objetivo em stories e popula backlog

/team-os *dispatchForma time e inicia trabalho nas stories ativas

/team-os *statusEstado atual: tasks, stories, agentes, blockers

/team-os *resumeLê smart-memory e retoma trabalho em progresso

/team-os *auditAuditoria de smart-memory + conformidade dos teammates

/team-os *unblock <agente>Resolve blocker específico de um agente

/team-os *closeArquiva smart-memory e encerra o team

As squads

27 agentes em 3 squads especializadas

Cada squad tem agentes com papéis, ferramentas e autoridades distintas. O /team-os monta o subconjunto mínimo necessário para cada objetivo.

Dev Squad

10 agentes

›dev-analyst — pesquisa e análise técnica
›dev-architect — ADRs e criação de stories
›dev-dev-alpha — frontend React/TypeScript
›dev-dev-beta — backend e APIs
›dev-dev-gamma — fullstack e integrações
›dev-dev-delta — hardening e edge cases
›dev-devops — git push, PRs, CI/CD
›dev-qa — quality gates e veredictos
›dev-data — schema, migrations, RLS
›dev-ux — UX research e componentes

Sites Squad

10 agentes

›sites-analyst — SEO e pesquisa de mercado
›sites-architect — arquitetura e stories
›sites-dev-alpha — UI React/Tailwind/shadcn
›sites-dev-beta — backend e integrações
›sites-dev-gamma — fullstack e CRO
›sites-dev-delta — hardening e performance
›sites-devops — deploy Vercel/Netlify
›sites-qa — acessibilidade e SEO audit
›sites-data — banco e migrações
›sites-ux — UX research e design

Social Squad

7 agentes

›social-strategist — estratégia e calendário
›social-copywriter — copy para posts e DMs
›social-designer — visual e carrosséis
›social-video — roteiro e edição com IA
›social-analyst — métricas e relatórios
›social-ads — Meta/Google Ads
›social-community — DMs e engajamento

Comece agora

Explore o repositorio, contribua com melhorias ou integre na sua operacao.

Ver no GitHub