agent-devkit 0.1.5 → 0.1.6

package/README.md

@@ -26,7 +26,7 @@ agent doctor
 Expected version for this release:
 
 ```text
-agent 0.1.5
+agent 0.1.6
 ```
 
 ## Quick Start
@@ -259,7 +259,7 @@ agent "desative o azure devops por enquanto"
 agent "reative o ollama"
 ```
 
-Decisions are stored under `~/.ai-devkit/config/decisions.json`; secret values
+Decisions are stored under `~/.agent-devkit/config/decisions.json`; secret values
 are not stored there.
 
 ## Configure LLM Backends

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-devkit",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Agent DevKit CLI runtime for specialist AI agents, capabilities and provider-aware automations.",
   "type": "module",
   "license": "MIT",

package/runtime/README.md

@@ -255,7 +255,9 @@ Referencias oficiais:
 
 Existem dois modos de execucao:
 
-- `agent "<prompt>"`: entrada em linguagem natural; exige backend LLM.
+- `agent "<prompt>"`: entrada em linguagem natural; monta um plano multiagente,
+  usa capabilities deterministicas quando possivel e exige backend LLM apenas
+  quando nenhuma rota local atende a tarefa.
 - `agent run <agent> <capability>`: execucao deterministica; nao exige LLM.
 
 Exemplo em linguagem natural:
@@ -264,6 +266,24 @@ Exemplo em linguagem natural:
 agent "analise o problema relatado no card 9900"
 ```
 
+Em `--json`, prompts roteados retornam `execution_plan` com o coordenador
+`task-orchestrator`, tarefas especialistas, configuracoes pendentes,
+`review_task` e `orchestration_trace`. Se uma fonte ou provider faltar, o plano
+fica `needs-input` e inclui o `provider-configurator` com a proxima pergunta do
+wizard. Quando a fonte esta configurada e a capability e read-only, o runtime
+executa a task primaria pelo runner existente e revisa a conclusao pelo
+`review_gate`.
+
+Para tarefas operacionais como resumo, classificacao, extracao e normalizacao,
+o runtime pode delegar uma subtarefa limitada ao `local-llm-operator` usando
+Ollama. O resultado local aparece em `local_llm_execution` e e usado apenas como
+contexto de apoio pelo coordenador principal.
+
+Quando `review_gate.required = true`, o Agent DevKit exige uma segunda revisao
+concreta pelo `execution-reviewer`, preferindo `claude-code` ou `codex-cli`.
+Sem reviewer independente configurado, ou sem uma decisao explicita
+`REVIEW OK`, a execucao retorna `needs-review` em vez de concluir como `ok`.
+
 Exemplo deterministico:
 
 ```bash
@@ -329,8 +349,31 @@ agent --json "analise o card 7914 do projeto sustentacao no azure"
 agent --json run topdesk-orchestrator read-incident --number "I 2606 001"
 ```
 
+O retorno inclui `setup_wizard.wizard_id`. Continue o roteiro uma resposta por
+vez; ao concluir, o runtime cria a source reutilizavel e retoma o prompt
+original automaticamente:
+
+```bash
+agent wizard list
+agent wizard show wiz-20260628120000-abc12345
+agent wizard answer wiz-20260628120000-abc12345 sim
+agent wizard answer wiz-20260628120000-abc12345 "minha-org"
+agent wizard answer wiz-20260628120000-abc12345 AZURE_DEVOPS_PAT
+agent wizard cancel wiz-20260628120000-abc12345
+```
+
+Em terminal interativo, sem `--json`, o proprio `agent` conduz o roteiro
+pergunta por pergunta. Em automacoes, pipes e testes, use os subcomandos
+`agent wizard ...` para evitar bloqueio de terminal.
+
+Credenciais devem ser informadas por referencia, por exemplo o nome de uma
+variavel de ambiente ou o caminho de um arquivo local. O Agent DevKit nao grava
+o valor bruto do segredo no estado do wizard nem na configuracao da source.
+
 O usuario tambem pode controlar ferramentas, integracoes, skills e LLMs sem
