@deftai/directive-content 0.55.0

package/vbrief/schemas/codebase-map.schema.json

@@ -0,0 +1,213 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://deft.dev/schemas/codebase-map.v1.schema.json",
+  "title": "Codebase Map Artifact v1",
+  "description": "Language-neutral contract for a provider-emitted codebase-map.v1 artifact. Out-of-process providers may be written in any language, but must emit this JSON object on stdout for Directive to accept it instead of falling back to the default extractor.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "formatVersion",
+    "contractVersion",
+    "kind",
+    "provider",
+    "source",
+    "modules",
+    "coupling",
+    "entryPoints",
+    "languageDistribution",
+    "degraded"
+  ],
+  "properties": {
+    "formatVersion": {
+      "const": "codebase-map.v1",
+      "description": "Artifact format version owned by Directive."
+    },
+    "contractVersion": {
+      "const": "codebase-provider.v1",
+      "description": "Provider handshake contract version accepted by Directive."
+    },
+    "kind": {
+      "const": "codebase-map",
+      "description": "Projection kind."
+    },
+    "provider": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string"
+        },
+        "mode": {
+          "type": "string"
+        },
+        "degraded": {
+          "type": "boolean"
+        },
+        "fallbackReason": {
+          "type": "string"
+        }
+      }
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["projectRoot"],
+      "properties": {
+        "projectRoot": {
+          "type": "string",
+          "minLength": 1
+        },
+        "codeStructurePath": {
+          "type": "string"
+        },
+        "codeStructureHome": {
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "modules": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["id", "files", "derivedFrom"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "name": {
+            "type": ["string", "null"]
+          },
+          "purpose": {
+            "type": ["string", "null"]
+          },
+          "pathGlobs": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "fileCount": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "files": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "derivedFrom": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        }
+      }
+    },
+    "coupling": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["from", "to", "derivedFrom"],
+        "properties": {
+          "from": {
+            "type": "string",
+            "minLength": 1
+          },
+          "to": {
+            "type": "string",
+            "minLength": 1
+          },
+          "derivedFrom": {
+            "type": "string",
+            "minLength": 1
+          },
+          "confidence": {
+            "type": "string"
+          },
+          "evidence": {
+            "type": "array"
+          }
+        }
+      }
+    },
+    "entryPoints": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["path", "module", "derivedFrom"],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "module": {
+            "type": "string",
+            "minLength": 1
+          },
+          "derivedFrom": {
+            "type": "string",
+            "minLength": 1
+          },
+          "confidence": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "languageDistribution": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["language", "files", "derivedFrom"],
+        "properties": {
+          "language": {
+            "type": "string",
+            "minLength": 1
+          },
+          "files": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "derivedFrom": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "degraded": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["code", "message"],
+        "properties": {
+          "code": {
+            "type": "string",
+            "minLength": 1
+          },
+          "message": {
+            "type": "string",
+            "minLength": 1
+          },
+          "module": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/vbrief/schemas/lessons-pack.schema.json

@@ -0,0 +1,134 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://deft.dev/schemas/lessons-pack-0.1.schema.json",
+  "title": "Lessons Pack 0.1",
+  "description": "Canonical source schema for the lessons-pack-0.1 tier-3 extension pack (#1294, design #1283, ADR-001). The structured JSON at packs/lessons/lessons-pack-0.1.json is the SOURCE OF TRUTH; meta/lessons.md is a regenerated, drift-checked projection (scripts/pack_render.py). The `x-sliceRegistry` block is the schema-declared, agent-facing slice API: a named-slice registry mapping slice name -> { path (a constrained dotted path into the source -- NOT JSONPath), filters[] (a fixed filter vocabulary), description }. Agents query by slice NAME only; the dotted path + filter dialect are pack-author implementation detail (the ADR-001 Example-6 reconciliation). The `x-tagVocabulary` enumerates the controlled tag set that scripts/pack_migrate_lessons.py assigns from.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["pack", "version", "lessons"],
+  "properties": {
+    "pack": {
+      "const": "lessons-pack-0.1",
+      "description": "Versioned pack identifier. The version lives in the name per #1283 Q6 (pack version is part of the pack name)."
+    },
+    "version": {
+      "const": "0.1",
+      "description": "Pack major.minor, mirrored from the pack name suffix."
+    },
+    "generated_from": {
+      "type": "string",
+      "description": "Provenance: the source markdown path the one-shot migration (scripts/pack_migrate_lessons.py) parsed to build this pack (e.g. meta/lessons.md)."
+    },
+    "lessons": {
+      "type": "array",
+      "description": "The lesson entries. Order is the source-document order and is the render order; the renderer emits `## {title}\\n\\n{body}` for each entry in this order.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "title", "date", "issue_refs", "tags", "source", "body"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9][a-z0-9-]*$",
+            "description": "Stable, unique, deterministic slug derived from the title."
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The full human heading text (everything after the leading `## `), stored verbatim so the projection round-trips exactly. The parenthetical date / issue ref is intentionally retained in the title; `date` and `issue_refs` are convenience-extracted copies."
+          },
+          "date": {
+            "type": ["string", "null"],
+            "pattern": "^\\d{4}-\\d{2}$",
+            "description": "Year-month (YYYY-MM) extracted from the title parenthetical, or null when the heading carries no date (e.g. an issue-ref-only heading). The `since` filter compares against this field; null-dated entries are excluded from `recent`."
+          },
+          "issue_refs": {
+            "type": "array",
+            "description": "All `#NNN` issue references found in the title, in order of appearance.",
+            "items": {
+              "type": "string",
+              "pattern": "^#\\d+$"
+            }
+          },
+          "tags": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 3,
+            "description": "1-3 tags from the controlled x-tagVocabulary, assigned by the migration from title/body keywords. The `by-tag` slice filters on this field.",
+            "items": {
+              "type": "string",
+              "enum": [
+                "windows",
+                "encoding",
+                "review-cycle",
+                "swarm",
+                "release",
+                "github",
+                "context",
+                "debugging",
+                "lifecycle",
+                "powershell",
+                "ci",
+                "agent-orchestration"
+              ]
+            }
+          },
+          "source": {
+            "type": ["string", "null"],
+            "description": "The text of the entry's `**Source:**` line (the provenance line authored in the lesson body), or null when the entry has no Source line. The full Source line is also retained verbatim inside `body`; this is a convenience-extracted copy."
+          },
+          "body": {
+            "type": "string",
+            "description": "The full section body markdown (everything after the heading up to the next `## ` heading), stored verbatim as a lossless blob. Numbered sub-lessons are intentionally NOT decomposed into fields -- body-as-blob keeps the migration lossless."
+          }
+        }
+      }
+    }
+  },
+  "x-tagVocabulary": [
+    "windows",
+    "encoding",
+    "review-cycle",
+    "swarm",
+    "release",
+    "github",
+    "context",
+    "debugging",
+    "lifecycle",
+    "powershell",
+    "ci",
+    "agent-orchestration"
+  ],
+  "x-display": {
+    "heading": "title",
+    "fields": [],
+    "body": "body",
+    "noun": "lessons"
+  },
+  "x-sliceRegistry": {
+    "recent": {
+      "path": "lessons",
+      "filters": ["since"],
+      "description": "Lessons dated on or after --since (YYYY-MM or YYYY-MM-DD). Null-dated entries are excluded."
+    },
+    "by-tag": {
+      "path": "lessons",
+      "filters": ["tag"],
+      "description": "Lessons carrying any of the requested --tag values (repeatable or comma-listed)."
+    },
+    "by-issue": {
+      "path": "lessons",
+      "filters": ["issue"],
+      "description": "Lessons whose issue_refs include any of the requested --issue values (bare or hashed, e.g. 754 or #754; repeatable or comma-listed)."
+    },
+    "anti-patterns": {
+      "path": "lessons",
+      "filters": [],
+      "select": {
+        "body_contains_any": ["anti-pattern", "anti pattern", "must not", "\u2297"]
+      },
+      "description": "Lessons whose body calls out an anti-pattern (RFC2119 prohibition markers / 'anti-pattern' guidance). Argument-less."
+    }
+  }
+}

