From 912db10a8a3eef36aa6067437cdafa4659bb7e4c Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Sat, 1 Aug 2026 17:48:39 +0200
Subject: [PATCH] docs: declare institutional architecture boundary

---
 AGENTS.md                               |  6 ++++++
 src/govoplan_search/backend/manifest.py | 15 +++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index ad4f9ca..bd442e7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,11 @@
 # govoplan-search 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 Search 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 module owns global and contextual search aggregation, the built-in
diff --git a/src/govoplan_search/backend/manifest.py b/src/govoplan_search/backend/manifest.py
index c8649d8..886d140 100644
--- a/src/govoplan_search/backend/manifest.py
+++ b/src/govoplan_search/backend/manifest.py
@@ -21,6 +21,7 @@ from govoplan_core.core.modules import (
     PermissionDefinition,
     RoleTemplate,
 )
+from govoplan_core.core.provider_governance import declared_module_architecture
 from govoplan_core.core.search import (
     CAPABILITY_SEARCH_INDEX_WRITER,
     SearchProviderRegistration,
@@ -209,6 +210,20 @@ manifest = ModuleManifest(
             order=12,
         ),
     ),
+    architecture=declared_module_architecture(
+        layer="governance_accountability",
+        kind="runtime",
+        maturity="vertical_slice",
+        documentation_ref="README.md",
+        test_ref="tests/test_postgres_search.py",
+        known_limits=("The built-in PostgreSQL index is implemented; optional OpenSearch target evidence is not.",),
+        supported_authority_modes=("external_mirror",),
+        owned_concepts=("derived search index", "search ACL projection", "index change queue"),
+        non_owned_concepts=("source object", "source authorization", "external search engine"),
+        recovery_docs=("README.md",),
+        security_docs=("README.md",),
+        operations_docs=("README.md",),
+    ),
 )