-editar arquivos diretamente:
+editar arquivos diretamente. Os alvos sao resolvidos pelos catalogos locais:
+`tooling/toolchain.yaml`, `providers/*.yaml`, `vendor/skills/CATALOG.md` e
+backends LLM registrados.
 
 ```bash
 agent decisions list
@@ -347,13 +390,28 @@ As mesmas operacoes podem ser feitas por prompt:
 ```bash
 agent "mostre minhas decisoes"
 agent "desative o azure devops por enquanto"
+agent "desative topdesk"
+agent "habilite gh-cli"
+agent "desative a skill security-review"
+agent "desative openrouter"
 agent "reative o ollama"
+agent "liste llms"
+agent "esqueca minha decisao sobre anthropic"
 ```
 
+Se um nome existir em mais de uma categoria, o agente retorna `needs-input` com
+as opcoes encontradas em vez de escolher silenciosamente. Use a categoria no
+prompt para resolver, por exemplo `desative a integracao figma` ou `desative a
+ferramenta figma-mcp`.
+
 Se o usuario negar ou desativar uma ferramenta, a decisao fica persistida em
-`~/.ai-devkit/config/decisions.json` e o agente segue sem usar essa ferramenta
+`~/.agent-devkit/config/decisions.json` e o agente segue sem usar essa ferramenta
 nas proximas sessoes ate reativacao explicita.
 
+O home global canonico e `~/.agent-devkit`. Instancias antigas em `~/.ai-devkit`
+continuam funcionando como legado; use `agent config migrate-home --dry-run` e
+depois `agent config migrate-home` para migrar explicitamente.
+
 Comandos uteis:
 
 ```bash
@@ -522,7 +580,7 @@ solicita provider e nao persiste segredos. Use `--dry-run --json` para revisar
 os caminhos antes de escrever. O host `all` inclui Codex App, Claude Code e
 Claude Desktop/Claude.ai.
 
-Instalacoes globais gravam `~/.ai-devkit/runtime.lock`; instalacoes por projeto
+Instalacoes globais gravam `~/.agent-devkit/runtime.lock`; instalacoes por projeto
 gravam `.ai-devkit/ai-devkit.lock`. Use `agent doctor --project .` para
 verificar se o projeto esta fixado em runtime diferente do global.
 
@@ -542,7 +600,10 @@ Execucoes reais de capabilities com escrita exigem confirmacao dupla no runtime:
 `blocked_by_default` tambem exigem `--allow-dangerous`, alem das validacoes
 internas da capability.
 
-Saidas JSON de `agent run` usam contrato `ai-devkit.run/v1`, com `status`
+Saidas JSON de `agent "<prompt>"` usam o contrato de orquestracao
+`ai-devkit.agentic-plan/v1` dentro de `execution_plan`. Os estados principais
+sao `planned`, `needs-input`, `ok`, `partial` e `blocked`. Saidas JSON de
+`agent run` usam contrato `ai-devkit.run/v1`, com `status`
 parseavel (`ok`, `partial`, `blocked`, `failed`), `agent_id`, `capability_id`,
 `providers`, `fallback_applied`, `evidence`, `risks`, `next_steps` e
 `artifacts` sempre presentes.
@@ -591,6 +652,8 @@ e ignorado pelo Git. Para Azure DevOps, `AZURE_DEVOPS_ORG` e
 - [`elasticsearch-log-analyzer`](agents/elasticsearch-log-analyzer/):
   especialista em Elasticsearch para descoberta de fontes, busca de eventos,
   rastreio de requests, padroes de erro e relatorios de logs.
+- [`execution-reviewer`](agents/execution-reviewer/): agente runtime de
+  revisao final, revisao de planos e revisao de resultados antes da conclusao.
 - [`excel-workbook-builder`](agents/excel-workbook-builder/): especialista em
   templates, preenchimento, conciliacao, revisao e exportacao de planilhas
   Excel.
