govoplan-policy/AGENTS.md

GovOPlaN Policy Codex Guide

Scope

This repository owns hierarchical policy evaluation, explicit overrides, provenance, simulation, and typed governance capabilities for consuming modules.

Documentation Contract

• Treat documentation as part of every behavior change. Update this module's manifest-driven DocumentationTopic contributions for affected user and administrator behavior.
• Keep feature content here; govoplan-docs projects it without importing Policy internals.
• Maintain a static user/admin baseline and run /mnt/DATA/git/govoplan/tools/checks/check-manifest-shapes.py after behavior or manifest changes.

Boundaries

• Policy returns explainable decisions; consuming modules enforce them and own business state.
• Lower scopes may narrow inherited ceilings but must not silently loosen them.