package/vbrief/schemas/patterns-pack.schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://deft.dev/schemas/patterns-pack-0.1.schema.json",
+  "title": "Patterns Pack 0.1",
+  "description": "Canonical source schema for the patterns-pack-0.1 tier-3 extension pack (#1637, design #1283, ADR-001, generalizing the #1294 lessons pilot + #1295 skills pack + #1296 rules/strategies packs). The structured JSON at packs/patterns/patterns-pack-0.1.json is the SOURCE OF TRUTH for architectural-pattern ROUTING METADATA: for every patterns/*.md it records id (the doc stem), title (the leading `# ` heading), description (the leading description paragraph), triggers (the pattern stem as an invocation keyword, used by the `by-trigger` slice), and the path. Exactly one designated proof pattern (patterns/multi-agent.md) also carries its full body so its markdown can be regenerated as a banner-marked, drift-checked projection (scripts/pack_render.py); every other entry is metadata-only (body null) and keeps its hand-authored markdown. The `x-sliceRegistry` block is the schema-declared, agent-facing slice API (mirrors lessons + skills + strategies): a named-slice registry mapping slice name -> { path (a constrained dotted path into the source -- NOT JSONPath), filters[] (the fixed trigger vocabulary), description }. Agents query by slice NAME only. The `x-display` block declares how scripts/packs_slice.py renders an entry as text (heading field, labelled metadata fields, optional body field, and the empty-result noun) so the slice formatter stays pack-agnostic.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["pack", "version", "patterns"],
+  "properties": {
+    "pack": {
+      "const": "patterns-pack-0.1",
+      "description": "Versioned pack identifier. The version lives in the name per #1283 Q6 (pack version is part of the pack name)."
+    },
+    "version": {
+      "const": "0.1",
+      "description": "Pack major.minor, mirrored from the pack name suffix."
+    },
+    "generated_from": {
+      "type": "string",
+      "description": "Provenance: the sources the one-shot migration (scripts/pack_migrate_patterns.py) parsed to build this pack (patterns/*.md)."
+    },
+    "patterns": {
+      "type": "array",
+      "description": "One entry per discovered pattern doc (patterns/*.md). Order is the sorted path order.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "title", "description", "triggers", "path", "body"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9][a-z0-9-]*$",
+            "description": "Pattern id: the slugified doc stem (e.g. multi-agent, role-as-overlay, llm-app)."
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The pattern's leading `# ` heading text, stored verbatim."
+          },
+          "description": {
+            "type": "string",
+            "description": "The leading description paragraph after the title (Legend / See-also / chrome lines skipped), folded to a single normalised string. Empty when the doc has no leading paragraph."
+          },
+          "triggers": {
+            "type": "array",
+            "description": "Invocation keywords for this pattern (the doc stem). Empty when the pattern has no derivable trigger. The `by-trigger` slice filters on this field.",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^patterns/.+\\.md$",
+            "description": "Repo-relative path to the pattern markdown."
+          },
+          "body": {
+            "type": ["string", "null"],
+            "description": "Full pattern body (banner-stripped, verbatim) for the ONE designated proof pattern (patterns/multi-agent.md); null for metadata-only entries. The renderer reconstructs the proof = banner + body."
+          }
+        }
+      }
+    }
+  },
+  "x-display": {
+    "heading": "id",
+    "fields": ["title", "description", "triggers", "path"],
+    "body": null,
+    "noun": "patterns"
+  },
+  "x-sliceRegistry": {
+    "by-trigger": {
+      "path": "patterns",
+      "filters": ["trigger"],
+      "description": "Patterns whose invocation keywords include any of the requested --trigger values (case-insensitive, repeatable or comma-listed)."
+    },
+    "list": {
+      "path": "patterns",
+      "filters": [],
+      "description": "Every pattern with its title, description, triggers, and path."
+    }
+  }
+}