@@ -602,6 +665,8 @@ e ignorado pelo Git. Para Azure DevOps, `AZURE_DEVOPS_ORG` e
   em modo report-only e criar automacoes locais conservadoras.
 - [`knowledge-generator`](agents/knowledge-generator/): especialista em gerar
   knowledge versionavel a partir de arquivos, pastas, projetos e documentacoes.
+- [`local-llm-operator`](agents/local-llm-operator/): agente runtime para
+  diagnosticar, selecionar e delegar tarefas operacionais a LLMs locais.
 - [`n1-support-agent`](agents/n1-support-agent/): especialista N1 para executar
   runbooks operacionais a partir de cards Azure DevOps, orquestrando Azure,
   SQL Server, logs e TOPdesk.
@@ -611,6 +676,8 @@ e ignorado pelo Git. Para Azure DevOps, `AZURE_DEVOPS_ORG` e
   especialista em PostgreSQL read-only para descoberta de databases, schemas,
   tabelas, relacionamentos, joins, queries assistidas, perfilamento, qualidade
   de dados e relatorios analiticos.
+- [`provider-configurator`](agents/provider-configurator/): agente runtime que
+  conduz wizard de providers, sources e referencias seguras de credenciais.
 - [`presentation-deck-builder`](agents/presentation-deck-builder/):
   especialista em templates versionados de PowerPoint, arquivos de entrada para
   preenchimento e geracao de decks a partir de conteudo estruturado.
@@ -626,6 +693,8 @@ e ignorado pelo Git. Para Azure DevOps, `AZURE_DEVOPS_ORG` e
   especialista em analise de requisitos, entrevistas, analise de projetos,
   documentacao funcional/tecnica, user stories, fluxos de jornada e
   rastreabilidade.
+- [`task-orchestrator`](agents/task-orchestrator/): agente runtime que planeja
+  prompts livres, seleciona especialistas, coordena execucao e aciona revisao.
 - [`technical-integration-analyst`](agents/technical-integration-analyst/):
   especialista em analise de documentacoes tecnicas de integracoes, com suporte
   a REST, SOAP, MCP, SFTP, SMTP e outros protocolos, gerando contratos, fluxos,

package/runtime/agents/README.md

@@ -53,6 +53,8 @@ agents/<agent-id>/
 - `drawio-diagram-builder`: especialista em diagramas Draw.io editaveis a
   partir de fontes reais, entrevista, geracao, revisao e refinamento.
 - `elasticsearch-log-analyzer`: especialista em logs no Elasticsearch.
+- `execution-reviewer`: agente runtime de revisao final, revisao de planos e
+  revisao de resultados de agentes especialistas.
 - `excel-workbook-builder`: especialista em templates, preenchimento,
   conciliacao, revisao e exportacao de planilhas Excel.
 - `figma-ui-ux-product-designer`: especialista UI/UX para criar, recriar,
@@ -62,6 +64,8 @@ agents/<agent-id>/
   locais conservadoras.
 - `knowledge-generator`: especialista em gerar knowledge versionavel a partir de
   fontes locais e documentacoes.
+- `local-llm-operator`: agente runtime para diagnosticar, selecionar e delegar
+  tarefas operacionais a LLMs locais como Ollama.
 - `n1-support-agent`: especialista N1 para runbooks operacionais a partir de
   cards Azure DevOps.
 - `n2-support-agent`: especialista N2 para investigacao de causa raiz e geracao
@@ -70,12 +74,16 @@ agents/<agent-id>/
   de apresentacoes PowerPoint.
 - `postgres-data-analyzer`: especialista em analise read-only forte de dados
   Postgres.
+- `provider-configurator`: agente runtime para conduzir wizard de configuracao
+  de providers, sources e referencias seguras de credenciais.
 - `sqlserver-data-analyzer`: especialista em analise read-only de dados SQL
   Server.
 - `sqlserver-change-operator`: especialista em mudancas controladas em SQL
   Server.
 - `software-specification-analyst`: especialista em analise de requisitos,
   entrevistas, analise de projetos e especificacoes completas de software.
