Skip to content

Latest commit

 

History

History

primitives

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

title Primitives
description Catalog of reusable agent primitives.
permalink /primitives/

Primitivas de Agentes — Conceitos e Catálogo

Este diretório registra contratos reutilizáveis que já aparecem em código, testes, guias ou operação recorrente. Uma primitiva aqui deve ser pequena o bastante para ser testada e clara o bastante para sobreviver a engines diferentes.

O que são Primitivas de Agentes?

Primitivas de agentes são blocos de construção reutilizáveis para decisões, gates, packets, métricas e superfícies de operação. Elas não são ideias soltas: precisam declarar fronteira, evidência, validação e critério de promoção.

Categorias de Primitivas

Memória e continuidade

Como agentes armazenam, recuperam e gerenciam contexto ao longo do tempo.

  • Memória de Contexto — janela de contexto da conversa atual
  • Memória Episódica — histórico de interações passadas
  • Memória Semântica — conhecimento estruturado e factual
  • Memória de Trabalho — estado temporário durante uma tarefa

Ferramentas e superfícies

Como agentes interagem com o mundo externo.

  • Leitura de Arquivos — acesso ao sistema de arquivos
  • Execução de Código — rodar scripts e comandos
  • Busca — recuperar informações de fontes externas
  • APIs — integração com serviços externos
  • Comunicação — enviar mensagens, notificações

Planejamento e decisão

Como agentes decompõem e executam tarefas complexas.

  • ReAct — ciclos de Reason + Act
  • Task Decomposition — divisão hierárquica de tarefas
  • Reflection — auto-avaliação e correção

Coordenação

Como múltiplos agentes colaboram.

  • A2A (Agent-to-Agent) — protocolos de comunicação entre agentes
  • Orquestração — agente coordenador que dirige outros agentes
  • Especialização — agentes com papéis bem definidos
  • Consenso — mecanismos de decisão coletiva

Avaliação e governança

Como medir e garantir a qualidade de agentes.

  • Evals — suítes de avaliação automatizada
  • Observabilidade — rastreamento e logging de execuções
  • Benchmarks — métricas de desempenho padronizadas

Catálogo de Primitivas do Laboratório

