From ca684fb4b366209dd619c3da6141b13249b5b52a Mon Sep 17 00:00:00 2001
From: LeanAgent <leanagent@webmakers.local>
Date: Mon, 12 Oct 2026 16:10:18 +0000
Subject: [PATCH] feat(schema): meta.agent in Collection- und Projekt-Schema
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Die Starter-Collections dokumentieren Editor-Workflows in meta.agent
(tibi-server spielt das ueber MCP/REST _meta aus), die Schemas kannten
den Schlüssel aber nicht – YAML-LS meldete 'Property agent is not
allowed'. agent ist bewusst freiform (additionalProperties: true),
damit die Doku nicht wieder hinterherhinkt.
---
 schemas/config/collection-meta.schema.json | 34 ++++++++++++++++++++++
 schemas/config/project.schema.json         | 28 ++++++++++++++++++
 2 files changed, 62 insertions(+)

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"
+              }
+            }
+          }
         }
       }
     },