+- `task-orchestrator`: agente runtime que planeja prompts livres, seleciona
+  especialistas, coordena execucao e aciona revisao.
 - `technical-integration-analyst`: especialista em documentacoes tecnicas de
   integracoes e artefatos de teste.
 - `topdesk-orchestrator`: especialista em TOPdesk para incidentes e triagem.

package/runtime/agents/execution-reviewer/AGENTS.md

@@ -0,0 +1,8 @@
+# AGENTS.md
+
+Instrucoes locais para o agente `execution-reviewer`.
+
+Este agente revisa planos, resultados e entregas finais antes de conclusao.
+Ele deve procurar lacunas, risco operacional, ausencia de teste, fuga de
+credencial e divergencia de contrato.
+

package/runtime/agents/execution-reviewer/README.md

@@ -0,0 +1,13 @@
+# Execution Reviewer
+
+Agente de runtime responsavel por revisar plano, execucao e saida final de
+atividades multiagente.
+
+No runtime da CLI, este agente e acionado quando `review_gate.required = true`.
+A revisao deve ser executada por um backend independente do produtor da resposta,
+preferindo `claude-code` ou `codex-cli`.
+
+O reviewer deve responder com `REVIEW OK` para aprovar ou `REVIEW BLOCKED` para
+bloquear. Sem reviewer independente configurado, com decisao bloqueada, ou sem
+uma decisao explicita `REVIEW OK`, a CLI retorna `needs-review` e nao conclui a
+atividade como `ok`.

package/runtime/agents/execution-reviewer/agent.yaml

@@ -0,0 +1,25 @@
+id: execution-reviewer
+kind: runtime-agent
+name: Execution Reviewer
+version: 0.1.6
+status: draft
+owner: agent-devkit
+
+purpose: >
+  Revisar planos e resultados antes da conclusao, garantindo aderencia a
+  contrato, evidencias, ausencia de segredo e qualidade operacional.
+
+default_context:
+  - knowledge/system.md
+  - knowledge/context.md
+
+capabilities:
+  - review-final-output
+  - review-plan
+  - review-agent-result
+
+write_policy:
+  external_writes: never
+  default_mode: review-only
+  blocks_on_high_risk: true
+

package/runtime/agents/execution-reviewer/capabilities/review-agent-result/capability.yaml

@@ -0,0 +1,15 @@
+id: execution-reviewer.review-agent-result
+kind: capability
+name: Review Agent Result
+version: 0.1.6
+status: draft
+purpose: Revisar resultado individual de agente especialista.
+write_policy: read-only
+entrypoint:
+  workflow: workflow.md
+inputs:
+  required: [agent_id, result]
+  optional: [capability_id]
+outputs:
+  artifacts: [agent-result-review]
+

package/runtime/agents/execution-reviewer/capabilities/review-agent-result/decision-rules.md

@@ -0,0 +1,6 @@
+# Decision Rules
+
+- Resultado sem evidencia deve ser marcado como risco.
+- Erro de runner nao deve ser convertido em sucesso.
+- Saida de agente nao deve vazar segredo.
+

package/runtime/agents/execution-reviewer/capabilities/review-agent-result/workflow.md

@@ -0,0 +1,7 @@
+# Workflow
+
+1. Verificar contrato da capability executada.
+2. Comparar output com entradas e evidencias.
+3. Marcar riscos, lacunas e erros.
+4. Encaminhar conclusao para revisao final.
+

package/runtime/agents/execution-reviewer/capabilities/review-final-output/capability.yaml

@@ -0,0 +1,15 @@
+id: execution-reviewer.review-final-output
+kind: capability
+name: Review Final Output
+version: 0.1.6
+status: draft
+purpose: Revisar saida final antes de concluir uma tarefa multiagente.
+write_policy: read-only
+entrypoint:
+  workflow: workflow.md
+inputs:
+  required: [result]
+  optional: [execution_plan, review_gate]
+outputs:
+  artifacts: [review-report]
+

package/runtime/agents/execution-reviewer/capabilities/review-final-output/decision-rules.md

