@caoscompanybr/merlin 3.5.0

package/.merlin-core/schemas/agent-schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "agent-schema.json",
+  "title": "Merlin Agent Definition Schema",
+  "description": "Validates agent definition files in .merlin-core/development/agents/",
+  "type": "object",
+  "required": ["frontmatter"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["name", "display_name", "description", "tools", "model"],
+      "properties": {
+        "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+        "display_name": { "type": "string" },
+        "description": { "type": "string" },
+        "tools": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["Read", "Grep", "Glob", "Write", "Edit", "Bash", "WebSearch", "WebFetch"]
+          }
+        },
+        "model": { "type": "string", "enum": ["opus", "sonnet", "haiku"] },
+        "auto_activate": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/.merlin-core/schemas/command-schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "command-schema.json",
+  "title": "Merlin Slash Command Schema",
+  "description": "Validates slash command markdown files in .merlin-core/commands/",
+  "type": "object",
+  "required": ["frontmatter"],
+  "properties": {
+    "frontmatter": {
+      "type": "object",
+      "required": ["description"],
+      "properties": {
+        "description": { "type": "string", "minLength": 10 },
+        "model": { "type": "string", "enum": ["opus", "sonnet", "haiku"] }
+      }
+    }
+  }
+}

package/.merlin-core/schemas/feedback-schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Merlin Feedback",
+  "description": "Granular approve/reject feedback the agent records when the user accepts or rejects a suggestion. Consulted before re-suggesting (consult-before-suggest); promoted to learnings/decisions over time. FIFO-capped per domain (newest 30 kept). v3.4 immune system.",
+  "type": "object",
+  "required": ["title", "date", "domain", "decision"],
+  "properties": {
+    "title": { "type": "string", "minLength": 5 },
+    "date": { "type": "string", "format": "date" },
+    "domain": {
+      "type": "string",
+      "description": "Feedback domain (e.g., content, tasks, recommendations, tone)"
+    },
+    "decision": {
+      "enum": ["approve", "reject"],
+      "description": "Whether the user approved or rejected the suggestion"
+    },
+    "reason": {
+      "type": "string",
+      "description": "Why it was approved/rejected — the signal that prevents repeating the mistake"
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Keywords for retrieval (domain + type)"
+    },
+    "source_agent": {
+      "type": "string",
+      "description": "Agent that made the suggestion"
+    },
+    "project": {
+      "type": "string",
+      "description": "Project this feedback applies to"
+    }
+  }
+}

package/.merlin-core/schemas/handoff-schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Merlin Handoff",
+  "description": "Session handoff document for context continuity across sessions (Constitution VIII)",
+  "type": "object",
+  "required": ["title", "date", "status"],
+  "properties": {
+    "title": { "type": "string", "minLength": 5 },
+    "date": { "type": "string", "format": "date" },
+    "tags": { "type": "array", "items": { "type": "string" } },
+    "project": { "type": "string" },
+    "status": { "enum": ["active", "concluded"], "default": "active" },
+    "concluded_date": { "type": "string", "format": "date" },
+    "source_agent": { "type": "string", "description": "Agent ID that created the handoff" },
+    "target_agent": { "type": "string", "description": "Intended recipient agent ID" },
+    "linked_plans": { "type": "array", "items": { "type": "string" } },
+    "linked_learnings": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/.merlin-core/schemas/learning-schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Merlin Learning",
+  "description": "Domain-specific knowledge captured by agents for cross-agent retrieval by area of action (Constitution VIII)",
+  "type": "object",
+  "required": ["title", "date", "domain", "category"],
+  "properties": {
+    "title": { "type": "string", "minLength": 5 },
+    "date": { "type": "string", "format": "date" },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Granular keywords for RAG scoring — the more precise, the better retrieval"
+    },
+    "domain": {
+      "type": "string",
+      "description": "Broad area of action (e.g., database, auth, api, build, frontend, deployment, infra, testing)"
+    },
+    "category": {
+      "enum": ["gotcha", "pattern", "convention", "constraint", "insight", "workaround"],
+      "description": "Type of learning: gotcha (trap/pitfall), pattern (reusable approach), convention (team/project norm), constraint (hard limit), insight (understanding), workaround (temporary fix)"
+    },
+    "confidence": {
+      "enum": ["observed", "verified", "assumed"],
+      "default": "observed",
+      "description": "How certain: observed (seen once), verified (confirmed multiple times), assumed (inferred but not tested)"
+    },
+    "ttl": {
+      "enum": ["permanent", "30d"],
+      "default": "permanent",
+      "description": "Retention: permanent (🔒 strategic — philosophy/architecture, never expires) or 30d (⏳ tactical — bug/workaround that goes stale; auto-expires after 30 days)"
+    },
+    "source_agent": {
+      "type": "string",
+      "description": "Agent ID that discovered this learning (e.g., dev, architect, qa, researcher)"
+    },
+    "project": {
+      "type": "string",
+      "description": "Which project this applies to (for multi-project Merlin installs)"
+    },
+    "applies_to": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Specific files, modules, APIs, or areas this learning is relevant to"
+    },
+    "supersedes": {
+      "type": "string",
+      "description": "Path to older learning this replaces — keeps knowledge fresh, prevents contradictions"
+    }
+  }
+}