package/vbrief/schemas/rules-pack.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://deft.dev/schemas/rules-pack-0.1.schema.json",
+  "title": "Rules Pack 0.1",
+  "description": "Canonical source schema for the rules-pack-0.1 tier-3 extension pack (#1296, design #1283, ADR-001, generalizing the #1294 lessons pilot + #1295 skills pack; source coverage broadened in #1637 s4). The structured JSON at packs/rules/rules-pack-0.1.json is the SOURCE OF TRUTH for the RFC2119-tiered directives parsed from coding/*.md plus AGENTS.md and main.md: for every marker-prefixed directive line it records id, tier (normalized from the RFC2119 legend per #748: !=MUST, ~=SHOULD, the SHOULD-NOT glyph=SHOULD_NOT, the MUST-NOT glyph=MUST_NOT, ?=MAY), domain (the source doc stem -- testing/security/hygiene/coding/toolchain/debugging/agents/main/...), the directive text, and the path. Every coding/*.md doc carries its full body on its first rule entry so each coding doc is regenerated as a banner-marked, drift-checked projection (scripts/pack_render.py). AGENTS.md and main.md are ingested as directive METADATA ONLY (body null, never rendered) -- the renderer skips null-body entries so AGENTS.md stays owned solely by `task agents:refresh`; AGENTS.md's managed-section block is excluded from extraction (rendered mirror of templates/agents-entry.md, not canonical). The `x-sliceRegistry` block is the schema-declared, agent-facing slice API (mirrors lessons + skills): a named-slice registry mapping slice name -> { path (a constrained dotted path into the source -- NOT JSONPath), filters[] (the fixed tier/domain vocabulary), description }. Agents query by slice NAME only. The `x-display` block declares how scripts/packs_slice.py renders an entry as text (heading field, labelled metadata fields, optional body field, and the empty-result noun) so the slice formatter stays pack-agnostic. The `x-tierVocabulary` enumerates the controlled tier set.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["pack", "version", "rules"],
+  "properties": {
+    "pack": {
+      "const": "rules-pack-0.1",
+      "description": "Versioned pack identifier. The version lives in the name per #1283 Q6 (pack version is part of the pack name)."
+    },
+    "version": {
+      "const": "0.1",
+      "description": "Pack major.minor, mirrored from the pack name suffix."
+    },
+    "generated_from": {
+      "type": "string",
+      "description": "Provenance: the sources the one-shot migration (scripts/pack_migrate_rules.py) parsed to build this pack (coding/*.md + AGENTS.md + main.md marker-prefixed directives)."
+    },
+    "rules": {
+      "type": "array",
+      "description": "One entry per parsed directive (marker-prefixed `- ! ...` / `- ~ ...` / `- (SHOULD-NOT) ...` / `- (MUST-NOT) ...` / `- ? ...` lines, plus prose RFC2119 MUST/SHOULD bullets). Order is sorted source-doc path then in-document order.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "tier", "domain", "text", "path", "body"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9][a-z0-9-]*$",
+            "description": "Stable, unique, deterministic slug: `{domain}-{NNN}` (in-document order, 1-based, zero-padded)."
+          },
+          "tier": {
+            "type": "string",
+            "enum": ["MUST", "SHOULD", "SHOULD_NOT", "MUST_NOT", "MAY"],
+            "description": "RFC2119 strength normalized from the coding/* legend marker (#748). The `by-tier` slice filters on this field."
+          },
+          "domain": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9][a-z0-9-]*$",
+            "description": "Source doc stem (e.g. testing, security, hygiene, coding, toolchain, debugging, build-output, holzmann, agents, main). The `by-domain` slice filters on this field."
+          },
+          "text": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The directive text (everything after the strength marker), stored verbatim."
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^(?:coding/.+\\.md|AGENTS\\.md|main\\.md)$",
+            "description": "Repo-relative path to the source doc: a coding/*.md doc, or AGENTS.md / main.md (#1637 s4). coding/*.md entries are body-rendered projections; AGENTS.md / main.md entries are metadata-only (body null, never rendered)."
+          },
+          "body": {
+            "type": ["string", "null"],
+            "description": "Full source-document body (banner-stripped, verbatim) for EACH coding/*.md doc's first rule entry, so every coding doc reconstructs as banner + body (#1637 s4 broadened the single coding/testing.md proof to all coding docs). null for every other coding entry AND for ALL AGENTS.md / main.md entries -- the renderer skips null-body entries so AGENTS.md stays owned solely by `task agents:refresh`."
+          }
+        }
+      }
+    }
+  },
+  "x-tierVocabulary": ["MUST", "SHOULD", "SHOULD_NOT", "MUST_NOT", "MAY"],
+  "x-display": {
+    "heading": "id",
+    "fields": ["tier", "domain", "text", "path"],
+    "body": null,
+    "noun": "rules"
+  },
+  "x-sliceRegistry": {
+    "by-tier": {
+      "path": "rules",
+      "filters": ["tier"],
+      "description": "Rules whose RFC2119 tier matches any of the requested --tier values (e.g. MUST, MUST_NOT; case-insensitive, repeatable or comma-listed)."
+    },
+    "by-domain": {
+      "path": "rules",
+      "filters": ["domain"],
+      "description": "Rules from any of the requested --domain source docs (e.g. testing, security; case-insensitive, repeatable or comma-listed)."
+    },
+    "list": {
+      "path": "rules",
+      "filters": [],
+      "description": "Every rule with its tier, domain, text, and source path."
+    },
+    "must": {
+      "path": "rules",
+      "filters": [],
+      "select": {
+        "tier_in": ["MUST"]
+      },
+      "description": "Rules at the MUST tier only. Argument-less convenience over by-tier --tier MUST."
+    },
+    "prohibitions": {
+      "path": "rules",
+      "filters": [],
+      "select": {
+        "tier_in": ["MUST_NOT", "SHOULD_NOT"]
+      },
+      "description": "Prohibition rules (MUST_NOT / SHOULD_NOT tiers) -- the anti-pattern surface for rules. Argument-less."
+    }
+  }
+}

