agent-builder/scripts/templates/governance/GOVERNANCE.md
Kjell Tore Guttormsen 912689f3c5 feat(templates): add governance and approval gate templates (Paperclip pattern)
Session 4 step 17 — 5 autonomy levels (0-4), PreToolUse approval-gate
hook polls approval-responses.jsonl with 60s timeout, blocks on no-response.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-12 06:55:33 +02:00

1.3 KiB

Governance: {{PROJECT_NAME}}

Autonomy Levels

  • Level 0: Full manual approval (all tool calls require human OK)
  • Level 1: Auto-approve safe operations (Read, Glob, Grep)
  • Level 2: Auto-approve file operations (+ Write, Edit within project)
  • Level 3: Auto-approve all except destructive (+ Bash non-destructive)
  • Level 4: Full autonomy with hooks as guardrails

Current level: {{AUTONOMY_LEVEL}}

Approval Gates

Gates are checkpoints where the agent MUST pause and request human approval.

  • {{GATE_1_NAME}}: {{GATE_1_CONDITION}} Action: {{GATE_1_ACTION}}
  • {{GATE_2_NAME}}: {{GATE_2_CONDITION}} Action: {{GATE_2_ACTION}}

Escalation Rules

  • Budget exceeded: pause agent, notify via {{NOTIFICATION_METHOD}}
  • Error threshold: after {{ERROR_THRESHOLD}} consecutive errors, pause agent
  • Unknown tool call: block and log
  • Scope violation: block and notify

Audit Requirements

  • All tool calls logged to audit.log
  • Budget events logged to cost-events.jsonl
  • Approval decisions logged to approvals.log
  • Retention: {{LOG_RETENTION_DAYS}} days

Philosophy

Autonomy is a privilege you grant. Start at Level 0 and increase only when the agent has demonstrated reliable behavior at the current level. Each level adds capability while hooks maintain the guardrails.