skill

team-os

team-os — 102 agentes e 112 skills em 11 squads (Dev, Sites, Social, Traffic, PM, Sales, Brand, Finance, Legal, SEO, Security) para Claude Code Agent Teams. /team-os monta e orquestra o time com smart

joaoguirunas/team-oscommunitylistedunreviewed

Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/joaoguirunas/team-os itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 17, 2026

team-os

Pack de orquestração para Claude Code Agent Teams — by João Guirunas

102 agentes e 112 skills organizados em 11 squads (Dev, Sites, Social, Traffic, PM, Sales, Brand, Finance, Legal, SEO, Security), com a skill /team-os para orquestrar sessões, a /team-os-creator para gerar e instalar squads em qualquer projeto, e a Sala de Controle (opt-in) — um lugar único de comando que manda cada pedido para a sessão certa: /sala-de-controle (sessões do Claude Code) ou /maestri-os (terminais do Maestri). Todo agente segue o Native Teams Protocol — autônomo, com smart-memory integrada (formato Obsidian) e coordenação peer-to-peer.

Este repositório é a fonte da verdade: edite agentes e skills aqui, audite com /team-os-creator *audit e propague para os projetos destino com /team-os-creator *propagate. Nunca edite agentes direto no destino.

Por que team-os?

Times de IA superam uma sessão única quando o trabalho tem partes independentes. O team-os transforma isso em algo pronto pra usar:

Paralelismo real — várias sessões trabalham ao mesmo tempo, cada uma com seu próprio context window. Research, review e features divididas por módulo terminam em uma fração do tempo de uma sessão sequencial.
Especialização com autoridade clara — 102 papéis prontos, com fronteiras explícitas (quem cria story, quem dá veredicto de QA, quem faz git push). Sem sobreposição, sem agente pisando no outro.
Coordenação autônoma — comunicação peer-to-peer + TaskList compartilhada + self-claim. Os teammates se organizam sozinhos; o lead orquestra em vez de microgerenciar.
Memória que persiste — smart-memory em formato Obsidian acumula arquitetura, decisões, stories e QA entre sessões. O time não recomeça do zero.
Qualidade embutida — hooks (block-git-push, gates de task), QA com veredicto formal PASS/CONCERNS/FAIL/WAIVED e plan mode obrigatório em mudanças de risco (schema, auth, CI/CD).
Custo sob controle — política de modelos Híbrida: opus só onde o raciocínio é crítico (arquitetura, veredictos), inherit no resto (seguem o /model do lead). Você baixa a frota inteira pra um modelo barato quando quiser.
Reuso instantâneo — /team-os-creator *install leva squads + skills + smart-memory para qualquer projeto. Uma fonte da verdade, propagação controlada.
Menos context-rot — cada agente é isolado: exploração e logs ficam no context dele, não no seu.

Índice

⭐ the team-os Method — a metodologia
Instalar e atualizar — baixar, instalar, *update, onde ficam os meus agentes

Conceitos fundamentais
Pré-requisitos e setup — Requisitos de máquina · MCPs por squad
Skill principal: /team-os
Skill principal: /team-os-creator
Os 102 agentes e suas skills
Catálogo de skills de apoio
Tutorial passo a passo
Modelo de coordenação
Política de modelos (Híbrido)
Hooks de qualidade
Estrutura do repositório
Troubleshooting
Manutenção do CT

Licença

⭐ the team-os Method

A metodologia que torna o pack repetível para a sua equipe e seus mentorados. São duas camadas e 7 fases.

Duas camadas

CAMADA 1 — CT (configuração e manutenção, no command center)
  abre `claude` (puro) na pasta do CT
   └─ /team-os-creator  →  escaneia os projetos irmãos e mostra status (team-os? agentes? drift?)
        ├─ [1] Criar equipe       → novos agentes/squad (Native Teams Protocol + smart-memory + skills + modelo híbrido)
        ├─ [2] Atualizar equipes  → propaga o drift para os projetos
        ├─ [3] Instalar equipe    → instala squad + skills + team-os num projeto (pasta de Sala → só a skill de Sala)
        └─ [4] Organizar pastas   → árvore negócio → projeto → squads, o que está fora do padrão e a proposta
   → cada projeto passa a ter: agentes + skills + /team-os  (NUNCA team-os-creator)

CAMADA 2 — Projeto (execução, toda sessão de trabalho)
  abre `claude agents` (agent view)
   └─ /team-os  (SEMPRE o 1º comando da sessão)
        ├─ valida Agent Teams nativo
        ├─ sem smart-memory? → Discovery: lê o codebase e a constrói ANTES de começar
        └─ organiza o time com paralelismo máximo e dispara a execução

As 7 fases

#	Fase	O que acontece	Onde
1	Setup	Instalar a squad no projeto via `/team-os-creator *install` (uma vez por projeto).	CT
2	Bootstrap	`/team-os` no início de toda sessão — valida o ambiente de Agent Teams nativo.	Projeto
3	Discovery	Sem smart-memory? O team-os lê o codebase real e constrói a smart-memory populada antes de qualquer trabalho.	Projeto
4	Team Design	Objetivo → mapeia workstreams independentes → spawna o time certo (comece com 3-5, 1 por workstream independente, sem teto fixo), com ownership exclusivo de arquivos — onde o ownership não é disjunto, serializa com task dependencies.	Projeto
5	Parallel Execution	TaskList compartilhada + self-claim + comunicação peer-to-peer entre teammates.	Projeto
6	Sync & QA	Veredictos formais (PASS/CONCERNS/FAIL/WAIVED), gates por hook, hardening.	Projeto
7	Memory & Ship	Cada agente grava findings na smart-memory; DevOps faz push/PR/release.	Projeto

Princípios

Paralelismo é o default, sem teto fixo. O limite não é um número mágico — é independência real (ownership de arquivos disjunto) + budget de tokens. N módulos independentes → N agentes, seja 5 ou 15.
Smart-memory é o cérebro compartilhado. Todo agente lê ao iniciar e grava ao concluir. O time nunca recomeça do zero.
Autoridade clara, sem sobreposição. Quem cria story, quem dá veredicto, quem faz push — cada papel tem fronteira explícita.
Uma fonte da verdade. Tudo nasce no CT e é propagado; nunca se edita agente direto no projeto.

Instalar e atualizar

Esta seção é para quem usa o pack. (Quem mantém o pack oficial tem outro ciclo: MAINTAINERS.md.)

Do zero ao time rodando

Pré-requisitos: o app do Claude com a aba Code (ou o Claude Code no terminal), um plano com Agent Teams, e git, bash e python3 na máquina. Você não precisa configurar o Agent Teams: o *install e a /team-os fazem isso.

A ideia em uma linha: o CT (o clone deste repositório) é onde você monta e mantém as equipes; os projetos são onde elas trabalham.

1. Crie a pasta pai e as pastas dos projetos

Uma pasta pai (o nome é livre, por exemplo Projetos) guarda o CT e todos os seus projetos, lado a lado. Projetos podem ficar soltos ou agrupados por negócio.

Projetos/
├── 0 | Centro de Treinamento/   ← o clone do team-os (passo 2)
├── 1 | Sala de Controle/        ← opcional (passo 6)
├── projeto-a/
└── Minha Empresa/
    ├── Minha Empresa | Site/
    └── Minha Empresa | Comercial/

Por quê: o CT enxerga os projetos olhando a pasta onde ele mesmo está. Você deve ver: a pasta pai com as pastas dos projetos dentro.

2. Clone o team-os dentro da pasta pai

Num terminal aberto na pasta pai (ou pedindo ao Claude, na aba Code, com a pasta pai aberta):

git clone https://github.com/joaoguirunas/team-os.git "0 | Centro de Treinamento"

O nome da pasta é livre; o 0 | só faz o CT aparecer primeiro na lista. Sem git, baixe o .zip do GitHub e descompacte no mesmo lugar.

Por quê: o clone é o CT, a fonte da verdade dos agentes e das skills. Você deve ver: a pasta do CT ao lado das pastas dos projetos.

Seus projetos estão em outro lugar? Crie, na raiz do CT, um arquivo .team-os-root com o caminho da pasta pai (uma linha). Ele fica fora do git.

3. Abra o CT e rode o Command Center

No app do Claude, abra a pasta do CT na aba Code e rode:

/team-os-creator

Por quê: o CT é a camada de configuração. Aqui você cria, instala e atualiza equipes; não trabalha nos projetos. Você deve ver: uma tabela com cada projeto (team-os instalada, nº de agentes, smart-memory, desatualizado ou em dia) e quatro ações: Criar, Atualizar, Instalar, Organizar.

4. Instale a equipe de cada projeto

Ainda no CT:

/team-os-creator *install

Ou em linguagem natural: "instale a squad sites no projeto-a". Ele pergunta o projeto e as squads, mostra exatamente o que vai copiar e só age depois do seu OK.

Cada projeto recebe só as squads de que precisa, uma ou mais: dev, sites, social, traffic, pm, sales, brand, finance, legal, seo e security. As de auditoria entram como complemento: um site com SEO é sites,seo; um app com banco e login é dev,security. O *install sugere a combinação pelos sinais do projeto.

Por quê: cada projeto só carrega o time que vai usar. Você deve ver: o preview (agentes, skills, hooks) antes de confirmar. Depois, o projeto tem .claude/agents/, .claude/skills/ (com a team-os), os hooks e o Agent Teams já ativado.

5. Ligue o time no projeto

Abra a pasta do projeto no app (aba Code) e rode:

/team-os

Na primeira vez:

se o Agent Teams ainda não estiver ativo nesta sessão, a /team-os avisa: feche e abra uma sessão nova (só acontece uma vez);
ela lê o código do projeto e monta a smart-memory (docs/smart-memory/), a memória compartilhada da equipe.

Depois ela pergunta o objetivo da sessão e propõe um time do tamanho do trabalho (começa com 3 a 5 agentes e cresce se houver trabalho paralelo de verdade). Nada é criado sem o seu OK.

Com o time rodando, o agent panel aparece abaixo do prompt: ↑↓ navegam, Enter abre, Esc interrompe, x para, Ctrl+T mostra as tasks. Sessões em segundo plano ficam no Agent view (claude agents). A diferença: o agent panel mostra os teammates desta sessão; o Agent view lista sessões independentes.

Você deve ver: a proposta de time e, depois do OK, os agentes trabalhando no agent panel.

6. (Opcional) Crie a Sala de Controle

Um lugar único para mandar pedidos para todos os projetos e ver o que cada sessão está fazendo.

Crie a pasta 1 | Sala de Controle na pasta pai.
No CT, rode /team-os-creator *install e escolha essa pasta. Ele reconhece a Sala e instala só a skill sala-de-controle, sem agentes (por baixo: --squads none --extra-skills sala-de-controle).
Abra uma sessão na pasta da Sala e rode:

/sala-de-controle
/sala-de-controle *organizar
/sala-de-controle *painel

Você deve ver: no *organizar, a árvore negócio → projeto → squads com o que está fora do padrão; no *painel, o mapa vivo em 127.0.0.1:8787, com cada sessão, seus agentes por estado (ativo, aguardando, parado, precisa de você) e o consumo de tokens.

7. Mantenha tudo atualizado

Comando (no CT)	O que faz
`/team-os-creator`	Mostra quais projetos estão desatualizados em relação ao CT
`/team-os-creator *update`	Traz a versão nova do pack para o seu CT, sem perder agentes, skills ou edições suas (detalhes abaixo)
`/team-os-creator *propagate`	Leva as mudanças do CT para os projetos, só nas squads que cada um já tem; se você editou um arquivo no projeto, ele pergunta antes de trocar
`/team-os-creator *audit`	Confere se os agentes e as skills do CT seguem o padrão (rode depois de criar ou editar)

