O Thinker depende de regras que ele não controla e que mudam o tempo todo: provedores com acesso por API, provedores por assinatura, runtimes locais e harnesses. Cada um desses sistemas tem aqui um dossiê, a especificação que o agente principal usa para escrever código compatível, e um agente pesquisador dedicado, que mantém o dossiê alinhado com a fonte da verdade (site e API do provedor, repositório do harness, notas de versão).
- Um agente por entidade. Uma entidade é uma forma de acesso a um provedor (
api-opencodeesub-opencode-gosão entidades distintas), um runtime local (local-lmstudio) ou um harness (harness-claude-code). O agente fica em.claude/agents/<agente>.mde guarda as fontes da verdade e o foco daquela entidade. - Um procedimento comum. Todos seguem
.claude/external-research.md: limites, ordem de autoridade das fontes, checklist por categoria, análise de lacunas e formato das issues. - Entrega. O pesquisador reescreve o dossiê (contrato atual, estado do Thinker, lacunas) e abre uma issue
externopor lacuna relevante, com título[externo:<agente>] G<n>: .... Ele não altera código de produto e não faz commit: quem acionou revisa o diff do dossiê e publica.
- Uma entidade: peça na sessão principal, por exemplo "rode o
local-lmstudio" ou "pesquise osub-opencode-go". - Várias: "rode os pesquisadores de assinatura" ou "revise os dossiês com mais de 30 dias". O Principal dispara os agentes em paralelo, consolida os relatórios e publica os dossiês num único commit
docs(externos): .... - Antes de uma feature: ao pedir algo que toca um sistema externo, o Principal lê o dossiê dele primeiro. Se o dossiê é um esqueleto, tem mais de 30 dias ou não responde à dúvida, ele aciona o pesquisador antes de implementar.
Cada arquivo em api/, assinatura/, local/ e harness/ tem as mesmas seções:
- Resumo: o essencial em poucas linhas.
- Fontes da verdade: links e a última versão, commit ou data conferida (o corte da próxima revisão).
- Contrato: o comportamento atual do sistema externo, com fonte para cada fato. As subseções seguem o checklist da categoria.
- Como o Thinker implementa hoje: valores concretos com
arquivo:linha. - Lacunas: diferenças entre o contrato e o código, com severidade (
quebra,degradação,oportunidade), agente dono, issue e status. - Histórico: uma linha por revisão.
O frontmatter traz revisado_em e versao_observada; revisado_em: null indica um esqueleto ainda não pesquisado.
- Copie o agente de uma entidade da mesma categoria para
.claude/agents/<prefixo>-<id>.md(prefixosapi-,sub-,local-,harness-) e troque nome, fontes, foco e agentes relacionados. - Copie o dossiê correspondente para
docs/externos/<categoria>/<prefixo>-<id>.md, zere o contrato, as lacunas e o histórico e preencha o estado atual do código. - Adicione a linha na tabela abaixo.
Cada pesquisador atualiza a própria linha (data da revisão e lacunas abertas).
| Agente | Categoria | Entidade | IDs no Thinker | Dossiê | Revisado em | Lacunas abertas |
|---|---|---|---|---|---|---|
api-anthropic |
API | Anthropic | anthropic |
dossiê | 2026-11-04 | 0 |
api-bedrock |
API | AWS Bedrock | bedrock |
dossiê | 2026-11-04 | 3 |
api-vertex |
API | Google Vertex AI | vertex |
dossiê | 2026-11-04 | 2 |
api-byteplus |
API | BytePlus ModelArk | byteplus |
dossiê | 2026-11-04 | 1 |
api-cerebras |
API | Cerebras | cerebras |
dossiê | 2026-11-04 | 2 |
api-deepseek |
API | DeepSeek | deepseek |
dossiê | 2026-11-04 | 2 |
api-fireworks |
API | Fireworks AI | fireworks |
dossiê | 2026-11-04 | 4 |
api-groq |
API | Groq | groq |
dossiê | 2026-11-04 | 0 |
api-huggingface |
API | Hugging Face Inference Providers | huggingface |
dossiê | 2026-11-04 | 4 |
api-kilo |
API | Kilo Gateway | kilo |
dossiê | 2026-11-04 | 3 |
api-gemini |
API | Google Gemini API | gemini, google |
dossiê | 2026-11-04 | 1 |
api-minimax |
API | MiniMax | minimax |
dossiê | 2026-11-04 | 4 |
api-meta |
API | Meta (Muse Spark) | meta |
dossiê | 2026-11-04 | 3 |
api-xiaomi |
API | Xiaomi MiMo | xiaomi |
dossiê | 2026-11-04 | 5 |
api-mistral |
API | Mistral | mistral |
dossiê | 2026-11-04 | 0 |
api-moonshot |
API | Moonshot (Kimi API) | moonshot |
dossiê | 2026-11-04 | 2 |
api-nous |
API | NousResearch API | nous |
dossiê | 2026-11-04 | 2 |
api-nvidia |
API | NVIDIA NIM | nvidia |
dossiê | 2026-11-04 | 2 |
api-openai |
API | OpenAI | openai |
dossiê | 2026-11-04 | 1 |
api-pioneer |
API | Pioneer | pioneer |
dossiê | 2026-11-04 | 2 |
api-opencode |
API | OpenCode (API: paid and free models) | opencode |
dossiê | 2026-11-03 | 3 |
api-openrouter |
API | OpenRouter | openrouter |
dossiê | 2026-11-04 | 5 |
api-xai |
API | xAI | xai |
dossiê | 2026-11-04 | 3 |
api-zai |
API | Z.ai | zai |
dossiê | 2026-11-04 | 2 |
api-qwen |
API | Alibaba Cloud (Qwen / Model Studio) | qwen |
dossiê | 2026-11-04 | 5 |
sub-anthropic |
Assinatura | Claude Max / Pro | anthropic |
dossiê | 2026-11-03 | 4 |
sub-byteplus |
Assinatura | BytePlus ModelArk Coding Plan | byteplus |
dossiê | 2026-11-03 | 2 |
sub-openai |
Assinatura | ChatGPT Plus / Pro / Team (Codex) | openai |
dossiê | 2026-11-03 | 1 |
sub-minimax |
Assinatura | MiniMax Coding Plan | minimax |
dossiê | 2026-11-03 | 3 |
sub-mistral |
Assinatura | Mistral Vibe | mistral |
dossiê | 2026-11-03 | 2 |
sub-xiaomi |
Assinatura | Xiaomi MiMo Token Plan | xiaomi |
dossiê | 2026-11-03 | 2 |
sub-qwen |
Assinatura | Qwen Token Plan | qwen |
dossiê | 2026-11-03 | 3 |
sub-moonshot |
Assinatura | Kimi Coding Plan | moonshot |
dossiê | 2026-11-03 | 2 |
sub-nous |
Assinatura | NousResearch subscription | nous |
dossiê | 2026-11-03 | 4 |
sub-ollama-cloud |
Assinatura | Ollama Cloud | ollama-cloud |
dossiê | 2026-11-03 | 3 |
sub-kiro |
Assinatura | Kiro | kiro |
dossiê | 2026-11-03 | 3 |
sub-zai |
Assinatura | GLM Coding Plan | zai |
dossiê | 2026-11-03 | 2 |
sub-opencode-go |
Assinatura | OpenCode Go | opencode-go |
dossiê | 2026-11-03 | 4 |
sub-opencode |
Assinatura | OpenCode Console | opencode |
dossiê | 2026-11-03 | 3 |
sub-gemini |
Assinatura | Sign in with Google (Gemini Code Assist) | gemini |
dossiê | 2026-11-03 | 2 |
sub-xai |
Assinatura | Grok subscription | xai |
dossiê | 2026-11-03 | 2 |
sub-copilot |
Assinatura | GitHub Copilot | copilot |
dossiê | 2026-11-03 | 4 |
sub-commandcode |
Assinatura | Command Code | commandcode |
dossiê | 2026-11-03 | 4 |
sub-cline-pass |
Assinatura | ClinePass | cline-pass |
dossiê | 2026-11-03 | 4 |
local-lmstudio |
Local | LM Studio | lmstudio |
dossiê | 2026-11-03 | 3 |
local-ollama |
Local | Ollama | ollama |
dossiê | 2026-11-04 | 1 |
local-llamacpp |
Local | llama.cpp (llama-server) | llamacpp |
dossiê | 2026-11-04 | 3 |
harness-claude-code |
Harness | Claude Code | claude-code |
dossiê | 2026-11-03 | 4 |
harness-opencode |
Harness | OpenCode | opencode |
dossiê | 2026-11-06 | 5 |
harness-codex |
Harness | Codex CLI | codex |
dossiê | 2026-11-03 | 3 |
harness-openclaw |
Harness | OpenClaw | openclaw |
dossiê | 2026-11-03 | 3 |
harness-hermes |
Harness | Hermes Agent | hermes |
dossiê | 2026-11-06 | 1 |
harness-nanobot |
Harness | Nanobot | nanobot |
dossiê | 2026-11-03 | 2 |
harness-craft |
Harness | Craft Agent | craft |
dossiê | 2026-11-03 | 3 |
harness-claude-app |
Harness | Claude (desktop app) | claude-app |
dossiê | 2026-11-03 | 3 |
harness-n8n |
Harness | n8n | n8n |
dossiê | 2026-11-03 | 2 |
harness-zapier |
Harness | Zapier | zapier |
dossiê | 2026-11-03 | 1 |
harness-langflow |
Harness | Langflow | langflow |
dossiê | 2026-11-03 | 3 |
harness-chatwoot |
Harness | Chatwoot | chatwoot |
dossiê | 2026-11-03 | 2 |
harness-open-webui |
Harness | Open WebUI | open-webui |
dossiê | 2026-11-03 | 2 |
harness-deepseek-harness |
Harness | DeepSeek Harness | deepseek-harness |
dossiê | 2026-11-03 | 3 |
harness-pi |
Harness | Agent Pi | pi |
dossiê | 2026-11-03 | 2 |
harness-cline |
Harness | Cline | cline |
dossiê | 2026-11-03 | 2 |
harness-copilot-cli |
Harness | Copilot CLI | copilot-cli |
dossiê | 2026-11-03 | 2 |
harness-openai-sdk |
Harness | OpenAI SDK | openai-sdk |
dossiê | 2026-11-03 | 4 |
harness-anthropic-sdk |
Harness | Anthropic SDK | anthropic-sdk |
dossiê | 2026-11-03 | 3 |
harness-vercel-ai-sdk |
Harness | Vercel AI SDK | vercel-ai-sdk |
dossiê | 2026-11-03 | 2 |
harness-langchain |
Harness | LangChain | langchain |
dossiê | 2026-11-03 | 3 |