diff --git a/AGENTS.md b/AGENTS.md index cf4b9a0..dbb2851 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,5 +1,11 @@ # GovOPlaN Dataflow Codex Guide +## 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 Dataflow internals. +- Maintain a static user/admin baseline and run `/mnt/DATA/git/govoplan/tools/checks/check-manifest-shapes.py` after behavior or manifest changes. + ## Scope This repository owns canonical pipeline definitions, immutable revisions, diff --git a/src/govoplan_dataflow/backend/manifest.py b/src/govoplan_dataflow/backend/manifest.py index facb7d2..2540fcd 100644 --- a/src/govoplan_dataflow/backend/manifest.py +++ b/src/govoplan_dataflow/backend/manifest.py @@ -29,6 +29,7 @@ from govoplan_core.core.modules import ( PermissionDefinition, RoleTemplate, ) +from govoplan_core.core.provider_governance import declared_module_architecture from govoplan_core.core.datasources import ( CAPABILITY_DATASOURCE_CATALOGUE, CAPABILITY_DATASOURCE_LIFECYCLE, @@ -425,6 +426,19 @@ manifest = ModuleManifest( ), ), documentation=DOCUMENTATION, + architecture=declared_module_architecture( + layer="data_reporting_integration", + kind="runtime", + maturity="vertical_slice", + documentation_ref="README.md", + test_ref="tests/test_golden_flows.py", + known_limits=("Execution adapters and operator recovery evidence do not yet cover every declared node family.",), + owned_concepts=("dataflow definition", "dataflow revision", "dataflow run", "transformation graph"), + non_owned_concepts=("datasource binding", "connector transport", "report presentation", "workflow task"), + recovery_docs=("README.md",), + security_docs=("README.md",), + operations_docs=("README.md",), + ), )