Dev Mode Quickstart

Add governance to your agent in 5 minutes. Dev Mode is for learning, development, and batch jobs — not a v1.0 conformance claim.

Development/Learning Only

Designed for: Learning, development, batch jobs
Not for: Production interactive apps, user-facing systems

For production deployments, use Standard Conformance.

---

Step 1: Install

pip install acgp-sdk

---

Step 2: Create Blueprint

Create a minimal Blueprint source file:

blueprint.yaml

artifact_type: acgp.blueprint
schema_version: "2.0.0"
id: quickstart/dev@2.0
version: "2.0.0"
title: "Dev quickstart blueprint"
description: "Minimal blueprint for learning and local iteration"

tripwires:
  - id: max_spend
    when:
      hook: tool_call
      tool: purchase
    condition: "args.amount > 1000"
    on_fail:
      decision: block
      reason: "Purchases over $1000 require approval"

checks: []

intervention_policy:
  thresholds:
    ok: 0.25
    nudge: 0.40
    escalate: 0.55

This quickstart uses the canonical public model: author policy in a Blueprint and evaluate traces through GovernanceSteward.

For production authoring, use the canonical schema in Blueprint Schema Reference.

---

Step 3: Use It

from acgp import GovernanceSteward, CognitiveTrace

# Initialize steward with policy file
steward = GovernanceSteward(
    blueprint_file="blueprint.yaml",
    conformance_level="dev_mode"  # Dev Mode — canonical API value for learning and development, not a v1.0 conformance claim
)

# Your agent decides to take an action
trace = CognitiveTrace(
    reasoning="User wants to buy item",
    action="purchase",
    parameters={"amount": 500}
)

# Check with governance
result = steward.evaluate(trace)

if result.intervention == "ok":
    execute_purchase(500)
    print(" Purchase approved")
elif result.intervention == "block":
    print(f"⊗ Blocked: {result.message}")

That's it! Everything else is optional.

---

What You Just Did

Blueprint-authored governance - A source blueprint defines the policy surface
Two intervention types - OK (allow) and BLOCK (prevent)
Local evaluation - No network calls, <10ms latency
Single-file setup - One blueprint file plus one steward instance

---

Ready for production? → Standard Quickstart

---

Next Steps

• Standard Quickstart

  ---

  Upgrade to Standard with Runtime Governance Contracts and full production guidance

  Standard Quickstart

• Learn Concepts

  ---

  Understand why ACGP exists and what problems it solves

  Concepts Overview