O *propagate não faz commit nos projetos: as mudanças ficam esperando o commit na sessão de cada projeto.

Como atualizar o pack (`*update`)

A cada versão nova, o pack ganha agentes, skills e correções. Para trazer isso para a sua pasta sem perder nada que é seu, abra o Claude Code na pasta do CT e rode:

/team-os-creator *update

Passo a passo:

Ele só olha primeiro. Compara a sua versão com a mais nova publicada e mostra, em poucas linhas, o que mudou e quantos arquivos serão atualizados. Nada é alterado nessa etapa.
Você confirma uma vez. Sem o seu "pode atualizar", nada acontece.
Ele baixa a versão nova, confere cada arquivo (se algum não bater com o que foi publicado, ele para e não altera nada) e só então troca os arquivos, um a um.
Guarda uma cópia de segurança só dos arquivos que trocou, em .team-os/backups/ (as 3 últimas ficam; as mais antigas vão para a Lixeira).
Se você tiver editado algum arquivo do pack, veja abaixo.
Confere tudo no final (o mesmo *audit) e escreve um relatório em .team-os/update-report.md.
Oferece levar a versão nova para os seus projetos (*propagate), mostrando antes o que mudaria em cada um.

O que o *update nunca toca:

os agentes que você criou (origin: custom) e as skills que você criou;
seus presets em .claude/skills/team-os-creator/presets/custom/;
a smart-memory dos projetos (docs/smart-memory/), seus arquivos de configuração local (.claude/settings.local.json) e o arquivo .team-os-root;
qualquer arquivo seu que não faça parte do pack.

O *update também não mexe no seu git: não roda git pull, não faz commit e não envia nada. O que fazer com o git da sua pasta é decisão sua (se quiser guardar o resultado num repositório seu, você mesmo faz o commit).

E se eu editei um arquivo do pack? Ele nunca sobrescreve o seu. Se a versão nova mexeu no mesmo arquivo, o seu continua como está e a versão nova é gravada ao lado, com o nome <arquivo>.new. Aí o Claude pergunta, um arquivo por vez, o que você prefere: manter o meu (a versão nova é descartada), usar o novo (o seu fica guardado em .team-os/backups/) ou ver a diferença antes de decidir. Se você quiser decidir depois, tudo bem: as pendências continuam anotadas.

Como desfazer: peça ao Claude, na pasta do CT, para desfazer a última atualização do pack (por baixo, é bash .claude/skills/team-os-creator/scripts/update-pack.sh --undo). Os arquivos trocados voltam ao que eram e os que a atualização tinha acrescentado vão para a Lixeira.

⚠️ Versões anteriores à 2.4.0 não têm *update. Se a sua pasta está numa delas (confira o arquivo VERSION; se ele não existir, é uma versão anterior), atualize uma única vez com git pull dentro da pasta do CT (ou baixando o pack de novo). Dali em diante, use sempre *update. Cuidado: o git pull pode reclamar se você editou arquivos do pack — nesse caso, guarde uma cópia do que você mudou antes de puxar.

Onde ficam os meus agentes