package/.merlin-core/schemas/module.schema.json

@@ -0,0 +1,124 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://merlincompany.com.br/schemas/module.schema.json",
+  "title": "Merlin Module Manifest",
+  "description": "A Merlin Module: one logical capability (`id`) with two coordinated faces — the framework face (skills/agents/commands the operator uses) and the tenant face (the deployable/gateable unit installed in the client's environment). The `id` is the glue across entitlement → activation → provisioning. Two orthogonal axes: `kind` (what the module IS / how it is packaged) and `deploy_kind` (how it is provisioned). Lives at `.merlin-core/modules/<id>/module.json`, discovered by filesystem walk and validated by modules-catalog.mjs. See research/2026-06-14-merlin-modules-architecture.md.",
+  "type": "object",
+  "required": ["id", "name", "version", "kind", "deploy_kind", "tier_min"],
+  "additionalProperties": false,
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Logical module id — kebab/lower. Same string as the `modules.<id>` flag, the license feature, and the manifest directory name."
+    },
+    "name": { "type": "string", "minLength": 2, "description": "Human-readable module name." },
+    "description": { "type": "string", "description": "One-line, owner-voice value of the module (catalog copy)." },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Module version — independent of the framework version (semver)."
+    },
+    "kind": {
+      "type": "string",
+      "enum": ["in-platform", "standalone-app", "framework-capability"],
+      "description": "What the module IS / how it is packaged. in-platform = carve, flag-gated inside the shared platform. standalone-app = its own repo + (usually) its own cloud project. framework-capability = lives in .merlin-core (skills/commands/agents), installed by the copy-engine."
+    },
+    "deploy_kind": {
+      "type": "string",
+      "enum": ["firebase", "rails-kamal", "framework-skill", "browser-extension", "electron-app", "dedicated-infra"],
+      "description": "How the provisioner deploys it (ORTHOGONAL to kind). Dispatches provision-module.mjs. firebase = functions+rules+secrets+hosting+seed+flag. rails-kamal = provision CF + flag here, service via `kamal deploy` (operator runbook). framework-skill = NO cloud deploy — ship skills+command into the client's .merlin-core; soft-activate via config/modules.enabled[]. browser-extension/electron-app = build+distribute artifact (HIGH-stake). dedicated-infra = per-tenant stack on a VPS."
+    },
+    "tier_min": {
+      "type": "string",
+      "enum": ["mapa", "time", "comando"],
+      "description": "Minimum tier that can run the module. mapa = workspace, zero new cloud. time = client's own cloud project. comando = project + mirrored vault."
+    },
+    "depends_on": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": [],
+      "description": "Other module ids that must be installed first (checked before provisioning)."
+    },
+    "access_policy": {
+      "type": "string",
+      "enum": ["collaborator", "founder-deploy"],
+      "description": "Distribution policy for repo-backed modules. collaborator = the client receives the repo (their IP). founder-deploy = the operator clones/deploys; the client only gets the running instance. Required when kind=standalone-app."
+    },
+    "repo": {
+      "type": "string",
+      "description": "Git remote of the module's source (standalone-app). Distribution + entitlement (git access = the license)."
+    },
+    "pin": {
+      "type": "string",
+      "description": "Fixed tag/sha to install — NEVER a moving branch."
+    },
+    "framework": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "The framework face — what the operator gets in .merlin-core to OPERATE the capability.",
+      "properties": {
+        "skills": { "type": "array", "items": { "type": "string" }, "default": [] },
+        "agents": { "type": "array", "items": { "type": "string" }, "default": [] },
+        "commands": { "type": "array", "items": { "type": "string" }, "default": [] },
+        "checklists": { "type": "array", "items": { "type": "string" }, "default": [] }
+      }
+    },
+    "tenant": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "The tenant face — the deployable/gateable unit installed in the client's environment. Fields are deploy_kind-specific (additionalProperties allowed). Common fields documented below.",
+      "properties": {
+        "no_gcp": { "type": "boolean", "description": "framework-skill: true — no cloud deploy at all." },
+        "activation": { "type": "string", "description": "framework-skill: where the soft toggle lives, e.g. 'config/modules.enabled[] (L2)' (NOT a Firestore flag)." },
+        "secrets_vault_stubs": { "type": "array", "items": { "type": "string" }, "description": "framework-skill: secret names the client brings (empty stubs), e.g. APIFY_TOKEN." },
+        "preflight_gates": { "type": "array", "items": { "type": "string" }, "description": "Gates to run before the capability acts (e.g. identity-gate, lgpd-compliance-audit)." },
+        "frontend": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "routes": { "type": "array", "items": { "type": "string" } },
+            "hosting_target": { "type": ["string", "null"] }
+          }
+        },
+        "collections": { "type": "array", "items": { "type": "string" }, "description": "firebase: Firestore collections the module owns." },
+        "functions_codebase": { "type": ["string", "null"], "description": "firebase: named codebase in firebase.json for per-module deploy." },
+        "functions": { "type": "array", "items": { "type": "string" } },
+        "rules_fragment": { "type": ["string", "null"], "description": "firebase: path to the module's rules/<id>.rules fragment (composed with a test gate)." },
+        "indexes_fragment": { "type": ["string", "null"] },
+        "storage_paths": { "type": "array", "items": { "type": "string" } },
+        "secrets": { "type": "array", "items": { "type": "string" } },
+        "seed_script": { "type": ["string", "null"] },
+        "external_deps": { "type": "array", "items": { "type": "string" } },
+        "ragbase_corpus": { "type": ["string", "null"] },
+        "n8n_workflows": { "type": "array", "items": { "type": "string" } },
+        "template_repo": { "type": "string", "description": "standalone-app firebase: clone-not-carve source." },
+        "firebase_project": { "type": "string", "description": "standalone-app: one Firebase project per client (e.g. '{clientKey}')." },
+        "config_layer": { "type": "array", "items": { "type": "string" } },
+        "strip_on_package": { "type": "array", "items": { "type": "string" } },
+        "repo": { "type": "string", "description": "rails-kamal: service repo." },
+        "rag_sibling": { "type": "string" },
+        "deploy": { "type": "string", "description": "e.g. 'kamal'." },
+        "platform_seam": { "type": "string", "description": "where the platform integrates the external service." },
+        "provision_fn": { "type": "string", "description": "Cloud Function that provisions the tenant (rails-kamal/dedicated-infra)." },
+        "flag": { "type": "string", "description": "The modules.<id> flag this writes, when applicable." }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "kind": { "const": "standalone-app" } } },
+      "then": {
+        "required": ["access_policy"],
+        "description": "standalone-app modules must declare an access_policy (git access is the entitlement)."
+      }
+    },
+    {
+      "if": { "properties": { "deploy_kind": { "const": "framework-skill" } } },
+      "then": {
+        "required": ["framework"],
+        "description": "framework-skill modules deliver their value through the framework face (skills/commands)."
+      }
+    }
+  ]
+}

