Runbook | Acionar Agente
Guia para quando e como acionar o Axios (agente core de governança) ou um dos 26 agentes operacionais Costal. Usar antes de: pedir algo para Axios, começar a trabalhar com um agente operacional pela primeira vez, ou quando o output de um agente não está fazendo sentido.
Parte A — Acionar o Axios
Quando acionar
Axios é o orquestrador de governança. Use para:
| Pergunta típica | Exemplo |
|---|---|
| Status atual do projeto | ”Me dá um brief operacional da semana” |
| Consolidação de camadas canônicas | ”O que mudou em riscos nos últimos 7 dias?” |
| Auditoria de cobertura | ”Quais reuniões não tiveram sinais promovidos?” |
| Navegação semântica | ”Onde está documentada a decisão sobre Sienge ser ERP core?” |
| Síntese cross-frente | ”Quais dependências da Costal bloqueiam frente Colliers?” |
Quando não usar
- Decisões estratégicas — são de Pedro, não de agente
- Comunicação externa (Slack, email para cliente) — Pedro é único porta-voz
- Criação de camada canônica nova sem autorização explícita (ver MEMORY-CONTRACT §3.1)
- Tarefas que exigem criatividade estratégica ou design de arquitetura (usar agente humano)
Como acionar
- Definir a pergunta concreta: termine com ”?” e especifique o formato desejado (“em tabela”, “em 3 bullets”, “em prose curta”).
- Apontar o contexto fonte: mencionar o(s) arquivo(s) canônico(s) que Axios deve consultar primeiro. Axios já lê vault inteiro mas a dica acelera.
- Definir o destino: o output vai para arquivo existente, ou é só uma resposta no chat? Se arquivo, qual?
Expectativas de output
| Tipo | Onde é gravado | Atualização |
|---|---|---|
| Daily status | daily-status | Diária |
| Weekly brief | weekly-brief | Semanal (seg) |
| Weekly risks | weekly-risks | Semanal (seg) |
| Open gaps snapshot | open-gaps | Semanal + ad-hoc |
| Dependency map | dependency-map | Ad-hoc + quando mudança material |
| Governance audit | governance-audit | Semanal |
Todos esses são snapshots derivados — não são canônicos. Para o estado “oficial”, ler camadas canônicas.
Parte B — Acionar um agente operacional Costal
Antes de acionar
Verificar em catálogo de agentes qual é o agente certo para a tarefa.
26 agentes em 8 áreas:
- Comercial — gate, guardian, hunter, pulse
- Orçamentação — atlas, draft
- Legal & Compliance — integrity, sentinel
- Planejamento — compass, hit, viz
- Execução — check, safewatch, trace, visor
- Suprimentos — logflow, source, stock
- Financeiro — apex, king, payroll
- Pessoas & Sustentabilidade — eco, grower, scout, vita, warranty
Status de cada agente
Antes de acionar, ler o arquivo <agente>.md (folder note) e conferir:
- Status:
design|piloto|producao— se ainda está em design, ele não está operacional - Dono humano: quem responde por ele — contactar antes de fazer demandas novas
- Escopo de leitura (MEMORY-CONTRACT §3.2): só pode escrever na própria pasta; leitura restrita ao escopo documentado
Como acionar
- Verificar escopo: o que você está pedindo está dentro da função definida do agente?
- Definir input: que dados fonte o agente precisa? Onde estão no vault? (Ex: “use o orçamento em
04-referencia/pdfs/obra-nubank.pdf”) - Definir output esperado: formato, onde gravar, critério de aceite
- Registrar a tarefa: se não-trivial, criar entrada em TASKS linkando a pasta do agente
Se o output não faz sentido
Escalar para:
- Dono humano do agente (definido no frontmatter dele)
- Se persistir, Pedro
- Registrar o incidente em
agentes-core/axios/memory/feedback/(Axios consome para calibrar)
Parte C — Regras de ouro para qualquer agente
- Nenhum agente fala externamente. Pedro é único porta-voz com cliente/board.
- Nenhum agente escreve em camada canônica sem autorização explícita de Pedro por item.
- Todo output de agente é rastreável: deve ter origem linkada (arquivo fonte), modelo usado, data.
- Dado sensível (
#sensivel) não circula entre agentes — bloqueado na publicação e no handoff. - Axios nunca renomeia ou apaga arquivos sem autorização.
Critério de pronto (de uma sessão de acionamento)
- Tarefa enviada ao agente está dentro do escopo dele
- Input está documentado (quais arquivos foram fontes)
- Output foi para o destino correto (arquivo sugerido no runbook ou TASKS.md)
- Se gerou novo sinal material: promover via runbook-promover-sinais
Ver também
- Axios — Chief of Staff digital
- system-prompt
- operating-model
- security-guardrails
- Catálogo de agentes Costal
- MEMORY-CONTRACT §3 (matriz de permissões)