docs: declare institutional architecture boundary

2026-08-01 17:48:38 +02:00
parent a89c39862a
commit 3aaa842ee6
2 changed files with 51 additions and 0 deletions
@@ -0,0 +1,16 @@
+# 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.