package/.merlin-core/schemas/must-haves-schema.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "must-haves-schema.json",
+  "title": "Merlin Must-Haves Schema",
+  "description": "Schema for goal-backward verification of implementation plans (GSD pattern)",
+  "type": "object",
+  "required": ["truths", "artifacts"],
+  "properties": {
+    "truths": {
+      "type": "array",
+      "description": "Invariant conditions that must be true after implementation",
+      "items": {
+        "type": "object",
+        "required": ["id", "statement", "verification"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^T[0-9]+$",
+            "description": "Truth identifier (T1, T2, ...)"
+          },
+          "statement": {
+            "type": "string",
+            "minLength": 10,
+            "description": "The invariant condition that must hold"
+          },
+          "verification": {
+            "type": "string",
+            "enum": ["automated", "manual", "both"],
+            "description": "How this truth is verified"
+          },
+          "command": {
+            "type": "string",
+            "description": "Shell command for automated verification"
+          },
+          "manual_step": {
+            "type": "string",
+            "description": "Human verification step"
+          }
+        }
+      },
+      "minItems": 1
+    },
+    "artifacts": {
+      "type": "array",
+      "description": "Required deliverables that must exist after implementation",
+      "items": {
+        "type": "object",
+        "required": ["id", "description", "path_pattern"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^A[0-9]+$",
+            "description": "Artifact identifier (A1, A2, ...)"
+          },
+          "description": {
+            "type": "string",
+            "description": "What this artifact is"
+          },
+          "path_pattern": {
+            "type": "string",
+            "description": "File path or glob pattern where the artifact should exist"
+          },
+          "validation": {
+            "type": "string",
+            "description": "How to validate the artifact beyond existence (e.g., 'parseable JSON', 'exports class X')"
+          }
+        }
+      },
+      "minItems": 1
+    },
+    "key_links": {
+      "type": "array",
+      "description": "Traceability links from requirements to implementation",
+      "items": {
+        "type": "object",
+        "required": ["requirement_id", "implementation_ref"],
+        "properties": {
+          "requirement_id": {
+            "type": "string",
+            "description": "Reference to the original requirement (e.g., FR-1, US-3)"
+          },
+          "implementation_ref": {
+            "type": "string",
+            "description": "File:line reference where this requirement is implemented"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["pending", "implemented", "verified"],
+            "default": "pending"
+          }
+        }
+      }
+    }
+  }
+}

