diff --git a/schemas/config/collection-meta.schema.json b/schemas/config/collection-meta.schema.json
index eb986d4..770bbe6 100644
--- a/schemas/config/collection-meta.schema.json
+++ b/schemas/config/collection-meta.schema.json
@@ -464,6 +464,40 @@
     },
     "openapi": {
       "$ref": "openapi.schema.json"
+    },
+    "agent": {
+      "description": "Editor- und Agenten-Dokumentation (Zweck, Workflows, Gotchas). Freiform-Doku, wird u.a. ueber MCP/REST _meta ausgespielt.",
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "purpose": {
+          "type": "string"
+        },
+        "instructions": {
+          "type": "string"
+        },
+        "fieldHints": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "examples": {
+          "type": "array"
+        },
+        "workflows": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "hints": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
     }
   }
 }
\ No newline at end of file
diff --git a/schemas/config/project.schema.json b/schemas/config/project.schema.json
index 5b0c8fe..7564995 100644
--- a/schemas/config/project.schema.json
+++ b/schemas/config/project.schema.json
@@ -98,6 +98,34 @@
         },
         "openapi": {
           "$ref": "openapi.schema.json"
+        },
+        "agent": {
+          "description": "Projektweite Editor- und Agenten-Dokumentation (Routen, Lookups, Workflows, Gotchas). Freiform-Doku, wird u.a. ueber MCP/REST _meta ausgespielt.",
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "description": {
+              "type": "string"
+            },
+            "frontend": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              }
+            },
+            "workflows": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "hints": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
         }
       }
     },