@@ -0,0 +1,6 @@
+# Decision Rules
+
+- Bloquear conclusao se houver segredo bruto.
+- Bloquear conclusao se escrita externa ocorreu sem permissao.
+- Exigir evidencia para afirmacoes operacionais.
+

package/runtime/agents/execution-reviewer/capabilities/review-final-output/workflow.md

@@ -0,0 +1,7 @@
+# Workflow
+
+1. Comparar resultado com o pedido original.
+2. Verificar se tasks planejadas foram executadas ou bloqueadas corretamente.
+3. Checar evidencias, testes e riscos.
+4. Aprovar, pedir correcao ou bloquear conclusao.
+

package/runtime/agents/execution-reviewer/capabilities/review-plan/capability.yaml

@@ -0,0 +1,15 @@
+id: execution-reviewer.review-plan
+kind: capability
+name: Review Plan
+version: 0.1.6
+status: draft
+purpose: Revisar plano multiagente antes de execucao sensivel.
+write_policy: read-only
+entrypoint:
+  workflow: workflow.md
+inputs:
+  required: [execution_plan]
+  optional: []
+outputs:
+  artifacts: [plan-review]
+

package/runtime/agents/execution-reviewer/capabilities/review-plan/decision-rules.md

@@ -0,0 +1,6 @@
+# Decision Rules
+
+- Plano nao pode referenciar agente inexistente.
+- Plano com provider obrigatorio ausente deve ficar `needs-input`.
+- Plano com escrita externa precisa permissao explicita.
+

package/runtime/agents/execution-reviewer/capabilities/review-plan/workflow.md

@@ -0,0 +1,7 @@
+# Workflow
+
+1. Validar que todos os `agent_id` existem.
+2. Confirmar capabilities e providers necessarios.
+3. Identificar escrita externa e permissoes exigidas.
+4. Reportar ajustes antes da execucao.
+

package/runtime/agents/execution-reviewer/infra/README.md

@@ -0,0 +1,4 @@
+# Infra
+
+Este agente revisa artefatos locais e nao acessa sistemas externos diretamente.
+

package/runtime/agents/execution-reviewer/knowledge/context.md

@@ -0,0 +1,6 @@
+# Context
+
+Este agente e chamado pelo `review_task` do plano multiagente. Coordenadores
+como Claude/Codex podem ser revisores preferenciais, mas a superficie formal da
+revisao no Agent DevKit e este agente.
+

package/runtime/agents/execution-reviewer/knowledge/system.md

@@ -0,0 +1,18 @@
+# System
+
+Voce e o Execution Reviewer do Agent DevKit.
+
+Missao:
+
+- revisar plano antes de execucao quando necessario;
+- revisar resultado de agentes especialistas;
+- validar saida final antes de concluir;
+- apontar riscos, lacunas e evidencias ausentes.
+
+Guardrails:
+
+- nao executar escrita externa;
+- nao aprovar resultado sem evidencia;
+- bloquear conclusao quando houver segredo bruto, permissao ausente ou erro de
+  contrato.
+

package/runtime/agents/execution-reviewer/templates/README.md

@@ -0,0 +1,4 @@
+# Templates
+
+Templates futuros para relatorios de revisao.
+

package/runtime/agents/local-llm-operator/AGENTS.md

@@ -0,0 +1,8 @@
+# AGENTS.md
+
+Instrucoes locais para o agente `local-llm-operator`.
+
+Este agente opera modelos locais, especialmente Ollama, para tarefas
+operacionais e repetitivas. Coordenadores Claude/Codex continuam responsaveis
+por decisao, especificacao, revisao e conclusao final.
+

package/runtime/agents/local-llm-operator/README.md

@@ -0,0 +1,12 @@
+# Local LLM Operator
+
+Agente de runtime responsavel por diagnosticar modelos locais, selecionar
+workers Ollama e delegar tarefas operacionais que consumiriam muitos tokens de
+coordenadores principais.
+
+No runtime da CLI, este agente executa apenas subtarefas limitadas de resumo,
+classificacao, extracao, normalizacao e agrupamento. O resultado e retornado em
+`local_llm_execution` e usado como contexto de apoio pelo coordenador principal.
+
+Este agente nao pode fazer revisao final, escrita externa, aprovacao,
+reprovacao, decisao de permissao, deploy ou decisao de arquitetura.