package/vbrief/schemas/skills-pack.schema.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://deft.dev/schemas/skills-pack-0.1.schema.json",
+  "title": "Skills Pack 0.1",
+  "description": "Canonical source schema for the skills-pack-0.1 tier-3 extension pack (#1295, design #1283, ADR-001, generalizing the #1294 lessons pilot). The structured JSON at packs/skills/skills-pack-0.1.json is the SOURCE OF TRUTH for skill ROUTING METADATA: for every skill under skills/*/SKILL.md it records id (== the frontmatter name), description, the routing triggers resolved from the AGENTS.md Skill Routing table, the path, and the version. Exactly one designated proof skill also carries its full body so its SKILL.md can be regenerated as a banner-marked, drift-checked projection (scripts/pack_render.py); every other entry is metadata-only (body null) and keeps its hand-authored SKILL.md. The `x-sliceRegistry` block is the schema-declared, agent-facing slice API (mirrors the lessons pack): a named-slice registry mapping slice name -> { path (a constrained dotted path into the source -- NOT JSONPath), filters[] (the fixed since/tag/trigger vocabulary), description }. Agents query by slice NAME only. The `x-display` block declares how scripts/packs_slice.py renders an entry as text (heading field, labelled metadata fields, optional body field, and the noun used in the empty-result line) so the slice formatter is pack-agnostic.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["pack", "version", "skills"],
+  "properties": {
+    "pack": {
+      "const": "skills-pack-0.1",
+      "description": "Versioned pack identifier. The version lives in the name per #1283 Q6 (pack version is part of the pack name)."
+    },
+    "version": {
+      "const": "0.1",
+      "description": "Pack major.minor, mirrored from the pack name suffix."
+    },
+    "generated_from": {
+      "type": "string",
+      "description": "Provenance: the sources the one-shot migration (scripts/pack_migrate_skills.py) parsed to build this pack (skills/*/SKILL.md frontmatter + the AGENTS.md Skill Routing table)."
+    },
+    "skills": {
+      "type": "array",
+      "description": "One entry per discovered skill (skills/*/SKILL.md with YAML frontmatter; deprecated redirect stubs without frontmatter are skipped). Order is the sorted path order.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "description", "triggers", "path", "version", "body", "frontmatter_extra"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9][a-z0-9-]*$",
+            "description": "Skill id; equals the YAML frontmatter `name` (e.g. deft-directive-cost)."
+          },
+          "description": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The skill's frontmatter `description`, folded to a single normalised string. The renderer re-emits this as a YAML folded scalar for the proof skill."
+          },
+          "triggers": {
+            "type": "array",
+            "description": "Routing keywords mapped to this skill's path in the AGENTS.md Skill Routing table, in table order. Empty when the skill has no routing entry. The `by-trigger` slice filters on this field.",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^skills/.+/SKILL\\.md$",
+            "description": "Repo-relative path to the skill's SKILL.md."
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Skill version: read from a frontmatter `version:` key when present, else defaulted to 0.1."
+          },
+          "body": {
+            "type": ["string", "null"],
+            "description": "Full SKILL.md body (everything after the frontmatter, with any prior provenance banner stripped). Captured for EVERY skill by default (packs:slice v2, #1637) so every skills/*/SKILL.md is a banner-marked, drift-checked projection; null only when the back-compat --proof-skill flag restricted capture to one skill. The renderer reconstructs each skill's SKILL.md = frontmatter + banner + body."
+          },
+          "frontmatter_extra": {
+            "type": ["string", "null"],
+            "description": "Verbatim frontmatter lines that are NOT name/description (e.g. triggers:, metadata:, os:). The renderer reconstructs name + a folded description and re-emits this block verbatim so regenerating a projection is LOSSLESS -- no hand-authored frontmatter key is dropped (#1637). Null when a skill carries only name + description."
+          }
+        }
+      }
+    }
+  },
+  "x-display": {
+    "heading": "id",
+    "fields": ["description", "triggers", "path"],
+    "body": null,
+    "noun": "skills"
+  },
+  "x-sliceRegistry": {
+    "by-trigger": {
+      "path": "skills",
+      "filters": ["trigger"],
+      "description": "Skills whose routing triggers include any of the requested --trigger keywords (case-insensitive, repeatable or comma-listed)."
+    },
+    "list": {
+      "path": "skills",
+      "filters": [],
+      "description": "Every skill with its description, routing triggers, and path."
+    },
+    "by-id": {
+      "path": "skills",
+      "filters": ["id"],
+      "description": "Skills whose id matches any of the requested --id values (e.g. deft-directive-cost; case-insensitive, repeatable or comma-listed)."
+    }
+  }
+}