🎓 Tutorial: Policy-as-Code for AI Agents — From Zero to Production

[imran-siddique]

Overview

Create a comprehensive tutorial teaching the policy-as-code approach for governing AI agents, progressing from simple to production-grade policies.

Chapters

1. Your First Policy — Allow/deny basics
2. Capability Scoping — Restricting tool access by agent role
3. Rate Limiting — Preventing runaway agents
4. Conditional Policies — Environment-aware rules (dev vs prod)
5. Approval Workflows — Human-in-the-loop for sensitive actions
6. Policy Testing — Validating policies before deployment
7. Policy Versioning — Managing policy lifecycle

Deliverable

• Multi-part tutorial in docs/tutorials/policy-as-code/
• Code examples for each chapter
• Policy YAML templates

Skills Needed

• YAML familiarity
• Basic Python (for running examples)

[harinarayansrivatsan]

Hi, I'd like to work on this issue.

I have Chapters 1-3 ready with runnable Python examples and YAML templates. I plan to submit them as a first PR, then follow up with Chapters 4-7 after feedback.

One question: I placed code examples and YAML templates in an examples/ subfolder to keep .md and .py/.yaml files separate. Would you prefer them flat in the policy-as-code/ directory instead?