package/runtime/agents/local-llm-operator/agent.yaml

@@ -0,0 +1,26 @@
+id: local-llm-operator
+kind: runtime-agent
+name: Local LLM Operator
+version: 0.1.6
+status: draft
+owner: agent-devkit
+
+purpose: >
+  Operar LLMs locais como trabalhadores de baixo custo para tarefas
+  repetitivas, mantendo coordenadores principais responsaveis por decisao,
+  especificacao e revisao.
+
+default_context:
+  - knowledge/system.md
+  - knowledge/context.md
+
+capabilities:
+  - inspect-local-models
+  - select-local-worker
+  - delegate-operational-task
+
+write_policy:
+  external_writes: never
+  default_mode: operational-worker
+  requires_coordinator_review: true
+

package/runtime/agents/local-llm-operator/capabilities/delegate-operational-task/capability.yaml

@@ -0,0 +1,15 @@
+id: local-llm-operator.delegate-operational-task
+kind: capability
+name: Delegate Operational Task
+version: 0.1.6
+status: draft
+purpose: Delegar uma tarefa operacional a modelo local e retornar resultado revisavel.
+write_policy: read-only
+entrypoint:
+  workflow: workflow.md
+inputs:
+  required: [task]
+  optional: [model]
+outputs:
+  artifacts: [delegated-result]
+

package/runtime/agents/local-llm-operator/capabilities/delegate-operational-task/decision-rules.md

@@ -0,0 +1,6 @@
+# Decision Rules
+
+- Nao executar tarefas com escrita externa.
+- Nao ocultar baixa confianca ou falha do modelo local.
+- Escalar para coordenador/API quando a tarefa exigir raciocinio de alto nivel.
+

package/runtime/agents/local-llm-operator/capabilities/delegate-operational-task/workflow.md

@@ -0,0 +1,7 @@
+# Workflow
+
+1. Receber tarefa operacional delimitada.
+2. Executar ou planejar execucao no modelo local selecionado.
+3. Retornar resultado com evidencias e limitacoes.
+4. Encaminhar para revisao do coordenador.
+

package/runtime/agents/local-llm-operator/capabilities/inspect-local-models/capability.yaml

@@ -0,0 +1,15 @@
+id: local-llm-operator.inspect-local-models
+kind: capability
+name: Inspect Local Models
+version: 0.1.6
+status: draft
+purpose: Diagnosticar disponibilidade de Ollama e modelos locais instalados.
+write_policy: read-only
+entrypoint:
+  workflow: workflow.md
+inputs:
+  required: []
+  optional: [model]
+outputs:
+  artifacts: [local-model-report]
+

package/runtime/agents/local-llm-operator/capabilities/inspect-local-models/decision-rules.md

@@ -0,0 +1,5 @@
+# Decision Rules
+
+- Diagnostico nao deve instalar modelo.
+- Ausencia de Ollama deve gerar recomendacao de setup, nao falha estrutural.
+

package/runtime/agents/local-llm-operator/capabilities/inspect-local-models/workflow.md

@@ -0,0 +1,6 @@
+# Workflow
+
+1. Verificar se Ollama esta disponivel.
+2. Listar modelos locais conhecidos.
+3. Reportar disponibilidade sem instalar nada automaticamente.
+

package/runtime/agents/local-llm-operator/capabilities/select-local-worker/capability.yaml

@@ -0,0 +1,15 @@
+id: local-llm-operator.select-local-worker
+kind: capability
+name: Select Local Worker
+version: 0.1.6
+status: draft
+purpose: Escolher se uma tarefa operacional pode ser delegada a LLM local.
+write_policy: read-only
+entrypoint:
+  workflow: workflow.md
+inputs:
+  required: [prompt]
+  optional: [model_plan]
+outputs:
+  artifacts: [local-worker-selection]
+

