O Thinker é desenvolvido por agentes do Claude Code. O Principal é a sessão guiada pelo CLAUDE.md: ele conversa com você, planeja e delega. Os subagentes ficam em .claude/agents/.
| Agente | Arquivo | Modelo | Responsabilidade | Pode alterar código? |
|---|---|---|---|---|
| Principal | CLAUDE.md |
sessão | Recebe pedidos, implementa e publica conforme o ADR 0005 | Sim |
| Manifest | manifest-tracker.md |
Sonnet | Acompanha o upstream e abre issues upstream |
Não (só upstream/) |
| LiteLLM | litellm-expert.md |
Sonnet | Estuda o código atual do LiteLLM Proxy (clone raso em ~/.cache/thinker/litellm), responde como ele faz X e ranqueia recursos que o Thinker não tem, em docs/referencia/litellm/ |
Não (só docs/referencia/litellm/) |
| QA Docker | qa-docker.md |
Sonnet | Build da imagem e testes no Docker local | Não |
| Revisor | reviewer.md |
herda | Revisão sob demanda: bugs, segurança, isolamento | Não |
| Backend | backend-dev.md |
herda | NestJS, TypeORM, proxy, CLI, MCP | Sim |
| Frontend | frontend-dev.md |
herda | Dashboard React | Sim |
| Provedores | providers.md |
herda | Adaptadores, catálogos, preços, assinaturas | Sim |
| Arquiteto | architect.md |
herda | Desenho de features e ADRs | Só docs/ e issues (também planeja milestones e abre as issues) |
| DevOps | devops.md |
herda | CI, imagem multi-arch, Docker Hub, releases | Sim (infra) |
| Docs PT-BR | docs-ptbr.md |
Sonnet | Documentação e notas de release | Só docs |
| Pesquisadores de sistemas externos (68) | api-*.md, sub-*.md, local-*.md, harness-*.md |
herda | Um por entidade externa: mantém o dossiê em docs/externos/ e abre issues externo |
Não (só o próprio dossiê) |
O litellm-expert responde tudo sobre o LiteLLM Proxy a partir do código atualizado do GitHub (um clone raso compartilhado entre worktrees, atualizado quando tem mais de um dia). Ele grava em docs/referencia/litellm/ um índice (README.md, com o SHA revisado), o ranking recursos.md (recursos que o Thinker não tem, com valor, esforço, encaixe nos ADRs e onde ficariam no código) e um <tema>.md por pergunta. Não abre issues nem faz commit; o Principal revisa o diff e publica (docs(litellm): ...).
Cada provedor (por forma de acesso: API ou assinatura), runtime local e harness suportado tem um agente próprio que estuda a fonte da verdade e mantém uma especificação para o Principal. O procedimento comum está em .claude/external-research.md; a lista completa, o formato do dossiê e como acionar estão em docs/externos/README.md. Uma entidade nova ganha agente, dossiê e linha no índice de docs/externos/, não nesta tabela.
| Agente | Gatilho | Saída |
|---|---|---|
| Manifest | Rotina semanal na nuvem (Claude Code) + sob demanda | Issues upstream + PR atualizando upstream/STATE.md |
A rotina na nuvem é apenas um invólucro fino: o procedimento completo (fontes, cortes, deduplicação, branch e PR) vive em .claude/agents/manifest-tracker.md. Para mudar o comportamento da rotina, edite o arquivo do agente, não a configuração da rotina.
Modo autônomo (ADR 0005): o Principal tira as dúvidas só no início do pedido, implementa direto, roda testes mínimos e publica com scripts/ship.sh "<mensagem>", que integra na main, sobe a versão e empurra a tag. O workflow Release publica tmsoftbrasil/thinker:latest e o GitHub release. Não há gate de revisão; o reviewer e o qa-docker rodam só quando você pede ou quando a mudança é de risco (migração, auth, proxy).
- O Principal identifica um tipo de trabalho recorrente que nenhum agente cobre.
- Ele cria o arquivo
.claude/agents/<nome>.md(papel, ferramentas, modelo, limites) e o registra nesta tabela.
- Área:
area:backend,area:frontend,area:providers,area:infra,area:docs - Upstream:
upstream,upstream:adotar,upstream:adaptar - Prioridade:
prioridade:alta - Decisão:
decisãomarca issues que aguardam uma decisão do mantenedor (por exemplo, decisões de produto em aberto levantadas pelo Arquiteto). Não há labels por agente: o agente responsável vai no corpo da issue.