diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..6df503f
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,16 @@
+# GovOPlaN Workflow Codex Guide
+
+## Scope
+
+This repository owns the workflow editing and inspection experience, including BPMN-compatible native graph authoring and module-provided definition views.
+
+## 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 Workflow 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
+
+- `govoplan-workflow-engine` owns headless definitions, versions, execution, and resumable runtime state.
+- The editor must consume engine contracts without duplicating execution semantics.
diff --git a/src/govoplan_workflow/backend/manifest.py b/src/govoplan_workflow/backend/manifest.py
index 2d49d53..96a87a1 100644
--- a/src/govoplan_workflow/backend/manifest.py
+++ b/src/govoplan_workflow/backend/manifest.py
@@ -10,6 +10,7 @@ from govoplan_core.core.modules import (
NavItem,
ViewSurface,
)
+from govoplan_core.core.provider_governance import declared_module_architecture
from govoplan_workflow_engine.backend.manifest import (
ADMIN_SCOPE,
DEFINITION_READ_SCOPE,
@@ -111,6 +112,17 @@ manifest = ModuleManifest(
order=76,
),
),
+ architecture=declared_module_architecture(
+ layer="human_work_procedure",
+ kind="editor",
+ maturity="vertical_slice",
+ documentation_ref="docs/ENGINE_EDITOR_SPLIT.md",
+ test_ref="tests/test_manifest.py",
+ known_limits=("The editor intentionally cannot execute definitions without Workflow Engine and target-tested adapters.",),
+ owned_concepts=("workflow editing surface", "workflow revision inspection", "workflow activation controls"),
+ non_owned_concepts=("workflow definition persistence", "workflow instance execution", "domain action"),
+ security_docs=("docs/CONCEPT.md",),
+ ),
)
diff --git a/webui/src/features/workflow/WorkflowPage.tsx b/webui/src/features/workflow/WorkflowPage.tsx
index 8732959..7d20ef8 100644
--- a/webui/src/features/workflow/WorkflowPage.tsx
+++ b/webui/src/features/workflow/WorkflowPage.tsx
@@ -1076,7 +1076,11 @@ function WorkflowStandardComparisonDialog({
{error}
) : null}
- {!error && !comparison ?