Os agentes que você cria com /team-os-creator *create (ou *squad) nascem como agentes próprios: o arquivo em .claude/agents/ leva origin: custom no cabeçalho e o registro fica em .claude/skills/team-os-creator/presets/custom/custom.yaml. Você escolhe o nome livremente. Essa pasta e esses agentes são seus: o *update nunca os apaga nem os sobrescreve (ele só renova neles o bloco do Native Teams Protocol, que precisa ser igual ao da versão nova). O *audit confere os seus agentes com as mesmas regras dos do pack e os conta à parte ("102 do pack + N próprios"). Para levá-los a um projeto, use o *install/*propagate com a opção --custom <nomes|all>.

1. Conceitos fundamentais

Conceito	O que é
Agent Teams	Recurso (experimental) do Claude Code onde várias sessões trabalham em paralelo como um time. Uma sessão é o lead; as demais são teammates, cada uma com seu próprio context window.
Lead nativo	A main session do Claude Code é o lead — não existe agente "orquestrador". O lead spawna teammates, distribui tasks e sintetiza resultados.
Teammate	Sessão independente spawnada pelo lead a partir de uma definição em `.claude/agents/`. Comunica-se peer-to-peer com outros teammates via `SendMessage`.
Subagent	Mesma definição rodando como helper dentro de uma sessão (reporta só ao chamador). Os arquivos em `.claude/agents/` servem aos dois modos.
TaskList nativo	Lista de tasks compartilhada pelo time. Estados `pending → in_progress → completed`, com dependências e self-claim.
Smart-memory	Base de conhecimento persistente em `docs/smart-memory/` (formato Obsidian: frontmatter YAML + wikilinks `[[...]]` + tags). Source of truth que todo agente lê ao iniciar e atualiza ao concluir.
Native Teams Protocol	Contrato que todo agente do CT carrega: smart-memory como fonte da verdade, TaskList nativo, comunicação peer-to-peer, sem nested teams.
Skill	Conhecimento carregável (`/nome-skill`). Em Agent Teams, skills são carregadas do projeto/usuário (o campo `skills:` do frontmatter é ignorado).

Agent Teams vs Subagents: use Agent Teams quando os trabalhadores precisam conversar entre si, dividir um trabalho complexo e se coordenar. Use subagents quando você só quer um worker focado que reporta um resultado de volta.

2. Pré-requisitos e setup

Agent Teams: você não precisa configurar nada. A ativação já vem no pack:
- o *install grava CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 no .claude/settings.json do projeto (via ensure-settings.sh, sem sobrescrever nada que já exista);
- a /team-os confere, no início de cada sessão, se o recurso está ativo de verdade e, se faltar, acrescenta a flag também no ~/.claude/settings.json.
Único cuidado: a flag só vale para sessões abertas depois de ela existir. Se a /team-os avisar que o Agent Teams não está ativo, feche a sessão e abra uma nova (só acontece na primeira vez).
teammateMode (opcional): default "in-process" (todos no terminal principal, agent panel ativo). Use "auto" para split panes em tmux/iTerm2. A /team-os sugere o ajuste.
Agent Teams é experimental e exige plano com suporte ao recurso — ver limitações oficiais.

Requisitos de máquina

Os scripts do pack são bash 3.2-safe (rodam no bash padrão do macOS e no ubuntu do CI) e não dependem de jq.

Ferramenta	Obrigatória?	Quem usa
`bash` 3.2+	Sim	todos os hooks e scripts (`.claude/hooks/`, `team-os/scripts/`, `team-os-creator/scripts/`)
`git`	Sim	hooks de push, `scan-ct-projects.sh`, `test-hooks.sh`
`python3`	Sim (≥ 3.10 para a skill `seo`)	hooks (tokenização via `shlex`, com fallback em grep), `team-os-creator` (`generate-agents-page.py`), `deep-research`, `ui-ux-pro-max`, `seo`
`node`	Opcional	`seo/hooks/run-python-hook.js` (hooks internos da skill `seo`)
`gh` (GitHub CLI)	Opcional	agentes `*-devops` (PRs, releases) e a skill `seo-flow`
Chromium via Playwright	Opcional	skill `seo` (renderização headless) — baixado pelo `setup` dela
`jq`	Não	nenhum script exige (`discovery.sh` e `team-os-session-title.sh` fazem o parse sem ele)

Setup da skill seo (uma vez por máquina, por projeto — ver a seção "Instalação" em .claude/skills/seo/SKILL.md): "${CLAUDE_PROJECT_DIR}/.claude/skills/seo/scripts/claude-seo" setup (ou /seo setup) cria um venv isolado em .claude/skills/seo/.venv/, instala o requirements.txt e baixa o Chromium; /seo doctor diagnostica. Se o python3 da máquina for < 3.10, aponte outro com a variável CLAUDE_SEO_PYTHON — em .claude/settings.local.json (gitignored) ou no ~/.claude/settings.json, nunca no settings.json versionado do projeto. .venv/ e ms-playwright/ são runtime local: ignorados pelo git e nunca copiados pelo *install.

MCPs por squad

Alguns agentes declaram servidores MCP em tools: (fonte da verdade e check do *audit: .claude/skills/team-os-creator/reference/mcp-servers.md). Servidor ausente na máquina não quebra o agente — o Claude Code ignora tools mcp__* não conectadas.

Squad	Agente	Servidor (forma curta em `tools:`)
Social	`social-content`	`mcp__apify` (scraping/research)
Social	`social-design`	`mcp__stitch` (Google Stitch, design generativo)
Social	`social-photo`	`mcp__freepik` (imagens AI)
Social	`social-publisher`	`mcp__meta` (publicação Instagram/Facebook + insights)
Social	`social-video`	`mcp__heygen` (avatar/vídeo AI)
Dev / Sites / PM	`dev-data-engineer`, `dev-bi`, `sites-data`, `pm-data`	`mcp__supabase` (via skill `data-supabase-patterns`)
Traffic	`traffic-google`, `traffic-automation`, `traffic-bi`, `traffic-analyst`, `traffic-qa`	`mcp__google-ads`, `mcp__ga4` / `mcp__analytics-mcp` (via skills `traffic-google-ads-mcp`, `traffic-ga4-mcp`)

Os agentes citam o nível do servidor (mcp__<server>, sem __<tool>), o que libera todas as ferramentas daquele servidor — nomes de tool mudam entre versões, o nome do servidor não. O prefixo depende de como o servidor foi instalado; são três formas:

Origem	Prefixo da tool	Exemplo
`claude mcp add <nome>` / `.mcp.json`	`mcp__<nome>__<tool>`	`mcp__stitch__generate_screen_from_text`
Plugin (`/plugin install`)	`mcp__plugin_<plugin>_<server>__<tool>`	`mcp__plugin_heygen_heygen__create_video`
Conector claude.ai	`mcp__claude_ai_<server>__<tool>`	`mcp__claude_ai_Hey_Gen__create_video_from_avatar`

Credenciais (token, key, project-ref) nunca vão no agente nem na smart-memory — ficam no .mcp.json/env da máquina.

3. Skill principal: `/team-os`

Bootstrap e orquestração de sessão. É distribuída para todos os projetos (instalada junto com a squad) — você a carrega no início de cada sessão do projeto para coordenar múltiplos agentes em paralelo. No CT ela também existe. (A única skill que NÃO vai para os projetos é a /team-os-creator.)

Lead Discipline (regra dura): com /team-os ativo, a sessão principal é orquestrador puro — nunca escreve código, pesquisa ou redige entregável sozinha. Para qualquer ação de trabalho ela spawna um agente e fica livre (monitorando, roteando, sintetizando). 1 tarefa = 1 agente, até as pequenas.

Team Persistence (regra dura): o lead nunca encerra o time sozinho. Terminou uma rodada? Sintetiza, mantém os teammates vivos e pergunta se há mais tasks — só encerra quando você pede. E lembre: linha some do painel após ~30s = idle (agente vivo, não encerrado); reative com SendMessage pelo nome.

O que ela faz, em fases

Scan silencioso — lê settings.json (env + teammateMode), mapeia .claude/agents/, lê docs/smart-memory/INDEX.md, pesa a smart-memory (weigh-memory.sh) e roda TaskList.
Dashboard de abertura — mostra status do ambiente e pergunta o objetivo da sessão.
Correções automáticas — injeta CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS se faltar, sugere teammateMode, oferece bootstrap da smart-memory.
Análise do objetivo — classifica o trabalho (research / implementação / review / mixed) e mapeia o paralelismo real.
Dimensionamento — 1 workstream independente = 1 agente, sem teto fixo: comece com 3-5 e escale conforme a independência real do trabalho (ownership de arquivos disjunto); research adversarial = 3-5 pesquisadores.
Proposta de time — agentes, ownership exclusivo de paths, plan mode onde há risco, skills por agente, modelo sugerido.
Orquestração — cria as tasks no TaskList com dependências e orienta o spawn.

Comandos

/team-os                → bootstrap completo da sessão
/team-os *env           → só verificar/corrigir settings.json
/team-os *memory        → status/bootstrap da smart-memory
/team-os *compact       → compactação integral (mecânica + archivist), 1 confirmação; --auto sem confirmação
/team-os *tasks         → mostrar a task list atual
/team-os *spawn {desc}  → proposta de time para {desc} (pula o scan)
/team-os *status        → dashboard do time atual

Boas práticas que ela aplica

Spawn prompts cirúrgicos (papel + paths de ownership + contexto + entregável + como reportar).
Ownership exclusivo de arquivos — dois agentes nunca no mesmo arquivo.
Plan mode obrigatório em alto risco (schema, auth, CI/CD, refactors grandes, breaking changes).
Não encerrar o time cedo — se o lead "concluir" com tasks abertas, ela orienta a continuar.

4. Skill principal: `/team-os-creator`

Factory de agentes. Existe somente no CT. Gera arquivos .claude/agents/*.md completos (Native Teams Protocol + smart-memory) a partir de 9 archetypes e 11 presets de squad, e mantém os agentes alinhados.

Comandos

/team-os-creator                       → Command Center: escaneia as pastas irmãs, status por projeto, ações Criar / Atualizar / Instalar
/team-os-creator *analyze              → detecta archetype/stack, sem criar
/team-os-creator *squad <preset>       → cria uma squad inteira (dev/sites/social/traffic/pm/sales/brand/finance/legal/seo/security/custom)
/team-os-creator *create <role>        → cria UM agente interativamente
/team-os-creator *migrate              → reinjeta o bloco NTP canônico em todos os agentes (scripts/migrate-ntp.sh; --dry-run mostra o diff)
/team-os-creator *bootstrap            → cria docs/smart-memory/ + injeta protocolo no CLAUDE.md do projeto atual
/team-os-creator *skills <ag>          → enriquece um agente com skills relevantes
/team-os-creator *pressure-test <ag>   → testa o agente contra cenários adversariais (obrigatório para agente novo antes do *propagate)
/team-os-creator *audit                → valida compliance dos agentes (validate-agent.sh) E das skills (validate-agent.sh --skills)
/team-os-creator *update               → atualiza o pack para a versão mais nova sem perder o que você criou ou editou (ver [Instalar e atualizar](#instalar-e-atualizar))
/team-os-creator *propagate            → propaga agentes/skills atualizados para os destinos (sempre --match-target-squads)
/team-os-creator *install              → instala squads + skills (incl. team-os) + settings.json + hooks num projeto destino
/team-os-creator *organize             → árvore negócio → projeto → squads → salas + proposta de organização (só propõe)
/team-os-creator *painel               → mapa vivo do CT no navegador do Claude: squads, agentes (persona + cargo), skills; clique abre perfil e arquivo (127.0.0.1:8788)

Como o *install funciona (scripts/install-to-project.sh):

Squads por categoria — --squads <lista> explícito para projeto novo (--squads all é abortado); --match-target-squads (modo *propagate) deriva as squads do que já existe no destino e nunca re-adiciona squad podada.
Skills derivadas dos agentes — a lista instalada é a união de: skills citadas no body dos agentes instalados, team-os (sempre), --extra-skills, skills com prefixo da squad e as já presentes no destino. --dry-run imprime a origem de cada uma (SKILL_ORIGIN=…). Lixo (.venv, ms-playwright, __pycache__, .DS_Store…) nunca é copiado.
Backup + settings — no *install, se o destino já tinha .claude/, tudo é copiado antes para .claude.bak-<timestamp>/ (guarda só as 3 mais recentes; as antigas vão para a Lixeira) — o *propagate e a Sala de Controle não fazem backup; o settings.json é garantido pelo team-os/scripts/ensure-settings.sh (merge idempotente, nunca sobrescreve valores existentes).
Hooks — o pacote padrão (block-worktree, block-git-push, guard-push-branch, task-quality e os 5 check-*-progress) é sempre instalado; --include-hooks é praticamente no-op.
Sala de Controle — --squads none --extra-skills sala-de-controle|maestri-os copia só a skill de Sala (+ CLAUDE.md mínimo), sem agentes, hooks, settings ou team-os.
Raiz dos projetos destino (scripts/scan-ct-projects.sh): argumento, env CT_ROOT, arquivo .team-os-root na raiz do CT (gitignored) ou o diretório pai do git root.

Os 9 archetypes

Archetype	Quando usar	Model	Effort
`architect`	Design arquitetural, ADRs, stories	`opus`	`high`
`strategist`	Tese/postura/política e gate de aprovação — decide, nunca produz a peça	`opus`	`high`
`reviewer`	QA com veredicto formal, read-only em código	`opus`	`high`
`implementer`	Escreve código (front/back/fullstack)	`inherit`	omitido
`hardening`	Resiliência, retry, edge cases (após features)	`inherit`	`high`
`researcher`	Pesquisa técnica, libs, CVEs	`inherit`	`medium`
`data`	Schema, migrations, queries, RLS	`inherit`	`high`
`devops`	Git, push, PRs, CI/CD, releases	`inherit`	omitido
`ux`	UX research, component specs, a11y	`inherit`	`medium`

Não existe archetype de lead/orquestrador — a main session já é o lead nativo (regra absoluta da skill). Nenhum archetype usa isolation (worktrees são bloqueados pelo block-worktree.sh). Defaults completos em .claude/skills/team-os-creator/reference/archetypes.md; templates em templates/.

Regras absolutas da factory

Nunca cria agente sem memory: project.
Sempre injeta o bloco Native Teams Protocol (nunca o antigo "Contrato com team-os").
Sempre valida com validate-agent.sh após criar.
Idempotente — se o agente existe, oferece atualizar / pular / renomear / cancelar.
*install entrega a infra, não a smart-memory: copia agentes + skills (incluindo team-os) + settings.json + hooks. A smart-memory é construída no destino pelo próprio /team-os na 1ª sessão (Discovery Engine); *bootstrap continua disponível para criação manual.
team-os é distribuída a todos os projetos (obrigatória no destino); só o team-os-creator fica no CT.
Skills de Sala de Controle (sala-de-controle, maestri-os) são opt-in: só via *install --squads none --extra-skills; onde já estão instaladas, o *propagate as mantém atualizadas.

5. Os 102 agentes e suas skills

Spawne pelo nome do arquivo, ex.: "Spawn um teammate usando o agente dev-architect para mapear a arquitetura de auth".

A coluna Skills relacionadas é um mapa de skills recomendadas/disponíveis por papel — as skills de apoio que fazem sentido para cada agente acionar via /nome-skill conforme a necessidade. Ela não reflete linha a linha o que o body de cada agente lista (vários agentes citam só um subconjunto, ou nenhuma, no próprio arquivo); serve como guia de qual skill ativar para qual tipo de trabalho. O /team-os pode incluí-las no spawn prompt.

Nota sobre veredictos QA: todas as squads com QA dedicado (dev, sites, traffic, sales, brand, finance, legal, seo, security) usam PASS/CONCERNS/FAIL/WAIVED. Duas exceções deliberadas em contexto PT-BR — pm-qa: APROVADO/PENDÊNCIAS/REPROVADO; social-strategist: APROVADO/COM RESSALVAS/REJEITADO (a squad social não tem QA dedicado — a VERA acumula validação editorial + veredicto).

Dev — Fullstack SaaS (12)

Sem teto de tamanho por squad — a dev inclui a camada completa de dados/BI (dev-bi, dev-data-engineer, dev-data-performance), chegando a 12. | Agente | Papel | Skills relacionadas | |---|---|---| | dev-analyst | Pesquisa técnica, libs, CVEs, feasibility | /deep-research, /data-analytics-engineering | | dev-architect | Arquitetura, ADRs, criação/validação de stories (exclusivo) | /dev-api-design, /dev-technical-writing, /dev-database-patterns | | dev-bi | Data architect & dashboards (SELECT-only) | /data-analytics-engineering, /data-sql-optimization, /data-lake-platform | | dev-data-engineer | Schema, migrations, RLS, otimização | /dev-database-patterns, /data-sql-optimization, /dev-security-patterns | | dev-data-performance | Insights, anomalias, forecasts | /data-analytics-engineering, /ai-ml-data-science, /ai-ml-timeseries | | dev-ux | UX research + design visual + a11y | /ui-ux-pro-max, /accessibility, /web-design-guidelines | | dev-dev-alpha | Frontend (React, Next.js, Tailwind) | /dev-typescript-patterns, /dev-testing-strategy, /dev-error-handling | | dev-dev-beta | Backend (APIs, serviços, lógica) | /dev-api-design, /dev-error-handling, /dev-database-patterns | | dev-dev-gamma | Fullstack / cross-layer | /dev-typescript-patterns, /dev-database-patterns, /dev-error-handling | | dev-dev-delta | Hardening e resiliência | /dev-security-patterns, /dev-testing-strategy, /dev-error-handling | | dev-qa | Veredictos PASS/CONCERNS/FAIL/WAIVED (exclusivo) | /dev-testing-strategy, /dev-security-patterns | | dev-devops | git push, PRs, CI/CD, releases (exclusivo) | /dev-git-workflow |

Sites — Sites e landing pages (10)

Duas stacks, uma squad: Next.js (App Router) ou Astro (Content Collections, Islands Architecture) — o sites-architect decide qual usar por projeto (ou um híbrido das duas), registrado como ADR. /sites-frontend-stack e /sites-seo-technical cobrem as duas stacks lado a lado, com a mesma profundidade. Astro é a recomendação padrão quando SEO/Core Web Vitals são a prioridade — HTML puro por padrão, JS só onde uma ilha pede explicitamente.

Agente	Papel	Skills relacionadas
`sites-analyst`	Keyword/competitor research, feasibility	`/deep-research`, `/sites-seo-keywords`
`sites-architect`	Arquitetura de páginas, stories (exclusivo)	`/dev-api-design`, `/dev-technical-writing`, `/sites-seo-technical`
`sites-data`	Schema, migrations, RLS (sites)	`/dev-database-patterns`, `/data-sql-optimization`, `/dev-security-patterns`
`sites-ux`	UX research + design visual + a11y	`/sites-ux-interaction`, `/ui-ux-pro-max`, `/accessibility`, `/sites-frontend-stack`
`sites-dev-alpha`	Frontend / landing pages (shadcn)	`/sites-frontend-stack`, `/sites-scroll-motion`, `/ui-ux-pro-max`, `/nextjs-react-best-practices`, `/verify-before-done`
`sites-dev-beta`	Backend / CMS / integrações	`/dev-api-design`, `/dev-error-handling`, `/dev-database-patterns`
`sites-dev-gamma`	CRO, SEO, analytics, fullstack	`/sites-page-cro`, `/sites-seo-technical`, `/dev-typescript-patterns`
`sites-dev-delta`	Hardening, Core Web Vitals	`/dev-security-patterns`, `/dev-error-handling`, `/accessibility`, `/verify-before-done`
`sites-qa`	QA: a11y, SEO, copy, performance, segurança	`/dev-security-patterns`, `/dev-testing-strategy`, `/testing-playwright-e2e`, `/web-design-guidelines`, `/sites-seo-technical`, `/accessibility`, `/sites-copy`, `/verify-before-done`
`sites-devops`	Deploy Vercel/Netlify, CI/CD	`/dev-git-workflow`, `/sites-deployment`

Social — Social media (6)

Agente	Persona	Papel	Skills relacionadas
`social-content`	LYRIS	Research (Apify) + copywriting	`/social-copywriting`, `/social-scriptwriting`, `/social-editorial-validation`, `/social-format-specs`, `/social-apify-research`
`social-design`	AEON	Key visuals, carrosséis (Stitch)	`/social-key-visual`, `/social-carousel-design`, `/social-stitch-workflow`
`social-photo`	IRIS	Fotos AI (Freepik)	`/social-freepik-generation`, `/social-cinematic-composition`
`social-publisher`	PULSE	Publicação (Meta) + métricas	`/social-meta-publishing`, `/social-analytics`
`social-strategist`	VERA	Estratégia + validação editorial (gate)	`/social-editorial-validation`, `/social-format-specs`
`social-video`	FLUX	Reels/Stories/Shorts (ffmpeg) + vídeo com avatar AI (HeyGen)	`/social-video-editing`, `/social-heygen-avatar`, `/social-scriptwriting`, `/social-cinematic-composition`

Regra do squad Social: social-publisher só publica após aprovação da social-strategist (VERA) e confirmação explícita do usuário.

Traffic — Tráfego pago (10)

Agente	Papel	Skills relacionadas
`traffic-analyst`	Audiências, concorrência, benchmarks	`/deep-research`, `/social-analytics`, `/traffic-google-ads-mcp`, `/traffic-ga4-mcp`
`traffic-automation`	Bulk ops, APIs Google/Meta/TikTok	`/dev-api-design`, `/dev-error-handling`, `/traffic-google-ads-mcp`, `/traffic-analytics-tracking`
`traffic-bi`	Atribuição, ROAS/LTV/CPA (fonte de verdade)	`/data-analytics-engineering`, `/data-sql-optimization`, `/traffic-ga4-mcp`, `/traffic-google-ads-mcp`, `/traffic-analytics-tracking`
`traffic-copywriter`	Copy de anúncios, variantes A/B	`/social-copywriting`, `/tiktok-marketing`, `/traffic-paid-ads-optimization`
`traffic-designer`	Criativos (banners, carrosséis, vídeos)	`/social-key-visual`, `/social-carousel-design`, `/ui-ux-pro-max`
`traffic-google`	Google Ads (Search, PMax, Shopping, YT)	`/social-analytics`, `/traffic-google-ads-mcp`, `/traffic-ga4-mcp`, `/traffic-paid-ads-optimization`
`traffic-meta`	Meta Ads (FB + IG, Advantage+)	`/social-meta-publishing`, `/social-analytics`, `/traffic-paid-ads-optimization`
`traffic-qa`	Compliance pré-launch (UTMs, pixels)	`/dev-testing-strategy`, `/traffic-analytics-tracking`, `/traffic-ga4-mcp`, `/traffic-google-ads-mcp`
`traffic-strategist`	Briefings + stories de campanha (exclusivo)	`/deep-research`, `/tiktok-marketing`, `/traffic-paid-ads-optimization`, `/traffic-ga4-mcp`
`traffic-tiktok`	TikTok Ads (Spark, In-Feed, TopView)	`/tiktok-marketing`, `/social-format-specs`, `/traffic-paid-ads-optimization`

PM — Gestão de projetos (10, personas Kaelthari)

Agente	Persona	Papel	Skills relacionadas
`pm-analyst`	Serak	Inteligência de portfólio (carga, risco)	`/data-analytics-engineering`, `/data-sql-optimization`
`pm-client`	Eshara	Camada de cliente (acesso, churn)	`/dev-technical-writing`
`pm-coach`	Aevon	Metodologias / Scrum Master	—
`pm-data`	Nexar	Banco (único com Supabase CLI)	`/dev-database-patterns`, `/data-sql-optimization`
`pm-demand`	Draketh	Intake de demandas	`/dev-technical-writing`
`pm-engineer`	Faelor	Templates de processo / flows	`/dev-technical-writing`
`pm-ops`	Varek	Operações diárias (status, subtasks)	—
`pm-planner`	Zynath	Sprints, roadmap, capacidade	`/data-analytics-engineering`
`pm-qa`	Thyron	Auditor formal de entregas	—
`pm-reporter`	Lyrith	Meeting intelligence (dailies, retros)	`/dev-technical-writing`, `/deep-research`

Sales — Propostas e apresentações (8, personas olímpicas)

Squad genérica: o método (intake → tese → planejamento → números → copy ∥ design → QA → envio) é do CT; o contexto da empresa — catálogo de ofertas e preços (project/offer-catalog.md), marca e design system (project/brand.md), convenção de pastas e versões (project/conventions.md) — vive na smart-memory do projeto e é preenchido com o usuário, nunca inventado. Dois gates: ATHENA aprova o plano (7 pontos) antes da produção; ARGUS aprova o artefato (12 pontos) antes do envio. Sem devops: enviar ao cliente é ato do usuário, e o hook check-proposal-progress.sh só fecha task de envio com PASS + confirmação explícita.

Agente	Persona	Papel	Skills relacionadas
`sales-analyst`	ATLAS	Intake de reunião + pesquisa de cliente/setor/benchmarks, tudo com fonte	`/sales-discovery-intake`, `/deep-research`, `/dev-defuddle`, `/verify-before-done`
`sales-strategist`	ATHENA	Tese do negócio, enquadramento, postura de negociação, gate do planejamento (exclusivo)	`/negotiation`, `/sales-pricing-payback`, `/pricing`, `/sales-enablement`
`sales-planner`	DAEDALUS	Story da proposta + planejamento interno de 9 seções + estrutura página a página (exclusivo)	`/sales-proposal-planning`, `/sales-discovery-intake`, `/dev-technical-writing`, `/sales-enablement`
`sales-finance`	LIBRA	Fonte única dos números: preço vs. tabela, desconto/breakeven, payback, permuta, BP, valuation	`/sales-pricing-payback`, `/startup-financial-modeling`, `/pricing`, `/verify-before-done`
`sales-copywriter`	CALLIOPE	Texto página a página — voz declarativa, compromisso conjunto, número só com `#id` da ficha	`/sales-proposal-copy`, `/sales-enablement`, `/sites-copy`, `/sales-proposal-planning`
`sales-designer`	HELIOS	PDF e deck no design system do projeto — HTML + print CSS → export headless → checagem	`/sales-deck-production`, `/slides`, `/presentation-design`, `/ui-ux-pro-max`, `/verify-before-done`
`sales-qa`	ARGUS	Veredictos PASS/CONCERNS/FAIL/WAIVED sobre o artefato — 12 pontos (exclusivo)	`/sales-proposal-copy`, `/sales-deck-production`, `/presentation-design`, `/verify-before-done`
`sales-closer`	PEITHO	Brief de reunião, follow-up, ledger de propostas, envio só com PASS + confirmação do usuário	`/negotiation`, `/sales-enablement`, `/sales-proposal-copy`, `/verify-before-done`

Brand — Reposicionamento de marca (8, personas estelares)

Squad genérica: o método (auditoria → plataforma → arquitetura e stories → voz ∥ visual → QA → baseline → rollout → leitura do depois) é do CT; o contexto da marca — histórico, ofertas, públicos, ativos, motivo do reposicionamento (project/brand-context.md) — vive na smart-memory do projeto e é preenchido com o usuário, nunca inventado. Define e guarda a marca, não executa canal: site, social, tráfego e propostas seguem com as squads deles, que recebem o kit de handoff em project/brand.md. Dois gates: POLARIS aprova a plataforma (7 pontos, com o usuário) e escolhe a direção entre ≥2 opções; RIGEL aprova cada deliverable (10 pontos) antes de virar lei para as outras squads. Sem devops: a virada externa exige PASS + baseline travada + confirmação explícita do usuário.

Agente	Persona	Papel	Skills relacionadas
`brand-analyst`	SIRIUS	Auditoria da marca atual, mapa de concorrentes e territórios, públicos na linguagem deles — tudo com fonte	`/brand-research`, `/deep-research`, `/dev-defuddle`, `/verify-before-done`
`brand-strategist`	POLARIS	Plataforma de marca, postura do reposicionamento, gate da plataforma e escolha de direção (exclusivo)	`/brand-platform`, `/brand-research`, `/pricing`, `/verify-before-done`
`brand-architect`	ORION	Arquitetura de marca (marca-mãe, sub-marcas, marca pessoal, nomes), roadmap de migração, stories (exclusivo)	`/brand-platform`, `/dev-technical-writing`, `/brand-rollout`, `/verify-before-done`
`brand-voice`	LYRA	Guia de voz, framework de mensagens, manifesto, tagline, glossário, nomes dentro do sistema — ≥2 opções de direção	`/brand-verbal-identity`, `/sites-copy`, `/brand-platform`, `/verify-before-done`
`brand-designer`	AURORA	Direções visuais com opções, sistema de cor/tipo/grid/imagem, brandbook — via Claude Design	`/brand-visual-system`, `/ui-ux-pro-max`, `/web-design-guidelines`, `/social-key-visual`, `/verify-before-done` (plugin `design:*` opcional)
`brand-insights`	VEGA	Fonte única dos números da marca: scorecard, baseline antes, leitura depois, ficha com `#id`	`/brand-tracking`, `/data-analytics-engineering`, `/social-analytics`, `/verify-before-done`
`brand-rollout`	ALTAIR	Plano interno → externo, inventário e desligamentos, checklist por canal, kit de handoff — só com PASS + baseline + confirmação	`/brand-rollout`, `/brand-verbal-identity`, `/brand-visual-system`, `/verify-before-done`
`brand-qa`	RIGEL	Veredictos PASS/CONCERNS/FAIL/WAIVED sobre cada deliverable — 10 pontos (exclusivo); auditoria de consistência pós-virada	`/brand-verbal-identity`, `/brand-visual-system`, `/brand-platform`, `/verify-before-done`

Finance — Gestão financeira (8, personas fluviais)

Squad genérica: o método (coleta com documento → política e orçamento → plano de caixa e stories → lançamento e conciliação → contas a pagar/receber preparadas → fiscal preparado → relatório com #id → QA → execução pelo humano) é do CT; o contexto da empresa — entidades e contas por alias, regime tributário, contador, ciclo de fechamento, política (project/finance-context.md, project/finance-policy.md) — vive na smart-memory do projeto e é preenchido com o usuário. A squad prepara, registra e confere; nunca move dinheiro nem declara ao fisco. Dois gates: AMAZONAS aprova orçamento e plano de caixa (7 pontos); TIGRE aprova fechamento, lote, cobrança, apuração e relatório (12 pontos). O hook check-finance-progress.sh só fecha task de pagamento, cobrança, nota, guia ou relatório enviado com PASS + confirmação explícita do usuário. Dado sensível (conta, chave PIX, CPF/CNPJ de terceiro) nunca entra na smart-memory — só alias.

Agente	Persona	Papel	Skills relacionadas
`finance-analyst`	NILO	Coleta e classificação de documentos do período, benchmarks, tarifas e índices — toda cifra com documento ou fonte datada	`/finance-bookkeeping`, `/deep-research`, `/dev-defuddle`, `/verify-before-done`
`finance-strategist`	AMAZONAS	Política financeira (margem, reserva, alçadas, prioridade, distribuição), gate do orçamento e do plano de caixa (exclusivo)	`/finance-cash-flow`, `/finance-reporting`, `/startup-financial-modeling`, `/pricing`, `/verify-before-done`
`finance-planner`	DANUBIO	Orçamento, plano de caixa 13 semanas, forecast com cenários, roadmap — stories `F{N}` (exclusivo)	`/finance-cash-flow`, `/finance-reporting`, `/startup-financial-modeling`, `/dev-technical-writing`, `/verify-before-done`
`finance-controller`	GANGES	Fonte única dos números: plano de contas, conciliação item a item, DRE gerencial, fechamento com `#id`	`/finance-bookkeeping`, `/finance-cash-flow`, `/data-analytics-engineering`, `/verify-before-done`
`finance-billing`	TEJO	Cobranças e régua de inadimplência, agenda e lotes de pagamento preparados — prepara, nunca executa	`/finance-receivables-payables`, `/finance-bookkeeping`, `/negotiation`, `/verify-before-done`
`finance-tax`	RENO	Calendário de obrigações, apuração preparatória com regra e fonte, pacote para o contador — não declara nem recolhe	`/finance-tax-compliance`, `/finance-bookkeeping`, `/deep-research`, `/verify-before-done`
`finance-reporter`	SENA	Relatório mensal para sócios, indicadores, relatório para investidor e banco — só com `#id` do fechamento FECHADO	`/finance-reporting`, `/finance-cash-flow`, `/dev-technical-writing`, `/verify-before-done`
`finance-qa`	TIGRE	Veredictos PASS/CONCERNS/FAIL/WAIVED sobre fechamento, lote, cobrança, apuração e relatório — 12 pontos (exclusivo)	`/finance-bookkeeping`, `/finance-receivables-payables`, `/finance-reporting`, `/verify-before-done`

Legal — Jurídico do dia a dia (8, personas latinas)

Squad genérica: o método (pesquisa com fonte primária → postura jurídica → arquitetura documental e stories → minuta com desvios marcados → registro de prazos e LGPD → conflitos preparados → QA → envio/assinatura pelo humano) é do CT; o contexto da empresa — tipo societário, jurisdição, advogado e contador por alias, apetite a risco, contratos vigentes (project/legal-context.md, project/legal-posture.md) — vive na smart-memory do projeto. A squad prepara, organiza e confere; não substitui advogado — parecer, assinatura de peça e protocolo são do advogado inscrito; envio e assinatura são do usuário. Dois gates: PRUDENTIA aprova a postura de cada minuta e notificação (7 pontos); IUSTITIA aprova o documento (12 pontos). O hook check-legal-progress.sh só fecha task de envio, assinatura, protocolo ou publicação com PASS + confirmação explícita do usuário.

Agente	Persona	Papel	Skills relacionadas
`legal-analyst`	VERITAS	Lei, jurisprudência, doutrina e precedentes internos — fonte primária com artigo/acórdão e data; achado ≠ leitura ≠ parecer	`/legal-research`, `/deep-research`, `/dev-defuddle`, `/verify-before-done`
`legal-strategist`	PRUDENTIA	Postura jurídica (apetite a risco, inegociáveis, negociáveis com piso/teto, foro, conflito), gate de minuta e notificação (exclusivo)	`/legal-contract-drafting`, `/legal-research`, `/negotiation`, `/verify-before-done`
`legal-architect`	LEX	Arquitetura documental, sistema de modelos `M{N}` versionado, hierarquia contrato-mãe/anexos/aditivos — stories `L{N}` (exclusivo)	`/legal-clause-library`, `/legal-contract-lifecycle`, `/dev-technical-writing`, `/verify-before-done`
`legal-drafter`	CONCORDIA	Contratos, aditivos, distratos, NDAs, termos e políticas a partir do modelo e da postura, com matriz de desvios — nunca envia	`/legal-contract-drafting`, `/legal-clause-library`, `/legal-research`, `/verify-before-done`
`legal-compliance`	FIDES	Fonte única de prazos e obrigações: registro de contratos com `#id`, mapa de dados com base legal, consentimentos, incidentes	`/legal-compliance-lgpd`, `/legal-contract-lifecycle`, `/data-analytics-engineering`, `/verify-before-done`
`legal-disputes`	CLEMENTIA	Notificação, cobrança extrajudicial, acordo, distrato e dossiê para o advogado — prepara, nunca envia nem ameaça	`/legal-contract-lifecycle`, `/legal-research`, `/negotiation`, `/verify-before-done`
`legal-ops`	AEQUITAS	Versão travada, assinatura, arquivamento, registro, renovações — envio só com PASS + confirmação	`/legal-contract-lifecycle`, `/legal-clause-library`, `/dev-technical-writing`, `/verify-before-done`
`legal-qa`	IUSTITIA	Veredictos PASS/CONCERNS/FAIL/WAIVED sobre minuta, notificação, política e dossiê — 12 pontos (exclusivo)	`/legal-contract-drafting`, `/legal-clause-library`, `/legal-compliance-lgpd`, `/verify-before-done`

SEO — Auditoria e otimização de busca (15, personas egípcias)

Squad genérica: motor é o pacote claude-seo v2.3.1 (MIT, AgriciDaniel) incorporado ao CT — 27 skills e o runtime Python em .claude/skills/seo/ (/seo setup cria o ambiente isolado + Chromium na primeira vez; /seo doctor diagnostica). Audita, prioriza e recomenda; nunca implementa o fix nem sobe deploy — o handoff vai para a squad Sites via smart-memory. Dois gates: THOTH sequencia o roadmap com checklist de 5 pontos (achado rastreável · observação · dependência · critério de aceite · falseamento + indicador); MAAT aprova cada auditoria/relatório antes de virar story ou chegar ao cliente. SESHAT é fonte única dos números (GSC/PageSpeed/CrUX/GA4/Bing) — nenhum dado de campo ou estimativa entra sem #id dela; campo sempre vence laboratório, e FID (aposentado em 2024) nunca é citado — a métrica de interatividade é INP. Pressure-tested: 9/9 cenários limpos (THOTH, MAAT, SESHAT).

Agente	Persona	Papel	Skills relacionadas
`seo-architect`	THOTH	Roadmap e stories de SEO, checklist de 5 pontos (exclusivo)	`/seo-plan`, `/seo-audit`, `/seo-flow`, `/dev-technical-writing`
`seo-technical`	PTAH	SEO técnico — 9 categorias (rastreabilidade, indexação, segurança, CWV, JS, IndexNow)	`/seo-technical`, `/seo-page`, `/sites-seo-technical`
`seo-content`	NEITH	E-E-A-T, conteúdo raso, citabilidade por IA, briefs, limpeza de última milha	`/seo-content`, `/seo-content-brief`, `/seo-image-gen`, `/sites-copy`
`seo-schema`	KHNUM	Detecção, validação e geração de Schema.org (JSON-LD)	`/seo-schema`, `/seo-technical`
`seo-sitemap`	GEB	Sitemap XML, hreflang/i18n, SEO programático em escala	`/seo-sitemap`, `/seo-hreflang`, `/seo-programmatic`
`seo-performance`	SHU	Core Web Vitals (LCP/INP/CLS), subpartes de LCP, renderização e visual	`/seo-technical`, `/seo-images`, `/nextjs-react-best-practices`
`seo-geo`	NUT	GEO/AI search — crawlers de IA, llms.txt, citabilidade por passagem	`/seo-geo`, `/seo-content`
`seo-sxo`	HORUS	SERP ao contrário, user stories, páginas de comparação	`/seo-sxo`, `/seo-competitor-pages`, `/sites-page-cro`
`seo-cluster`	HEKA	Clustering semântico por sobreposição real de SERP, hub-and-spoke	`/seo-cluster`, `/seo-content-brief`, `/sites-seo-keywords`
`seo-local`	BASTET	GBP, NAP, citações, avaliações, multi-localidade, geo-grid	`/seo-local`, `/seo-maps`
`seo-backlinks`	ANUBIS	Perfil de links multi-fonte com peso por confiança, verificação obrigatória	`/seo-backlinks`, `/seo-ahrefs`, `/seo-dataforseo`
`seo-ecommerce`	HAPI	Schema de produto, Google Shopping, marketplace, catálogo	`/seo-ecommerce`, `/seo-schema`, `/seo-images`
`seo-google`	SESHAT	Fonte única dos números: GSC, PageSpeed, CrUX, Indexing API, GA4	`/seo-google`, `/seo-bing`, `/data-analytics-engineering`
`seo-drift`	WADJET	Baseline e comparação — detecção de regressão pós-deploy	`/seo-drift`, `/seo-technical`
`seo-qa`	MAAT	Veredictos PASS/CONCERNS/FAIL/WAIVED sobre auditoria/relatório (exclusivo)	`/seo-audit`, `/seo-technical`, `/seo-content`

Security — Segurança de aplicação (7, personas nórdicas)

Squad add-on de projetos com código (--squads sites,security ou dev,security): audita, prioriza e especifica a correção — nunca edita o código (dev/sites corrige), nunca rotaciona credencial nem executa contenção em produção (usuário/devops) e nunca testa contra terceiro (teste ativo só em local/staging com escopo escrito). Régua comum em /security-audit-method: severidade, formato de achado SEC-{NN}, nunca expor valor de segredo, "resolvido" só com nova varredura, CRITICAL nunca aceito como risco. Método adaptado de agency-agents (MIT). O detect-project-signals.sh sugere a squad quando o projeto tem banco, auth, pagamento ou IA.

Agente	Persona	Papel	Skills relacionadas
`security-architect`	MIMIR	Modelos de ameaça, stories de segurança e ordem de correção (exclusivo)	`/security-threat-modeling`, `/security-audit-method`, `/dev-security-patterns`
`security-appsec`	HEIMDALL	Autorização (IDOR), entrada, sessão, headers, dependências, webhooks	`/security-audit-method`, `/dev-security-patterns`, `/dev-api-design`
`security-ai-code`	HUGIN	Código gerado por IA e apps com LLM — segredos (inclusive no histórico do git), RLS, injeção de prompt, tools sem confirmação	`/dev-security-patterns`, `/security-audit-method`, `/data-supabase-patterns`
`security-secrets`	VÁR	Fonte única do inventário de credenciais e roteiros de rotação — nunca toca no valor	`/security-audit-method`, `/security-incident-response`, `/dev-security-patterns`
`security-privacy`	FRIGG	Fonte única do mapa técnico de dados pessoais — onde mora, quem lê, retenção, exclusão	`/security-privacy-data-map`, `/security-audit-method`, `/data-supabase-patterns`
`security-incident`	VIDAR	Registro e coordenação de incidente — SEV, linha do tempo, evidência, post-mortem	`/security-incident-response`, `/security-audit-method`
`security-qa`	FORSETI	Veredictos PASS/CONCERNS/FAIL/WAIVED sobre auditorias e fechamento de achados (exclusivo)	`/security-audit-method`, `/dev-security-patterns`, `/verify-before-done`

6. Catálogo de skills de apoio

Catálogo por área

112 skills, todas diretórios reais e versionados (repositório self-contained).

Dev (9): dev-api-design, dev-database-patterns, dev-defuddle, dev-error-handling, dev-git-workflow, dev-security-patterns, dev-technical-writing, dev-testing-strategy, dev-typescript-patterns

Data & ML (6): ai-ml-data-science, ai-ml-timeseries, data-analytics-engineering, data-lake-platform, data-sql-optimization, data-supabase-patterns

Sites (9): sites-canvas-design, sites-copy, sites-deployment, sites-frontend-stack, sites-page-cro, sites-scroll-motion, sites-seo-keywords, sites-seo-technical, sites-ux-interaction

Fusões 2026-09: sites-copy absorve content-strategy + copywriting + copy-editing; sites-frontend-stack absorve frontend-design + tailwind-design-system + shadcn-ui; sites-web-accessibility foi absorvida por accessibility (WCAG 2.2).

Social (14): social-analytics, social-apify-research, social-carousel-design, social-cinematic-composition, social-copywriting, social-editorial-validation, social-format-specs, social-freepik-generation, social-heygen-avatar, social-key-visual, social-meta-publishing, social-scriptwriting, social-stitch-workflow, social-video-editing

Traffic (4): traffic-paid-ads-optimization, traffic-analytics-tracking, traffic-google-ads-mcp, traffic-ga4-mcp

Sales (6): sales-discovery-intake, sales-proposal-planning, sales-pricing-payback, sales-proposal-copy, sales-deck-production, sales-enablement

Brand (6): brand-research, brand-platform, brand-verbal-identity, brand-visual-system, brand-tracking, brand-rollout

Finance (5): finance-cash-flow, finance-bookkeeping, finance-receivables-payables, finance-tax-compliance, finance-reporting

Legal (5): legal-research, legal-contract-drafting, legal-clause-library, legal-compliance-lgpd, legal-contract-lifecycle

SEO (27, incorporado do pacote claude-seo v2.3.1, MIT): seo (orquestradora + runtime Python em scripts/, schema/, data/, pdf/), seo-audit, seo-page, seo-plan, seo-technical, seo-content, seo-content-brief, seo-schema, seo-sitemap, seo-hreflang, seo-programmatic, seo-images, seo-image-gen, seo-geo, seo-sxo, seo-competitor-pages, seo-cluster, seo-local, seo-maps, seo-backlinks, seo-ahrefs, seo-ecommerce, seo-google, seo-bing, seo-drift, seo-dataforseo, seo-flow

Security (4): security-audit-method, security-threat-modeling, security-incident-response, security-privacy-data-map

Design & geral (13): ui-ux-pro-max, web-design-guidelines, accessibility, deep-research, tiktok-marketing, nextjs-react-best-practices, testing-playwright-e2e, verify-before-done, negotiation, pricing, slides, presentation-design, startup-financial-modeling

Novas (adaptadas do registry skills.sh, auditadas): nextjs-react-best-practices (Vercel — performance React/Next para devs de dev/sites), data-supabase-patterns (Supabase — Postgres/RLS/indexing para data engineers), testing-playwright-e2e (E2E para os QAs), traffic-paid-ads-optimization e traffic-analytics-tracking (marketingskills — para strategist/copywriter/bi/qa da traffic), verify-before-done (superpowers — gate de verificação antes de declarar "pronto", uso geral de todos os agentes).

Novas 2026-09 (squad Brand): autorais do CT, todas com templates Obsidian — brand-research (auditoria, mapa de territórios, públicos), brand-platform (plataforma + gate de 7 pontos + arquitetura de marca), brand-verbal-identity (dimensões de tom, dizemos/não dizemos, mensagens, manifesto, naming), brand-visual-system (cor com papel e contraste, tipo, grid, imagem, brandbook via Claude Design), brand-tracking (scorecard, baseline, leitura do depois, ficha com #id), brand-rollout (pré-condições, fases, checklist por canal, kit de handoff brand.md).

Novas 2026-09 (squads Finance e Legal): autorais do CT, com templates Obsidian — finance-cash-flow (plano de caixa 13 semanas, forecast, runway), finance-bookkeeping (plano de contas, conciliação, fechamento com #id), finance-receivables-payables (régua de cobrança, aging, lote de pagamento preparado), finance-tax-compliance (calendário fiscal, apuração preparatória, pacote para o contador; reference/brasil.md sem alíquotas cravadas), finance-reporting (relatório mensal, dicionário de indicadores); legal-research (fonte primária, achado ≠ parecer; reference/fontes-brasil.md), legal-contract-drafting (anatomia em 15 blocos, matriz de desvios, revisão da contraparte), legal-clause-library (modelos M{N}.{c}, variantes com piso/teto), legal-compliance-lgpd (mapa de dados, bases legais, incidentes), legal-contract-lifecycle (registro, assinatura travada por hash, notificação, dossiê).

Nova 2026-09-25 (Sala de Controle): sala-de-controle — autoral do CT, o lugar único de comando para as sessões do Claude Code (scripts/refresh.py junta scan-sessions.py + session-tail.py + project-context.py + org-map.py, todos read-only; templates de panorama/registro/histórico/organização; *painel = mapa vivo em scripts/painel/ — collect.py + serve.py + index.html, servidor local em 127.0.0.1:8787 aberto no navegador do Claude). Coexiste com a maestri-os; só entra via --squads none --extra-skills sala-de-controle.

Nova 2026-09 (Sala de Controle, modo Maestri): maestri-os — autoral do CT, recurso opt-in para o Maestri (roteador de pedidos entre terminais; scripts/scan-project.sh read-only + templates de registro/compilado/histórico). Não pertence a squad; só entra via --squads none --extra-skills maestri-os.

Novas 2026-09 (squad Sales): autorais do CT — sales-discovery-intake, sales-proposal-planning, sales-pricing-payback, sales-proposal-copy, sales-deck-production (com html-to-pdf.mjs e check-pdf.sh); adotadas do registry após vetting — sales-enablement e pricing (marketingskills), startup-financial-modeling (wshobson), negotiation (wondelai — framework Voss), slides (nextlevelbuilder, mesmo autor do ui-ux-pro-max), presentation-design (jwynia). Descartadas no vetting: proposal-writer (template raso com número inventado), html-slides/meeting-notes (frontmatter quebrado), html-to-pdf (abaixo do corte — abordagem incorporada em sales-deck-production).

Nova 2026-09 (squad SEO): pacote externo claude-seo v2.3.1 (MIT, AgriciDaniel) incorporado 100% ao CT — as 25 skills do core + seo-ahrefs e seo-bing (mirrors de extensão), com o runtime Python (58 scripts: GSC, PageSpeed, CrUX, GA4, Playwright, geração de schema, drift) reidratado em .claude/skills/seo/scripts/ e reescrito para rodar via ${CLAUDE_PROJECT_DIR} em vez de ${CLAUDE_PLUGIN_ROOT} (não é plugin, é skill do CT). seo-flow, seo-dataforseo e seo-image-gen entram como skill mas sem agente dedicado — seo-flow é framework de prompt, os outros dois dependem de MCP pago (DataForSEO, Gemini/nanobanana) ainda não autorizado. Os 15 agentes (personas egípcias) e a autoria do preset/bodies são do CT — pressure-tested 9/9.

Orquestração: team-os (distribuída a todos os projetos — obrigatória para rodar /team-os em cada sessão) · team-os-creator (exclusiva do CT — a única que não vai para os projetos) · sala-de-controle e maestri-os (opt-in, só em Salas de Controle — ver abaixo).

Sala de Controle — `sala-de-controle` (sessões do Claude Code)

O lugar único para dar comando: uma pasta própria — <raiz>/1 | Sala de Controle, uma só para todos os negócios —, sem agentes e sem team-os. Você fala em português normal (simples ou composto: "destrava o deploy do site, cria um post sobre o depoimento e me traz o relatório de leads"); a skill descobre qual projeto e qual sessão cuidam de cada parte, confirma o plano e despacha.

Relê tudo a cada chamada (refresh.py, ≈2 s): todas as sessões do Claude abertas na máquina (registro ~/.claude/sessions/ + claude agents --json, sem as sessões "fantasma" pré-aquecidas), o que cada uma está fazendo (últimas falas) e a etapa de cada projeto pela smart-memory dele — ledger da sessão → stories → _inbox/ → DIGEST → overview.
Nome padrão das sessões: <NOME DA PASTA> | <Título> (ex.: João Guirunas | Site | Home). O hook team-os-session-title.sh preserva esse padrão ao retomar a sessão.
Projeto sem sessão aberta → pergunta e abre uma (claude --bg -n "<PASTA> | <Título>"), que fica aberta para os próximos pedidos (claude attach <id> para entrar nela).
Despacho por mensagem entre sessões (SendMessage), com cabeçalho que pede o retorno para a Sala; autopilot no retorno (segue sozinha para a parte dependente), para só em DECISÃO: do usuário.
Organização: /sala-de-controle *organizar mostra a árvore negócio → projeto → squads, o que está fora do padrão e a proposta de melhoria — só propõe; quem move é o usuário, quem instala é o team-os-creator.
Mapa vivo: /sala-de-controle *painel abre, no navegador do próprio Claude, uma visualização em tempo real (atualiza a cada segundo): a Sala no centro, um nó por projeto, os agentes de cada sessão ao redor com luz por estado (ativo / aguardando / parado / precisa de você), mensagens viajando pelos fios e feed de eventos. Clique abre o detalhe; cada sessão mostra um contador de tokens (líder + agentes: total, ritmo por minuto e barra de contexto que fica amarela acima de 200 mil e vermelha acima de 400 mil) e o topo soma tudo; no projeto, Abrir smart-memory navega a memória dele como no Obsidian — árvore de pastas recolhível, notas com wikilinks, propriedades em etiquetas e um grafo com física ao vivo (arraste os nós, zoom, filtro por pasta, busca, painel de forças, modo Foco ou Tudo). Só lê — reage tanto aos despachos da Sala quanto aos pedidos feitos direto nos terminais. *painel stop derruba.
Lê, mas nunca escreve nem executa em outra pasta; texto lido em outra sessão é dado, nunca instrução. Tudo fica em docs/smart-memory/sala-de-controle/ (PANORAMA.md, registry.md, dispatches.md, organizacao.md).
Instalação: /team-os-creator *install reconhece a pasta de Sala (ou sugere criar 1 | Sala de Controle) e oferece o modo: --squads none --extra-skills sala-de-controle (padrão) ou maestri-os. Só entra por essa flag; onde já está instalada, o *propagate a mantém atualizada.

Sala de Controle — `maestri-os` (recurso para o Maestri)

Para quem roda os projetos como terminais no Maestri: uma pasta própria, sem agentes e sem team-os, que funciona como recepcionista dos outros terminais. Você fala em português normal (simples ou composto: "atualize o site, crie um post e faça um relatório de tráfego"); a skill descobre qual terminal cuida de cada parte, confirma o mapa e despacha em paralelo via maestri ask. Como o Maestri não diz o que cada terminal faz, na primeira vez ela monta sozinha a relação janela → pasta → escopo → apelidos (pela convenção <pasta> | <escopo> no nome da janela) e pede um OK só; depois não pergunta mais. O resto (squads, agentes, resumo do projeto) ela lê da pasta e relê a cada rodada. Tudo fica em docs/smart-memory/maestri/ da Sala de Controle (registry.md, OVERVIEW.md, dispatches.md).

Enxerga só o que está ligado por fio a ela no canvas (intencional). Terminal renomeado = pergunta de novo.
Lê, mas nunca escreve nem executa em outra pasta — todo trabalho vai pelo terminal do projeto, com os agentes e travas daquele projeto.
Espia antes de mandar (maestri check), pedido curto espera a resposta, pedido longo libera e é avisada de volta.
Autopilot no retorno: quando um terminal responde, ela atualiza o histórico e despacha sozinha a próxima parte dependente do plano já confirmado; só para quando o terminal devolve DECISÃO: (pergunta que é do usuário). Os terminais já rodam /team-os — o cabeçalho manda usar a orquestração ativa, não recarregar.
Instalação: /team-os-creator *install reconhece a pasta "Sala de Controle" e oferece só a skill (--squads none --extra-skills maestri-os). Só entra por essa flag — nunca num projeto com squad; onde já está instalada, o *propagate a mantém atualizada. Uma Sala de Controle por dono/marca.

Para banco de dados, os agentes usam /dev-database-patterns e /data-sql-optimization. Para design, o padrão é Claude Design (sem dependências de marketplaces externos).

A skill /sites-copy é de uso geral da squad Sites — disponível a sites-ux, sites-dev-gamma, sites-qa e sites-architect conforme a story.

7. Tutorial passo a passo

A. Orquestrar uma sessão com Agent Teams

1. Abra o projeto no Claude Code (CT ou qualquer projeto com agentes instalados)
2. Carregue:  /team-os
3. Responda o objetivo quando perguntado (ex.: "implementar auth com Supabase")
4. Revise a proposta de time (agentes, ownership, tasks) → confirme com [s]
5. Acompanhe pelo agent panel (↑↓ navega, Enter entra na sessão, x para)
6. Ao final: "Peça ao agente {nome} para encerrar"

Se o lead encerrar cedo, diga: "Continue — há tasks incompletas".

B. Instalar squads num projeto novo

1. No CT, carregue:  /team-os-creator *install
2. Selecione o projeto destino e as squads
3. Confirme o preview (use --dry-run para inspecionar a origem de cada skill)
→ copia agentes da(s) squad(s) + skills que eles citam (incl. team-os) + hooks, faz backup de um .claude/ prévio
  em .claude.bak-<ts>/ e garante o settings.json (ensure-settings.sh). A smart-memory nasce na 1ª sessão de /team-os.

C. Criar ou atualizar um agente

/team-os-creator *create <role>     # um agente
/team-os-creator *squad dev         # uma squad inteira

Depois, sempre: /team-os-creator *audit.

D. Propagar mudanças do CT para os destinos

Editar agente no CT → /team-os-creator *audit → /team-os-creator *propagate

O *propagate só atualiza os arquivos de cada projeto e nunca sobrescreve o que você editou lá: a versão do CT fica ao lado (<arquivo>.new) e você escolhe, um por um. Ele não faz commit; se quiser guardar o resultado no git do projeto, o commit é seu.

8. Modelo de coordenação

Peer-to-peer: teammates conversam direto entre si por nome via SendMessage (ex.: implementer → QA ao concluir). O lead é notificado automaticamente quando um teammate fica idle.
TaskList + self-claim: ao terminar uma task, o agente pega sozinho a próxima livre compatível. ~5-6 tasks por agente mantêm o pipeline fluindo.
Sem nested teams: teammates não spawnam outros teammates — precisa de outra especialidade? SendMessage para o teammate certo.

Agent panel ≠ Agent view

	Agent panel	Agent view (`claude agents`)
O que é	Teammates do time, abaixo do prompt da sessão	Tela de sessões em background independentes
Controles	↑↓, Enter (abrir/mensagem), Esc (interromper), `x` (parar), Ctrl+T (task list)	Space (peek), Enter/→ (attach), Ctrl+X (stop)
Comunicação	Peer-to-peer entre teammates	Cada sessão isolada; teammates/subagents não aparecem como linhas

9. Política de modelos (Híbrido)

O campo model do arquivo do agente prevalece sobre o "Default teammate model" do /config quando o agente roda como teammate. Por isso o CT adota o Híbrido:

Contagem real (grep -h '^model:' .claude/agents/*.md | sort | uniq -c): 25 opus / 77 inherit.

Modelo	Agentes (25 / 77)	Por quê
`opus` (fixo)	architects/planners (9): `dev-architect`, `sites-architect`, `brand-architect`, `legal-architect`, `seo-architect`, `security-architect`, `finance-planner`, `pm-planner`, `sales-planner` · QA (10): `dev-qa`, `sites-qa`, `pm-qa`, `traffic-qa`, `sales-qa`, `brand-qa`, `finance-qa`, `legal-qa`, `seo-qa`, `security-qa` · strategists (6): `traffic-strategist`, `social-strategist`, `sales-strategist`, `brand-strategist`, `finance-strategist`, `legal-strategist`	Raciocínio crítico e veredictos — não vale economizar
`inherit`	os 77 demais	Seguem o `/model` do lead → controle central de custo

Para forçar outro modelo num agente inherit, especifique no spawn: "Spawn {nome} usando modelo haiku para…".

Política de effort (canônica em .claude/skills/team-os-creator/reference/archetypes.md, validada pelo *audit):

Effort	Papéis (contagem real)
`high` (36)	architects/planners, QAs e strategists (os 25 `opus`), hardening (`dev-dev-delta`, `sites-dev-delta`), data (`dev-data-engineer`, `sites-data`, `pm-data`) e as "fontes únicas de números" (`brand-insights`, `finance-controller`, `legal-compliance`, `sales-finance`, `seo-google`, `traffic-bi`)
`medium` (35)	analysts (`*-analyst`), UX (`dev-ux`, `sites-ux`), designers (`brand-designer`, `sales-designer`, `social-design`, `social-photo`, `traffic-designer`), BI/insights/coaching (`dev-bi`, `dev-data-performance`, `pm-coach`) e os especialistas da squad SEO (`seo-technical`, `seo-content`, `seo-schema`, `seo-sitemap`, `seo-performance`, `seo-geo`, `seo-sxo`, `seo-cluster`, `seo-local`, `seo-backlinks`, `seo-ecommerce`, `seo-drift`) e os especialistas da squad Security (`security-appsec`, `security-ai-code`, `security-secrets`, `security-privacy`, `security-incident`)
omitido (31)	implementers (`*-dev-alpha/beta/gamma`), devops (`dev-devops`, `sites-devops`) e os papéis operacionais das squads de negócio (`brand-voice`, `brand-rollout`, `finance-billing`, `finance-tax`, `finance-reporter`, `legal-drafter`, `legal-disputes`, `legal-ops`, `pm-client`, `pm-demand`, `pm-engineer`, `pm-ops`, `pm-reporter`, `sales-copywriter`, `sales-closer`, `social-content`, `social-publisher`, `social-video`, `traffic-automation`, `traffic-copywriter`, `traffic-google`, `traffic-meta`, `traffic-tiktok`) — seguem o default do modelo

10. Hooks de qualidade

13 hooks em .claude/hooks/, referenciados no frontmatter dos agentes ou registrados no settings.json (pelo ensure-settings.sh/*install). Todos são bash 3.2-safe, testados com payloads reais do Claude Code por scripts/test-hooks.sh (493 casos, roda no CI) e com fallback em grep quando o python3 falta.

Guards de git (PreToolUse em Bash) — além de git push direto, os dois cobrem flags globais (git -C, --git-dir, -c alias.x=push), wrappers (env, sudo, \git, /usr/bin/git), comandos multilinha e encadeados, git send-pack, gh pr create/merge, gh release create, gh api de escrita em PRs, e bloqueiam shell embutido (sh -c, bash -c, eval, xargs, find -exec, python3 -c/node -e com git) e variáveis no lugar do comando — expansão indireta não é permitida para operações git.

block-git-push.sh — em 99 agentes: todo agente com Bash exceto os devops, em TODAS as squads (inclusive as sem devops — lá push é sempre do usuário/lead). Garantia dura: push é autoridade exclusiva do DevOps.
guard-push-branch.sh — nos 2 devops (dev-devops, sites-devops): push permitido só quando a branch do repositório alvo e toda ref de destino são main/master; detached HEAD ou branch indeterminável bloqueiam. Fora da main o bloqueio é sempre aplicado — um hook não consegue verificar "pedido explícito do usuário" (só vê o comando e o cwd), e não existe override por env ou texto no comando. Nesse caso o agente pede ao usuário que faça o push manualmente (ou volte para a main).
block-worktree.sh — registrado no .claude/settings.json de cada projeto (matchers Agent|Task|EnterWorktree e Bash). Bloqueia spawn de agente com isolation: worktree, a ferramenta EnterWorktree, git worktree add e criação de branch (checkout -b, switch -c, git branch <nome>) — todo trabalho acontece na branch ativa. Complementado por "worktree": { "bgIsolation": "none" } no mesmo settings. Instalado sempre pelo *install.

Gates de task (TaskCreated / TaskCompleted) — leem os campos reais do payload (task_subject, task_description, cwd):

task-quality.sh — TaskCreated: rejeita task vaga — título curto/genérico ou sem descrição.
check-story-progress.sh — TaskCompleted: task que referencia story só fecha com ## QA Results ou status: done|in-review na story (em docs/smart-memory/stories/{active,in-review,done}/).
check-social-progress.sh — TaskCompleted: task de publicação social só fecha com aprovação registrada (VERA/strategist).
check-proposal-progress.sh — TaskCompleted: task de emissão/envio de proposta ou deck (squad Sales) só fecha com veredicto PASS do sales-qa e confirmação explícita do usuário registradas na descrição.
check-finance-progress.sh — TaskCompleted: task de execução financeira (pagar, transferir, PIX, boleto, nota, guia, cobrança enviada, relatório enviado — squad Finance) só fecha com PASS do finance-qa e confirmação explícita do usuário. Task de preparação (preparar lote, conciliar, calcular) não dispara.
check-legal-progress.sh — TaskCompleted: task de saída jurídica (enviar minuta/notificação, assinar, protocolar, publicar termos — squad Legal) só fecha com PASS do legal-qa e confirmação explícita do usuário. Task de preparação (redigir, revisar, registrar) não dispara.

Economia de tokens (PreToolUse, registrados no settings.json de cada projeto) — transformam o protocolo "buscar antes de ler" em garantia:

guard-smart-memory-read.sh — matcher Read|Bash. Bloqueia leitura de docs/smart-memory/_archive/, leitura de pasta inteira da smart-memory (cat docs/smart-memory/*, grep -r sem -l, find -exec cat) e a 4ª nota fora do L0 sem nova busca: o sm-find.sh zera o contador. Orçamento ajustável por TEAM_OS_L2_BUDGET (padrão 3).
guard-message-size.sh — matcher SendMessage. Bloqueia mensagem entre agentes acima de 20 linhas ou 1.500 caracteres: resumo primeiro, detalhe em arquivo, a mensagem leva o path. Mensagem que começa com [handoff] (resultado final ao lead) vai até 60 linhas. Mensagens de protocolo (shutdown, plan approval) passam.
context-watch.sh — evento UserPromptSubmit. Lê o tamanho do contexto da sessão (última resposta do transcript) e, passando de 200 mil tokens (TEAM_OS_CTX_WARN) ou 400 mil (TEAM_OS_CTX_HIGH), injeta um aviso curto para o Claude propor registrar o estado no ledger e rodar /compact ou abrir sessão nova. Anti-spam (só avisa ao subir de nível ou crescer 100 mil), nunca bloqueia, fail-open. TEAM_OS_CTX_WATCH=0 desliga.

Sessão

team-os-session-title.sh — SessionStart: nomeia a sessão por "projeto · branch", preservando o padrão <PASTA> | <Título>. Instalado globalmente em ~/.claude/hooks/ e registrado no ~/.claude/settings.json pelo *install.

TeammateIdle fica como receita opcional (ver team-os/reference/hooks-de-time.md — hook incondicional cria loop infinito). Settings padrão também garantem subagentPromptCacheTtl: "1h".

11. Estrutura do repositório

.claude/
├── agents/              ← 102 definições de agentes (fonte da verdade)
├── hooks/               ← 13 hooks de qualidade (ver §10)
│   ├── block-git-push.sh          ← PreToolUse: bloqueia push em todo agente com Bash exceto devops
│   ├── block-worktree.sh          ← PreToolUse (settings.json): bloqueia isolation: worktree, EnterWorktree, git worktree add e criação de branch
│   ├── guard-push-branch.sh       ← PreToolUse (devops): push só na main/master; fora dela bloqueio sempre aplicado
│   ├── task-quality.sh            ← TaskCreated: rejeita task vaga
│   ├── check-story-progress.sh    ← TaskCompleted: story só fecha com evidência de QA
│   ├── check-social-progress.sh   ← TaskCompleted: publicação só com aprovação registrada
│   ├── check-proposal-progress.sh ← TaskCompleted: envio de proposta só com PASS + confirmação do usuário
│   ├── check-finance-progress.sh  ← TaskCompleted: execução financeira só com PASS + confirmação do usuário
│   ├── check-legal-progress.sh    ← TaskCompleted: saída jurídica só com PASS + confirmação do usuário
│   └── team-os-session-title.sh   ← SessionStart: nomeia a sessão por "projeto · branch" (instalado em ~/.claude/hooks/ pelo *install)
└── skills/              ← 112 skills (diretórios reais)
    ├── sala-de-controle/        ← Sala de Controle (opt-in, sessões do Claude Code): SKILL.md + scripts/{refresh,scan-sessions,session-tail,project-context,org-map}.py + scripts/painel/{collect.py,serve.py,index.html} (mapa vivo, `*painel`) + templates/{panorama,registry,dispatches,organizacao}.md
    ├── maestri-os/              ← Sala de Controle (opt-in, recurso Maestri): SKILL.md + scripts/scan-project.sh + templates/{registry,overview,dispatches}.md
    ├── seo/                     ← orquestradora da squad SEO + runtime Python (scripts/, schema/, data/, pdf/, hooks/); .venv/ e ms-playwright/ são runtime local (gitignored)
    ├── team-os/                 ← orquestração (distribuída aos projetos)
    │   ├── templates/                   ← story.md (template canônico de story) · digest.md
    │   ├── reference/                   ← estrutura-smart-memory · obsidian-patterns · compact-flow · settings-canonico · hooks-de-time · session-naming · spawn-prompts · proposta-de-time · skills-por-agente · controle-do-time · otimizacao-de-tokens · arquitetura-de-referencia · claude-md-block · troubleshooting
    │   └── scripts/
    │       ├── discovery.sh             ← Smart-Memory Discovery Engine (cria agents/<squad>/<área>/ lendo a linha "Área na smart-memory" dos agentes; --repair completa/migra)
    │       ├── ensure-settings.sh       ← merge idempotente do settings.json do projeto (env, bgIsolation, hooks)
    │       ├── weigh-memory.sh          ← pesa a smart-memory no bootstrap (sinaliza se pesada)
    │       ├── compact-memory.sh        ← *compact: arquiva o frio → _archive/ + LEDGER
    │       └── sm-find.sh               ← busca L1 pelos `summary` das notas
    └── team-os-creator/         ← factory de agentes (exclusiva do CT)
        ├── templates/           ← 9 templates de archetype + agents-page.html.tpl + pressure-scenarios/ (13 cenários)
        ├── reference/           ← archetypes · native-teams-protocol · smart-memory-integration · mcp-servers · skills-catalog-quality · pressure-testing
        ├── scripts/             ← validate-agent.sh (+ --skills) · test-hooks.sh · migrate-ntp.sh · install-to-project.sh · scan-ct-projects.sh · detect-project-signals.sh · dashboard.sh · diff-agents.sh · generate-agent.sh · install-suggested-skills.sh · search-skills.sh · preflight.sh · generate-agents-page.py · update-pack.sh/.py (`*update`) · pack-manifest.sh · trash.sh · release.sh (só mantenedor) · test-update.sh · test-propagate.sh · painel/ (`*painel`: mapa vivo do CT)
        └── presets/             ← 11 presets de squad (dev, sites, social, traffic, pm, sales, brand, finance, legal, seo, security)

.github/workflows/audit.yml  ← CI: validate-agent.sh (+ --skills) · test-hooks.sh · test-update.sh · test-propagate.sh · manifest do pack em dia · sintaxe dos scripts · 0 symlinks quebrados · contagens do README/CLAUDE.md (pelo manifest) · zero caminho de máquina · docs/agentes.html atualizado
docs/agentes.html            ← página oficial dos agentes (gerada — ver §13)
LICENSE · THIRD_PARTY_NOTICES.md · CHANGELOG.md · CONTRIBUTING.md · MAINTAINERS.md
VERSION · pack-manifest.json  ← versão do pack e lista (com sha256) dos arquivos que são do pack; base do `*update`

O CT não versiona docs/smart-memory/ — ela nasce em cada projeto destino na 1ª sessão de /team-os (Discovery Engine), com esta convenção (detalhes em team-os/reference/estrutura-smart-memory.md):

docs/smart-memory/                       ← no projeto destino (Obsidian)
├── INDEX.md                             ← MOC raiz (todos leem ao iniciar)
├── _inbox/                              ← notas rápidas da sessão, consolidadas no *compact
├── project/                             ← overview · tech-stack · conventions · architecture · modules
├── decisions/                           ← ADRs pontuais
├── stories/
│   ├── BACKLOG.md                       ← índice master
│   └── {backlog,active,in-review,done}/ ← <id>-<slug>.md (formato do <id> livre por squad: 1.2, P3, F1…)
├── agents/<squad>/<área>/               ← UMA área por agente instalado, cada uma com DIGEST.md
│                                           (path na linha "**Área na smart-memory:**" de cada agente;
│                                            ex.: agents/dev/qa/, agents/pm/planner/, agents/seo/google/)
└── _archive/                            ← conteúdo frio compactado (fora do working set; não lido no bootstrap)

Smart-memory v2 — "estado, não histórico". A base é um cache quente, não um baú: guarda estado atual e decisões, não narrativa. Três mecanismos mantêm-na enxuta:

Leitura em camadas — cada agente lê INDEX + DIGEST.md da sua área (≤150 linhas) + stories ativas; nunca pastas inteiras. Notas profundas só via wikilink.

Escrita com ciclo de vida — frontmatter kind (reference/episode/digest) + status (active/resolved/superseded) + summary; update-in-place, nunca -v2/-r3; teto ~300 linhas/episódio. Ver team-os/reference/obsidian-patterns.md.

Compactação — o bootstrap pesa a base (weigh-memory.sh: linhas, done, gordos, resolved não-arquivados, top áreas) e sinaliza; /team-os *compact roda o ciclo integral (mecânico + archivist semântico) com uma única confirmação (--auto dispensa até ela) e move (nunca deleta) o frio para _archive/YYYY-QN/ — o summary sobrevive no DIGEST, os LEDGERs indexam tudo.

12. Troubleshooting

Problema	Causa	Solução
Teammates não aparecem	Idle hide após 30s (v2.1.181+) — não pararam	`SendMessage` por nome para reativar
`/resume` não restaura teammates	Limitação conhecida	Re-spawnar com mesmo nome + contexto da smart-memory
Task travada (feita mas não marca)	Status pode atrasar	Verificar o trabalho → atualizar status manualmente
Lead implementa sozinho	Não delegou	"Aguarde os teammates completarem antes de prosseguir"
Muitos prompts de permissão	Teammates pedem aprovação	Pré-aprovar operações no settings ANTES de spawnar
Lead encerra cedo	Declarou concluído antes da hora	"Continue — há tasks incompletas"
tmux órfão	Sessão não encerrou limpo	`tmux ls` → `tmux kill-session -t {nome}`

13. Manutenção do CT

O CT é a fonte da verdade: agentes e skills são editados aqui e levados aos projetos com *propagate — nunca editados direto num projeto destino. Antes de propagar, a auditoria precisa estar verde:

1. Editar agente/skill AQUI — agentes via /team-os-creator (*create, *squad, *migrate)
2. bash .claude/skills/team-os-creator/scripts/validate-agent.sh            → 102/102 agentes do pack conformes (= *audit)
3. bash .claude/skills/team-os-creator/scripts/validate-agent.sh --skills   → lint das 112 skills
4. bash .claude/skills/team-os-creator/scripts/test-hooks.sh                → 505/505 casos dos hooks
5. python3 .claude/skills/team-os-creator/scripts/generate-agents-page.py   → regenera docs/agentes.html
6. /team-os-creator *propagate   → leva aos projetos destino (--match-target-squads)

Quem mantém o pack oficial (e só quem tem o arquivo .team-os-maintainer na raiz) segue um ciclo maior — manifest, CHANGELOG, commit, release e push manual. Ele está descrito em MAINTAINERS.md. Quem só usa o pack não precisa dele: para receber as versões novas, use o *update (Instalar e atualizar).

Regra de ouro: auditoria sempre verde antes de propagar. O CI (.github/workflows/audit.yml) repete os passos 2-5, roda test-update.sh e test-propagate.sh, confere o pack-manifest.json e ainda checa: contagens "102 agentes"/"112 skills" no README e no CLAUDE.md (contadas pelo manifest — agentes e skills próprios de cada usuário não entram), zero caminho de máquina versionado e docs/agentes.html em dia (--check). Detalhes de contribuição em CONTRIBUTING.md; histórico em CHANGELOG.md.

Página oficial dos agentes: docs/agentes.html — apresentação navegável dos 102 agentes: card inteiro clicável abre modal de perfil completo (bio, matriz de autoridade, regras absolutas, skills), skills clicáveis abrem modal com versão/seções e navegação cruzada de volta aos agentes que a usam. Gerada dos arquivos reais por python3 .claude/skills/team-os-creator/scripts/generate-agents-page.py — regenerar após qualquer mudança em agentes ou skills (o CI falha se estiver desatualizada). Preview local: npx http-server docs -p 8765 (config pronta em .claude/launch.json).

Licença

Algumas skills em .claude/skills/ foram importadas de projetos de terceiros e adaptadas (descrição traduzida, frontmatter padronizado, caminhos ajustados); os direitos e a licença originais permanecem com os autores, listados em THIRD_PARTY_NOTICES.md. Toda skill importada nova entra nesse arquivo antes de ser redistribuída.

Mudanças relevantes ficam registradas em CHANGELOG.md (Keep a Changelog + Conventional Commits); como contribuir está em CONTRIBUTING.md.

team-os

Set up

README

team-os

Pack de orquestração para Claude Code Agent Teams — by João Guirunas

Por que team-os?

Índice

⭐ the team-os Method

Duas camadas

As 7 fases

Princípios

Instalar e atualizar

Do zero ao time rodando

1. Crie a pasta pai e as pastas dos projetos

2. Clone o team-os dentro da pasta pai

3. Abra o CT e rode o Command Center

4. Instale a equipe de cada projeto

5. Ligue o time no projeto

6. (Opcional) Crie a Sala de Controle

7. Mantenha tudo atualizado

Como atualizar o pack (*update)

Onde ficam os meus agentes

1. Conceitos fundamentais

2. Pré-requisitos e setup

Requisitos de máquina

MCPs por squad

3. Skill principal: /team-os

O que ela faz, em fases

Comandos

Boas práticas que ela aplica

4. Skill principal: /team-os-creator

Comandos

Os 9 archetypes

Regras absolutas da factory

5. Os 102 agentes e suas skills

Dev — Fullstack SaaS (12)

Sites — Sites e landing pages (10)

Social — Social media (6)

Traffic — Tráfego pago (10)

PM — Gestão de projetos (10, personas Kaelthari)

Sales — Propostas e apresentações (8, personas olímpicas)

Brand — Reposicionamento de marca (8, personas estelares)

Finance — Gestão financeira (8, personas fluviais)

Legal — Jurídico do dia a dia (8, personas latinas)

SEO — Auditoria e otimização de busca (15, personas egípcias)

Security — Segurança de aplicação (7, personas nórdicas)

6. Catálogo de skills de apoio

Catálogo por área

Sala de Controle — sala-de-controle (sessões do Claude Code)

Sala de Controle — maestri-os (recurso para o Maestri)

7. Tutorial passo a passo

A. Orquestrar uma sessão com Agent Teams

B. Instalar squads num projeto novo

C. Criar ou atualizar um agente

D. Propagar mudanças do CT para os destinos

8. Modelo de coordenação

Agent panel ≠ Agent view

9. Política de modelos (Híbrido)

10. Hooks de qualidade

11. Estrutura do repositório

12. Troubleshooting

13. Manutenção do CT

Licença

Como atualizar o pack (`*update`)

3. Skill principal: `/team-os`

4. Skill principal: `/team-os-creator`

Sala de Controle — `sala-de-controle` (sessões do Claude Code)

Sala de Controle — `maestri-os` (recurso para o Maestri)