package/.merlin-core/schemas/objective-schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Merlin Objective",
+  "description": "Cross-session goal with trackable success criteria (Constitution VIII)",
+  "type": "object",
+  "required": ["title", "date", "status", "success_criteria"],
+  "properties": {
+    "title": { "type": "string", "minLength": 5 },
+    "date": { "type": "string", "format": "date" },
+    "tags": { "type": "array", "items": { "type": "string" } },
+    "scope": { "enum": ["session", "sprint", "project", "team"] },
+    "status": { "enum": ["draft", "active", "paused", "achieved", "abandoned"] },
+    "owner": { "type": "string", "description": "Agent ID or 'team'" },
+    "deadline": { "type": "string", "format": "date" },
+    "success_criteria": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1
+    },
+    "linked_plans": { "type": "array", "items": { "type": "string" } },
+    "progress_pct": { "type": "number", "minimum": 0, "maximum": 100 }
+  }
+}

package/.merlin-core/schemas/plan-schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Merlin Plan",
+  "description": "Implementation plan for spec-driven development (Constitution III)",
+  "type": "object",
+  "required": ["title", "date", "status"],
+  "properties": {
+    "title": { "type": "string", "minLength": 5 },
+    "date": { "type": "string", "format": "date" },
+    "tags": { "type": "array", "items": { "type": "string" } },
+    "project": { "type": "string" },
+    "status": { "enum": ["draft", "active", "concluded"], "default": "draft" },
+    "concluded_date": { "type": "string", "format": "date" },
+    "owner": { "type": "string", "description": "Agent ID responsible" },
+    "linked_objectives": { "type": "array", "items": { "type": "string" } },
+    "linked_research": { "type": "array", "items": { "type": "string" } },
+    "steps_total": { "type": "number", "minimum": 0 },
+    "steps_completed": { "type": "number", "minimum": 0 }
+  }
+}

