Blueprint Schema¶

Governance blueprint format and examples.

Overview¶

Blueprints define governance policies, evaluation criteria, and intervention rules for specific use cases.

Basic Blueprint Structure¶

blueprint:
  name: "customer-service-v1"
  version: "1.0.0"
  description: "Governance for customer service agents"

  acl_tier: "ACL-2"

  tripwires:
    max_refund: 500
    max_discount_percent: 20
    daily_action_limit: 100

  evaluation_criteria:
    reasoning_quality_weight: 0.4
    action_appropriateness_weight: 0.3
    policy_compliance_weight: 0.2
    risk_assessment_weight: 0.1

  intervention_thresholds:
    ok: 0.9
    nudge: 0.7
    flag: 0.5
    escalate: 0.3
    block: 0.1

  policies:
    - name: "refund_policy"
      description: "Refunds require valid reason"
      rules:
        - action: "issue_refund"
          require_field: "reason"
          max_amount: 500

Example Blueprints¶

Customer Service¶

blueprint:
  name: "customer-service"
  acl_tier: "ACL-2"
  tripwires:
    max_refund: 500
    max_discount: 20

Financial Trading¶

blueprint:
  name: "financial-trading"
  acl_tier: "ACL-4"
  tripwires:
    max_transaction: 10000
    daily_limit: 50000
    require_approval_above: 5000

See ACGP-1004: Blueprints for complete specification

Error Codes See Specification