package/runtime/agents/local-llm-operator/capabilities/select-local-worker/decision-rules.md

@@ -0,0 +1,6 @@
+# Decision Rules
+
+- Usar local LLM para resumo, extracao, classificacao e normalizacao.
+- Nao usar local LLM para revisao final, permissao, deploy ou aprovacao.
+- Coordenador principal deve revisar resultado final.
+

package/runtime/agents/local-llm-operator/capabilities/select-local-worker/workflow.md

@@ -0,0 +1,7 @@
+# Workflow
+
+1. Classificar a tarefa como operacional ou decisoria.
+2. Verificar disponibilidade local.
+3. Selecionar modelo local somente para trabalho operacional.
+4. Registrar razao da selecao ou fallback.
+

package/runtime/agents/local-llm-operator/infra/README.md

@@ -0,0 +1,4 @@
+# Infra
+
+Este agente usa a integracao local com Ollama exposta pelo runtime.
+

package/runtime/agents/local-llm-operator/knowledge/context.md

@@ -0,0 +1,6 @@
+# Context
+
+O provider local principal e Ollama. Modelos locais sao preferidos apenas para
+trabalho operacional. O plano deve explicitar quando a delegacao local foi
+selecionada, recomendada ou recusada.
+

package/runtime/agents/local-llm-operator/knowledge/system.md

@@ -0,0 +1,18 @@
+# System
+
+Voce e o Local LLM Operator do Agent DevKit.
+
+Missao:
+
+- diagnosticar modelos locais;
+- selecionar worker local para tarefas operacionais;
+- delegar resumir, classificar, extrair, normalizar e comparar;
+- devolver resultado para revisao de coordenador.
+
+Guardrails:
+
+- nao tomar decisoes finais;
+- nao executar escrita externa;
+- nao aprovar PR, arquitetura, permissao ou deploy;
+- pedir fallback para Claude/Codex/API quando modelo local nao for adequado.
+

package/runtime/agents/local-llm-operator/templates/README.md

@@ -0,0 +1,4 @@
+# Templates
+
+Templates futuros para relatorios de delegacao local.
+

package/runtime/agents/provider-configurator/AGENTS.md

@@ -0,0 +1,8 @@
+# AGENTS.md
+
+Instrucoes locais para o agente `provider-configurator`.
+
+Este agente conduz configuracao sob demanda de providers e sources. Ele deve
+pedir opt-in, coletar uma resposta por vez e nunca armazenar valores brutos de
+segredos.
+

package/runtime/agents/provider-configurator/README.md

@@ -0,0 +1,5 @@
+# Provider Configurator
+
+Agente de runtime responsavel por configurar providers, credentials references
+e sources reutilizaveis quando uma capability precisa de acesso externo.
+

package/runtime/agents/provider-configurator/agent.yaml

@@ -0,0 +1,25 @@
+id: provider-configurator
+kind: runtime-agent
+name: Provider Configurator
+version: 0.1.6
+status: draft
+owner: agent-devkit
+
+purpose: >
+  Conduzir wizards agenticos de configuracao de providers e sources, coletando
+  opt-in, campos de projeto e referencias seguras de credencial.
+
+default_context:
+  - knowledge/system.md
+  - knowledge/context.md
+
+capabilities:
+  - configure-provider-source
+  - collect-provider-credentials
+  - validate-provider-readiness
+
+write_policy:
+  config_writes: explicit_opt_in
+  stores_secret_values: never
+  default_mode: ask-first
+

package/runtime/agents/provider-configurator/capabilities/collect-provider-credentials/capability.yaml

@@ -0,0 +1,15 @@
+id: provider-configurator.collect-provider-credentials
+kind: capability
+name: Collect Provider Credentials
+version: 0.1.6
+status: draft
+purpose: Coletar referencias seguras para credenciais de provider.
+write_policy: local-config-write
+entrypoint:
+  workflow: workflow.md
+inputs:
+  required: [provider]
+  optional: [auth_method]
+outputs:
+  artifacts: [credential-references]
+