package/.merlin-core/schemas/process-schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Merlin Process",
+  "description": "A unified, certifiable business process (Constitution XIV): executable runbook + trigger/schedule + checklist. NOTE: the top-level schema validates the FLAT frontmatter (Merlin's indexer frontmatter parser does not support block-lists / nested maps). The structured runbook lives in a fenced ```json body block validated against $defs.definition by /certify-process.",
+  "type": "object",
+  "required": ["title", "date", "status", "trigger_mode"],
+  "properties": {
+    "title": { "type": "string", "minLength": 5 },
+    "date": { "type": "string", "format": "date" },
+    "project": { "type": "string" },
+    "owner": { "type": "string", "description": "Agent ID or 'team'" },
+    "tags": { "type": "array", "items": { "type": "string" } },
+
+    "status": {
+      "type": "string",
+      "enum": ["draft", "tested", "certified", "deprecated"],
+      "description": "Lifecycle: draft → tested → certified → deprecated (terminal)"
+    },
+
+    "trigger_mode": {
+      "type": "string",
+      "enum": ["manual", "scheduled", "event"],
+      "description": "FACET 2 — when the process runs"
+    },
+    "schedule": { "type": "string", "description": "5-field cron expression (trigger_mode=scheduled)" },
+    "tz": { "type": "string", "description": "IANA timezone, e.g. America/Sao_Paulo" },
+    "event": { "type": "string", "description": "Named event hook (trigger_mode=event)" },
+
+    "certified_by": { "type": "string", "description": "Human who signed off (Article VII gate, relocated to authoring time). Set ONLY by /certify-process." },
+    "certified_date": { "type": "string", "format": "date" },
+    "signature": { "type": "string", "description": "SHA-256 of the canonicalized steps[] at certification (tamper detection)" },
+    "check_passed": { "type": "boolean" },
+    "rehearsal_log": { "type": "string" },
+    "expires": { "type": "string", "format": "date", "description": "Optional re-certify-by date" },
+
+    "report_back_channel": { "type": "string", "enum": ["memory-session", "feedback-json", "merlin-thought", "telegram"] },
+    "last_run_status": { "type": "string", "enum": ["ok", "partial", "failed", "halted-for-approval"] },
+    "last_run_at": { "type": "string" }
+  },
+
+  "$defs": {
+    "definition": {
+      "type": "object",
+      "description": "The machine-readable runbook in the fenced ```json body block. Validated by /certify-process (gate G1), NOT by the shallow CLI frontmatter validator.",
+      "required": ["steps", "success_criteria"],
+      "properties": {
+        "success_criteria": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string" },
+          "description": "FACET 3 — what 'done' means; the rehearsal end-state assertion (Constitution V)."
+        },
+        "steps": {
+          "type": "array",
+          "minItems": 1,
+          "description": "FACET 1 — the executable runbook (also rendered as the checklist).",
+          "items": {
+            "type": "object",
+            "required": ["id", "description", "safety"],
+            "properties": {
+              "id": { "type": "string" },
+              "description": { "type": "string" },
+              "command": { "type": "string" },
+              "safety": {
+                "type": "string",
+                "enum": ["low", "medium", "high", "absolute"],
+                "description": "Per-step stake. An 'absolute' step can NEVER be autonomous (Article XI floor)."
+              },
+              "autonomous": {
+                "type": "boolean",
+                "default": false,
+                "description": "May the agent run this without asking? MUST be false when safety=absolute (gate G2)."
+              },
+              "expected_outcome": { "type": "string" },
+              "on_failure": { "type": "string", "enum": ["halt", "retry", "skip", "alert"], "default": "halt" }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/.merlin-core/schemas/reminder-schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Merlin Reminder",
+  "description": "Persistent cross-session reminder for agent awareness (Constitution VIII)",
+  "type": "object",
+  "required": ["title", "date", "status", "priority"],
+  "properties": {
+    "title": { "type": "string", "minLength": 5 },
+    "date": { "type": "string", "format": "date" },
+    "tags": { "type": "array", "items": { "type": "string" } },
+    "project": { "type": "string" },
+    "task_id": { "type": "string" },
+    "plan_ref": { "type": "string", "description": "Path to linked plan file" },
+    "priority": { "enum": ["low", "medium", "high", "critical"] },
+    "due_date": { "type": "string", "format": "date" },
+    "status": { "enum": ["pending", "acknowledged", "completed", "expired"] },
+    "owner": { "type": "string", "description": "Agent ID responsible" },
+    "blocking": { "type": "boolean", "default": false }
+  }
+}

package/.merlin-core/schemas/skill-eval-schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "skill-eval-schema.json",
+  "title": "Merlin Skill Evaluation Schema",
+  "description": "Validates skill evaluation files for the eval-skill command",
+  "type": "object",
+  "required": ["skill_name", "evals"],
+  "properties": {
+    "skill_name": {
+      "type": "string",
+      "description": "Name of the skill being evaluated",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "version": {
+      "type": "string",
+      "description": "Version of the skill being evaluated"
+    },
+    "evals": {
+      "type": "array",
+      "description": "Array of evaluation test cases",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "prompt", "expected_output"],
+        "properties": {
+          "id": {
+            "type": ["integer", "string"],
+            "description": "Unique eval identifier (integer or descriptive string)",
+            "minimum": 1
+          },
+          "prompt": {
+            "type": "string",
+            "description": "User prompt to test skill activation",
+            "minLength": 5
+          },
+          "expected_output": {
+            "type": "string",
+            "description": "Description of expected result"
+          },
+          "should_trigger": {
+            "type": "boolean",
+            "description": "Whether this prompt should trigger the skill",
+            "default": true
+          },
+          "assertions": {
+            "type": "array",
+            "description": "Quantitative assertions to check",
+            "items": {
+              "type": "object",
+              "required": ["name", "check"],
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "description": "Human-readable assertion name"
+                },
+                "check": {
+                  "type": "string",
+                  "description": "Assertion type: contains, not_contains, file_exists, regex_match",
+                  "enum": ["contains", "not_contains", "file_exists", "regex_match"]
+                },
+                "value": {
+                  "type": "string",
+                  "description": "Value to check against (required for contains, not_contains, regex_match)"
+                }
+              },
+              "if": {
+                "properties": { "check": { "enum": ["contains", "not_contains", "regex_match"] } }
+              },
+              "then": {
+                "required": ["name", "check", "value"]
+              }
+            }
+          },
+          "files": {
+            "type": "array",
+            "description": "Input files needed for this eval",
+            "items": { "type": "string" }
+          }
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Additional metadata about the evaluation",
+      "properties": {
+        "created": { "type": "string", "format": "date" },
+        "author": { "type": "string" },
+        "notes": { "type": "string" }
+      }
+    }
+  }
+}