Primitiva Categoria Descrição Status
[primitive-proposal-template.md]({{ '/primitives/primitive-proposal-template.html' relative_url }}) Governança / Qualidade / Manutenção Template canônico para propor nova primitiva com recorrência, contrato mínimo, testes, rollback e critérios `promote
[budget-envelope.md]({{ '/primitives/budget-envelope.html' relative_url }}) Avaliação / Coordenação / Planejamento Contrato de custo por execução (goal + maxCost + evidência + revisão do operador)
[continuity-abstraction.md]({{ '/primitives/continuity-abstraction.html' relative_url }}) Memória / Coordenação / Governança Continuidade desacoplada de backend/runner com contrato canônico de estado/eventos/gates
[context-economy-calibration.md]({{ '/primitives/context-economy-calibration.html' relative_url }}) Memória / Observabilidade / Governança Contrato evidence-first para calibrar técnicas de janela de contexto, cache, preload e compactação sem transformar ajuste local em regra global
[conversation-event-canonical-schema.md]({{ '/primitives/conversation-event-canonical-schema.html' relative_url }}) Memória / Coordenação / Observabilidade Schema canônico provider-agnostic para ingestão/triagem de conversas e threads
[nudge-free-local-continuity.md]({{ '/primitives/nudge-free-local-continuity.html' relative_url }}) Planejamento / Governança / Continuidade Perfil local para continuidade sem empurrão em batches de 3-5 fatias, checkpoint/commit por fatia e sem escopos protegidos automáticos
[colony-promotion-decision-packet.md]({{ '/primitives/colony-promotion-decision-packet.html' relative_url }}) Planejamento / Governança / Coordenação Packet read-only para decisão do operador promote/skip/defer de um único candidate de colony antes de qualquer materialização
[lane-brainstorm-packet.md]({{ '/primitives/lane-brainstorm-packet.html' relative_url }}) Planejamento / Governança / Continuidade Contrato report-only para transformar brainstorm em lane local-safe com recommendationCode/nextAction e sem dispatch
(runtime) delegation_lane_capability_snapshot Governança / Planejamento / Continuidade Snapshot read-only de capacidade de delegação (preload/dirty/classify-failures/subagents) com decisão `ready needs-evidence
(runtime) delegation_mix_score Observabilidade / Governança / Coordenação Métrica read-only de diversidade de execução/delegação (local/manual/delegate/swarm) com recommendationCode determinístico Inicial
(runtime) delegate_or_execute_decision_packet Decisão / Governança / Execução Packet report-only para recomendar `local-execute delegate
[autonomy-protected-scope-report.md]({{ '/primitives/autonomy-protected-scope-report.html' relative_url }}) Governança / Transparência / Continuidade Relatório report-only com reason codes e evidências curtas para classificação protected-scope no seletor autônomo
[autonomy-protected-focus-packet.md]({{ '/primitives/autonomy-protected-focus-packet.html' relative_url }}) Governança / Decisão / Continuidade Packet report-only para decisão do operador `promote
[protected-canary-local-slice.md]({{ '/primitives/protected-canary-local-slice.html' relative_url }}) Governança / Execução / Segurança Contrato mínimo para uma fatia local protected canário com rollback, validação focal e stop conditions explícitas
[model-infrastructure-routing.md]({{ '/primitives/model-infrastructure-routing.html' relative_url }}) Governança / Modelo / Custo / Decisão Contrato report-only para tiers de roteamento, evidence packets, canary protegido e estados de maturidade antes de qualquer ativação de TASK-BUD-849
[external-influence-intake-template.md]({{ '/primitives/external-influence-intake-template.html' relative_url }}) Pesquisa / Governança / Continuidade Intake target-agnostic e validável para transformar referência externa em trabalho local/worker-ready antes de qualquer promoção protected
[shell-spoofing-coverage-score.md]({{ '/primitives/shell-spoofing-coverage-score.html' relative_url }}) Segurança / Governança / Manutenção Score report-only da cobertura anti-spoofing de variáveis shell (policy/runtime/regressão/observabilidade)
[operator-confirmation-signal.md]({{ '/primitives/operator-confirmation-signal.html' relative_url }}) Segurança / Governança / Execução Contrato para evidência estruturada de confirmação do operador sem transformar texto livre em autorização
[background-process-readiness-score.md]({{ '/primitives/background-process-readiness-score.html' relative_url }}) Operação / Governança / Qualidade Score report-only de prontidão de background process por capacidades/surface/evidência operacional
[agents-as-tools-calibration-score.md]({{ '/primitives/agents-as-tools-calibration-score.html' relative_url }}) Governança / Operação / Qualidade Score report-only de calibração de agents-as-tools (governance/boundedness/observability)
[agent-run-driver-step.md]({{ '/primitives/agent-run-driver-step.html' relative_url }}) Execução / Operação / Observabilidade Primitiva agnóstica para preview, dispatch, follow e outcome de um único agent run bounded sem fan-in automático
[agent-worker-envelope.md]({{ '/primitives/agent-worker-envelope.html' relative_url }}) Execução / Governança / Observabilidade Contrato distribuível e runtime-agnóstico para um worker single-run com declared files, aprovação, registry, log, follow, outcome e touchedFiles
[agent-worker-isolation.md]({{ '/primitives/agent-worker-isolation.html' relative_url }}) Execução / Segurança / Governança Contrato agnóstico de isolamento para worker bounded com níveis, checks e blockers portáveis antes do spawn
[ops-calibration-decision-packet.md]({{ '/primitives/ops-calibration-decision-packet.html' relative_url }}) Governança / Operação / Decisão Packet report-only que compõe scores de background+agents para decidir keep-report-only vs bounded rehearsal
[background-process-control.md]({{ '/primitives/background-process-control.html' relative_url }}) Operação / Governança / Segurança Contrato local-first para planejar processos em background sem autorizar start/stop/restart automático
[development-velocity-pressure.md]({{ '/primitives/development-velocity-pressure.html' relative_url }}) Operação / Governança / Continuidade Sinais para reduzir superfície, checkpointar ou reiniciar sessão quando o control plane começa a desacelerar o trabalho
[growth-maturity-score-packet.md]({{ '/primitives/growth-maturity-score-packet.html' relative_url }}) Governança / Qualidade / Escala Packet report-only para decisão `go
[quality-verification-gate.md]({{ '/primitives/quality-verification-gate.html' relative_url }}) Qualidade / Governança / Evidência Gate language-agnostic para exigir evidência verificável antes de promover ou concluir fatias estratégicas
[tool-hygiene.md]({{ '/primitives/tool-hygiene.html' relative_url }}) Ferramentas / Qualidade / Manutenção Scorecard report-only para higiene sintática, line budget e exceções justificadas em ferramentas
[board-task-dependencies-contract.md]({{ '/primitives/board-task-dependencies-contract.html' relative_url }}) Planejamento / Governança / Qualidade Contrato determinístico para update de dependências no board com recommendationCode e bloqueios canônicos (missing/cycle/protected-coupling)
[board-dependency-health-snapshot.md]({{ '/primitives/board-dependency-health-snapshot.html' relative_url }}) Planejamento / Governança / Observabilidade Snapshot report-only da saúde de dependências (missing/cycle/protected-coupling) com filtro por milestone
[board-dependency-hygiene-score.md]({{ '/primitives/board-dependency-hygiene-score.html' relative_url }}) Planejamento / Governança / Qualidade Score report-only de higiene de dependências com dimensões de acoplamento/consistência/rastreabilidade
[board-planning-clarity-score.md]({{ '/primitives/board-planning-clarity-score.html' relative_url }}) Planejamento / Governança / Qualidade Score report-only de clareza/direção de planejamento (decomposição, verificabilidade, foco e rationale)
[project-intake.md]({{ '/primitives/project-intake.html' relative_url }}) Planejamento / Governança / Continuidade Triagem inicial universal report-only para classificar projeto e sugerir primeira fatia local-safe sem autorização implícita
[emergent-tangent-capture.md]({{ '/primitives/emergent-tangent-capture.html' relative_url }}) Coordenação / Governança / Continuidade Registro de trabalho emergente aprovado com proveniência explícita no board (origin, source_task, reason)
[textual-evaluation-discourse-check.md]({{ '/primitives/textual-evaluation-discourse-check.html' relative_url }}) Avaliação / Governança / Qualidade Check textual para separar linguagem de conversa, claims canônicos e evidência antes de promover docs ou vault projections
[capability-gap-claim.md]({{ '/primitives/capability-gap-claim.html' relative_url }}) Coordenação / Ferramentas / Governança Detecta ausência de ferramenta/capability e exige claim de bootstrap/permissão antes da execução principal

Princípios de Design

  1. Composabilidade — primitivas devem se combinar naturalmente.
  2. Engine-agnóstico — contratos não devem depender de uma runtime quando isso puder ser evitado.
  3. Testabilidade — cada primitiva deve ter teste ou gate focal quando virar superfície operacional.
  4. Documentação — cada primitiva precisa dizer como é usada e quando não deve ser usada.
  5. Minimalismo — fazer uma coisa bem, sem dependências ou nomes duplicados.