skilldrop-cli 0.16.3__py3-none-any.whl

skilldrop_cli/data/catalogue.json

@@ -0,0 +1,187 @@
+{
+  "$comment": "RFC-0034. The catalogue index: pack display order and the outcome browse axis (RFC-0026). Pack metadata lives in packs/<pack>/pack.json; membership is the folders — a skill is in a pack because it sits at packs/<pack>/skills/<name>/.",
+  "version": "1.0.0",
+  "packs": ["core", "solution-architect", "product-manager", "dev-team", "sre-oncall", "stakeholder-comms", "design", "ai-engineering", "api-builder", "converters", "experience-design", "research", "trackers", "data-analytics", "grc", "infra-as-code", "skill-engineering"],
+  "outcomes": {
+    "decide-what-to-build": {
+      "for": "Product managers · founders · strategists",
+      "description": "Turn a direction into a committed, measurable plan: press releases, strategy frameworks, OKRs, business cases, requirements, PRDs, and the metrics that will say whether it worked.",
+      "skills": [
+        "prfaq",
+        "strategy-analysis",
+        "okr-cascade",
+        "business-case",
+        "capacity-cost-model",
+        "requirements-interview",
+        "prd-draft",
+        "nfr-spec",
+        "success-metrics",
+        "user-story-splitter",
+        "user-journey-map"
+      ]
+    },
+    "design-the-system": {
+      "for": "Architects · tech leads",
+      "description": "Commit the shape before the code: decision records, design docs, diagrams, contracts, schemas, migration and threat models, and the design of any agentic parts.",
+      "skills": [
+        "adr-generator",
+        "design-doc",
+        "architecture-diagrams",
+        "reverse-architecture",
+        "figma-diagrams",
+        "api-contract-draft",
+        "db-schema-design",
+        "data-contract",
+        "tech-comparison-matrix",
+        "threat-model",
+        "agent-threat-model",
+        "migration-plan",
+        "agent-loop-design",
+        "subagent-design",
+        "agent-budget",
+        "terraform-module"
+      ]
+    },
+    "build-and-review-software": {
+      "for": "Software teams · coding agents",
+      "description": "The loop around the code itself: supervised implementation, adversarial review panels, test plans, triage, accessibility and static-analysis passes, and the policy files agents read.",
+      "skills": [
+        "feature-implement-loop",
+        "pre-merge-review",
+        "devils-advocate",
+        "council-review",
+        "accessibility-audit",
+        "sonar-onboard",
+        "sonar-review",
+        "test-plan-generator",
+        "bug-triage",
+        "agents-md-generator",
+        "llm-eval-harness",
+        "eval-harness-generator",
+        "contribution-wizard",
+        "backlog-triage",
+        "tracker-brief-sync"
+      ]
+    },
+    "build-on-the-claude-api": {
+      "for": "Teams building on the Anthropic API",
+      "description": "Skills for teams building directly on the Anthropic API — prompt caching strategy, token budgeting, eval generation, and tool-use schema writing.",
+      "skills": [
+        "prompt-caching-advisor",
+        "token-budget-estimator",
+        "eval-harness-generator",
+        "tool-use-schema-writer"
+      ]
+    },
+    "run-and-recover-the-service": {
+      "for": "SRE · on-call · platform teams",
+      "description": "Operate what shipped: runbooks, observability design, release notes, incident communication, and the postmortem that closes the loop.",
+      "skills": [
+        "runbook-generator",
+        "observability-plan",
+        "release-notes",
+        "incident-comms",
+        "postmortem-generator",
+        "launch-readiness",
+        "cloud-cost-review",
+        "delivery-metrics-report",
+        "terraform-plan-review"
+      ]
+    },
+    "explain-it-to-decision-makers": {
+      "for": "Anyone presenting to leadership",
+      "description": "Get a non-technical audience to a decision: audience profiling, deck outlines and real decks, exec summaries, decision logs, and how-to guides.",
+      "skills": [
+        "audience-profile",
+        "slide-outliner",
+        "deck-builder",
+        "exec-summary",
+        "decision-log",
+        "guide-builder",
+        "team-status-report"
+      ]
+    },
+    "govern-ai-use": {
+      "for": "AI enablement · engineering leaders · risk owners",
+      "description": "Adopt AI deliberately and prove what it is doing: readiness assessment, use-case triage, rollout plans, acceptable-use policy, adoption staging, and usage reporting.",
+      "skills": [
+        "ai-readiness-assessment",
+        "ai-use-case-triage",
+        "ai-adoption-rollout",
+        "ai-usage-policy",
+        "agent-adoption-stage",
+        "ai-usage-report"
+      ]
+    },
+    "create-on-brand-collateral": {
+      "for": "Marketers · designers · anyone making a deck or flyer",
+      "description": "Make collateral that looks like it came from your team: capture the brand once, then build decks and print-ready flyers with your logo, colours and fonts.",
+      "skills": [
+        "brand-kit",
+        "deck-builder",
+        "marketing-flyer",
+        "slide-outliner"
+      ]
+    },
+    "get-a-draft-ready-to-ship": {
+      "for": "Anyone shipping a document",
+      "description": "The passes either side of a generator: collect a messy input into a structured brief, critique the argument, and strip the machine artifacts before it leaves the building.",
+      "skills": [
+        "brief-intake",
+        "doc-critique",
+        "output-hygiene",
+        "file-to-markdown",
+        "md-to-docx",
+        "md-to-html",
+        "md-to-xlsx",
+        "mermaid-render"
+      ]
+    },
+    "design-the-experience": {
+      "for": "Designers · content designers · UX writers",
+      "description": "Shape what people see and read before it's built: information architecture, interface copy, content specs, component specs and service blueprints.",
+      "skills": [
+        "content-design",
+        "design-system-spec",
+        "information-architecture",
+        "service-blueprint",
+        "ux-writing"
+      ]
+    },
+    "research-a-question": {
+      "for": "Researchers · analysts · anyone with a question to answer",
+      "description": "Take a question to a sourced answer: a research plan with a stopping rule, a cited synthesis of the sources, and competing explanations weighed against the evidence.",
+      "skills": [
+        "hypothesis-comparison",
+        "research-plan",
+        "source-synthesis"
+      ]
+    },
+    "define-and-trust-the-numbers": {
+      "for": "Data analysts · analytics engineers",
+      "description": "Make the numbers a business runs on mean one thing: metric definitions a semantic layer can implement, SQL reviewed for wrong answers, and dashboards specced before they're built.",
+      "skills": [
+        "dashboard-spec",
+        "metric-definition",
+        "sql-review"
+      ]
+    },
+    "manage-risk-and-compliance": {
+      "for": "Compliance, privacy and risk leads",
+      "description": "Prepare the material compliance asks for: a data protection impact assessment, a SOC 2 evidence map, and a risk register with owners and review dates.",
+      "skills": [
+        "dpia",
+        "risk-register",
+        "soc2-evidence-map"
+      ]
+    },
+    "build-agent-skills": {
+      "for": "Anyone writing skills for an AI agent",
+      "description": "Write and review Agent Skills for any tool: a portable SKILL.md with evals, and an audit of an existing skill before it ships.",
+      "skills": [
+        "skill-author",
+        "skill-review"
+      ]
+    }
+  }
+}

skilldrop_cli/data/contracts/agent.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/sananthanarayan/skilldrop/contracts/agent.schema.json",
+  "title": "skilldrop reviewer subagent frontmatter",
+  "$comment": "RFC-0012 / RFC-0029. agents/<name>.md is a single markdown file whose YAML frontmatter is already Claude Code's format; the body is the system prompt. The CLI projects this into each target's own shape (Kiro JSON, Codex TOML, Copilot .agent.md), so these four fields are the portable core.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "description"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "description": "Must equal the filename stem. A rename that misses one silently breaks every delegation pointing here."
+    },
+    "description": {
+      "type": "string",
+      "description": "What routes a delegation to this agent. Required — without it the agent is unreachable."
+    },
+    "tools": {
+      "type": "string",
+      "description": "Comma-separated tool names. Recommended; the CLI maps these per target and warns where a tool has no equivalent."
+    },
+    "model": {
+      "type": "string",
+      "description": "Recommended. A hint the target may honour or ignore."
+    }
+  }
+}

skilldrop_cli/data/contracts/catalogue.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/sananthanarayan/skilldrop/contracts/catalogue.schema.json",
+  "title": "skilldrop catalogue.json",
+  "$comment": "RFC-0026 / RFC-0034. The catalogue index: pack display order, and the outcome axis. Packs answer WHO needs a skill (the folder it sits in); outcomes answer WHY someone opened the catalogue.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "packs", "outcomes"],
+  "properties": {
+    "$comment": { "type": "string" },
+    "version": { "type": "string" },
+    "packs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1,
+      "description": "Every pack folder under packs/, in display order. validate.py checks both directions."
+    },
+    "outcomes": {
+      "type": "object",
+      "description": "The catalogue's second browse axis. A browse aid only — never an install unit; the CLI takes no --outcome.",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["description", "skills"],
+        "properties": {
+          "for": { "type": "string", "description": "Who this job belongs to, shown on the home page's outcome cards." },
+          "description": { "type": "string", "description": "The chip's tooltip on the catalogue site." },
+          "skills": { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+        }
+      }
+    }
+  }
+}

skilldrop_cli/data/contracts/guide.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/sananthanarayan/skilldrop/contracts/guide.schema.json",
+  "title": "skilldrop guide frontmatter",
+  "$comment": "RFC-0029. Diátaxis `kind` is a PAGE CONTRACT, not a directory requirement — the directory is a convenience, the frontmatter is the truth. That keeps the tree shallow while still forcing each page to declare what kind of document it is, which is the discipline Diátaxis actually provides.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["title", "summary", "kind"],
+  "properties": {
+    "title": { "type": "string", "description": "Sentence case. Becomes the page's single h1." },
+    "summary": { "type": "string", "description": "One line, shown in the guides index." },
+    "kind": {
+      "enum": ["tutorial", "how-to", "reference", "explanation"],
+      "description": "tutorial = learning by doing. how-to = a task with a goal. reference = look it up. explanation = why it is this way. A page that cannot pick one is doing two jobs and should be split."
+    },
+    "status": { "enum": ["draft", "review", "stable", "deprecated"], "default": "stable" }
+  }
+}

skilldrop_cli/data/contracts/loop.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/sananthanarayan/skilldrop/contracts/loop.schema.json",
+  "title": "skilldrop loop",
+  "$comment": "RFC-0028. A loop sequences existing skills; it never contains one. Skills stay in their own packs/<pack>/skills/<name> folders and stay independently installable — a loop is a named order plus the gates between stages. Enforced by validate.py with hand-rolled stdlib checks: skilldrop ships zero runtime dependencies and this file must not become a reason to add `jsonschema`.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "description", "entrypoint", "kind", "stages"],
+  "properties": {
+    "$comment": { "type": "string" },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "description": "Kebab-case. Must equal the folder name and the LOOP.md frontmatter name — the same triple-match skills are held to."
+    },
+    "version": { "type": "string" },
+    "description": {
+      "type": "string",
+      "description": "Use-case-first. First half says what the loop delivers; second half states the trigger phrases an agent matches on."
+    },
+    "entrypoint": { "const": "LOOP.md" },
+    "kind": {
+      "enum": ["loop", "wrapper"],
+      "description": "`loop` advances stage to stage toward a terminal. `wrapper` wraps an arbitrary generator skill chosen at run time — its stages are the passes either side of that generator."
+    },
+    "cap": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 10,
+      "default": 3,
+      "description": "Maximum revision rounds before the loop stops looping and emits its conditional or blocked terminal. Default 3, matching agent-loop-design's revision cap."
+    },
+    "stages": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "type", "intent", "skills"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+          "type": {
+            "enum": ["generate", "verify", "gate"],
+            "description": "The three state types agent-loop-design mandates: 'Every loop has exactly these three state types.'"
+          },
+          "intent": { "type": "string", "description": "One line: what this stage is for." },
+          "skills": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string" },
+            "description": "Skill folder names, in order. Each must be a real skill folder (packs/<pack>/skills/<name>). `*` means any generator, and is legal only in a wrapper."
+          },
+          "gate": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "kind", "verdicts"],
+            "properties": {
+              "id": {
+                "type": "string",
+                "pattern": "^G[0-9]+(\\.[0-9]+)?$",
+                "description": "Named gate, unique across the repo. A gate is a place a human or a script can point at."
+              },
+              "kind": {
+                "enum": ["mechanical", "review", "human"],
+                "description": "mechanical = a script's exit code decides. review = a skill or subagent panel decides. human = a person decides and the agent may not proceed without it."
+              },
+              "script": {
+                "type": "string",
+                "description": "Repo-relative path to the deciding script. Required when kind is mechanical, forbidden otherwise."
+              },
+              "verdicts": {
+                "type": "array",
+                "minItems": 2,
+                "items": { "type": "string" },
+                "description": "Every verdict this gate can emit. All must exist in contracts/terminals.json. Must include >=1 pass-class and >=1 non-pass."
+              },
+              "revise_to": {
+                "type": "string",
+                "description": "Stage id a revise-class verdict returns to. Must be an earlier stage in this loop."
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

skilldrop_cli/data/contracts/pack.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/sananthanarayan/skilldrop/contracts/pack.schema.json",
+  "title": "skilldrop packs/<pack>/pack.json",
+  "$comment": "RFC-0001 / RFC-0032 / RFC-0033 / RFC-0034. One pack's metadata. Membership is not listed here: a skill is in this pack because it sits at packs/<pack>/skills/<name>/, and a loop because it sits at packs/<pack>/loops/<name>/. Key names follow agent-ready-repo's pack.toml so the two stay mechanically convertible.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["description"],
+  "properties": {
+    "$comment": { "type": "string" },
+    "description": { "type": "string", "description": "One line — who this pack is for." },
+    "display_name": { "type": "string", "description": "RFC-0032. Human title for the pack's page and plugin entry." },
+    "keywords": { "type": "array", "items": { "type": "string" }, "description": "RFC-0032. Search terms, copied into the plugin entry." },
+    "links": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "RFC-0032. Catalogue-facing links; `documentation` is the pack's page.",
+      "properties": {
+        "homepage": { "type": "string" },
+        "repository": { "type": "string" },
+        "documentation": { "type": "string" }
+      }
+    },
+    "maintainers": {
+      "type": "array",
+      "description": "RFC-0032.",
+      "items": { "type": "object", "additionalProperties": false, "required": ["name"], "properties": { "name": { "type": "string" } } }
+    },
+    "first-value": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "RFC-0032. What to try first after installing, how to tell it worked, and what to do if it didn't. Key names match agent-ready-repo's [pack.first-value].",
+      "required": ["audience-posture", "prerequisites", "starter-task", "starter-prompt", "verification", "recovery"],
+      "properties": {
+        "audience-posture": { "type": "string", "enum": ["technical", "non-technical"] },
+        "prerequisites": { "type": "array", "items": { "type": "string" } },
+        "starter-task": { "type": "string" },
+        "starter-prompt": { "type": "string" },
+        "verification": { "type": "string" },
+        "recovery": { "type": "string" }
+      }
+    },
+    "journey": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "A typical session with the pack, rendered as its walkthrough page: when you'd reach for it, what you bring, each step's skill with what you do, what you get and where you decide, and what you end with. Every step's skill must sit in this pack or in a pack it requires.",
+      "required": ["when", "you_bring", "steps", "you_end_with"],
+      "properties": {
+        "when": { "type": "string" },
+        "you_bring": { "type": "array", "items": { "type": "string" } },
+        "time": { "type": "string", "description": "A rough range for one session; left out when it depends too much on the work." },
+        "steps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["skill", "you_do", "you_get"],
+            "properties": {
+              "skill": { "type": "string" },
+              "you_do": { "type": "string" },
+              "you_get": { "type": "string" },
+              "decide": { "type": "string", "description": "The human decision at this step, if any: a loop gate or a judgment call." }
+            }
+          }
+        },
+        "you_end_with": { "type": "string" }
+      }
+    },
+    "requires": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "RFC-0033. Packs installed together with this one (in practice, `core`). One level only: a required pack may not itself require."
+    }
+  }
+}

skilldrop_cli/data/contracts/skill.schema.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/sananthanarayan/skilldrop/contracts/skill.schema.json",
+  "title": "skilldrop skill manifest",
+  "$comment": "RFC-0029. This shape lived only as prose in AGENTS.md, so the one authoritative statement of what a manifest is was a paragraph a contributor had to read and obey. It is now data. Checked by hand-rolled stdlib code in validate.py — skilldrop ships zero runtime dependencies and this file must not become a reason to add `jsonschema`.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["name", "version", "description", "entrypoint", "deps", "env", "related", "tags", "model"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "description": "Kebab-case. Must equal the folder name AND the SKILL.md frontmatter name — the triple-match in golden rule 1."
+    },
+    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+    "description": {
+      "type": "string",
+      "description": "The most-read string in the skill. Use-case-first: what it does, then the trigger phrases an agent matches on. Must match the SKILL.md frontmatter description."
+    },
+    "entrypoint": { "const": "SKILL.md" },
+    "deps": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["npm", "pip"],
+      "properties": {
+        "npm": { "type": "array", "items": { "type": "string" } },
+        "pip": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "env": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["required", "optional"],
+      "properties": {
+        "required": { "type": "array", "items": { "type": "string" },
+                      "description": "Vars the skill cannot work without, e.g. FIGMA_TOKEN." },
+        "optional": { "type": "array", "items": { "type": "string" },
+                      "description": "Vars that change behaviour but do not block." }
+      }
+    },
+    "permissions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["network", "commands", "files"],
+      "description": "RFC-0039 (OWASP AST03, AST10). What the skill's scripts do, declared so a reader and `skilldrop scan` can compare it with what the code does. Required for every skill that ships scripts/.",
+      "properties": {
+        "network": { "type": "array", "items": { "type": "string" },
+                     "description": "Hosts the scripts contact, e.g. api.figma.com. Empty means none." },
+        "commands": { "type": "array", "items": { "type": "string" },
+                      "description": "External programs the scripts run, e.g. pdftotext. \"*\" means commands the user configures. Empty means none." },
+        "files": { "type": "string", "enum": ["none", "named-paths", "project", "anywhere"],
+                   "description": "What the scripts write: nothing; only paths the user names; inside the current project; or anywhere." },
+        "notes": { "type": "string", "description": "Anything a reviewer should know that the fields can't say." }
+      }
+    },
+    "related": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Undirected: every sibling this SKILL.md references, in either direction. validate.py enforces the sync both ways."
+    },
+    "handoff": {
+      "type": "array",
+      "description": "RFC-0028. The directed companion to `related`. Every `to` must also appear in `related`.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["to", "when", "purpose", "fallback"],
+        "properties": {
+          "to": { "type": "string", "description": "A skill folder name. Never this skill." },
+          "when": { "type": "string", "description": "The condition under which the hand-off fires." },
+          "purpose": { "type": "string", "description": "What the target does with what it receives." },
+          "fallback": { "type": "string", "description": "What to do when the target is not installed. Required — this is what makes an advisory hand-off degrade in a stated way instead of dead-ending." }
+        }
+      }
+    },
+    "tags": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+    "model": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["tier", "rationale"],
+      "properties": {
+        "tier": {
+          "enum": ["light", "standard", "heavy"],
+          "description": "Abstract and provider-neutral. Never a vendor model name — the provider map in model-routing.json is the only place concrete models live. Must agree with this skill's entry there."
+        },
+        "rationale": { "type": "string", "description": "One sentence: why this tier fits what the skill does." }
+      }
+    },
+    "install": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Human-readable install lines for a skill with runtime deps.",
+      "properties": { "npm": { "type": "string" }, "pip": { "type": "string" } }
+    },
+    "hooks": {
+      "type": "array",
+      "description": "RFC-0006. Only for loop-shaped skills that benefit from event automation; artifact generators carry none.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["event", "action", "description"],
+        "properties": {
+          "event": { "enum": ["session-start", "pre-commit-review", "on-demand"] },
+          "action": { "type": "string", "description": "A real skill folder this hook points at." },
+          "description": { "type": "string" }
+        }
+      }
+    }
+  }
+}

skilldrop_cli/data/contracts/terminals.json

@@ -0,0 +1,33 @@
+{
+  "$comment": "RFC-0028 — the shared verdict vocabulary. Before this file, every gating skill invented its own terminal words: feature-implement-loop says VERIFIED, pre-merge-review says READY, council-review says PROCEED, doc-critique says SHIP IT. They mean the same five things. A loop's gate declares which verdicts it can emit, and validate.py checks every one against this file — so a new loop cannot invent a sixth kind of 'yes'.",
+  "version": "1.0.0",
+  "classes": {
+    "pass": "The gate is satisfied. The loop advances to the next stage, or terminates successfully.",
+    "conditional": "The gate is satisfied, but named open items travel forward with the artifact. Advancing is allowed; forgetting the items is not.",
+    "revise": "The gate is not satisfied and the fix is known. Return to the stage named by the loop's revision edge, subject to the cap.",
+    "redirect": "The gate is not satisfied and the work is the wrong shape. Do not revise — re-enter a different stage, a different loop, or a different artifact.",
+    "blocked": "The gate cannot be evaluated. A required input, decision, or permission is missing. Stop and name what is needed."
+  },
+  "verdicts": {
+    "VERIFIED":                 { "class": "pass",        "origin": "feature-implement-loop" },
+    "READY":                    { "class": "pass",        "origin": "pre-merge-review" },
+    "PROCEED":                  { "class": "pass",        "origin": "council-review" },
+    "SHIP IT":                  { "class": "pass",        "origin": "doc-critique" },
+    "VERIFIED WITH OPEN ITEMS": { "class": "conditional", "origin": "feature-implement-loop" },
+    "PROCEED WITH CONDITIONS":  { "class": "conditional", "origin": "council-review" },
+    "SHIP WITH CHANGES":        { "class": "conditional", "origin": "doc-critique" },
+    "NOT READY":                { "class": "revise",      "origin": "pre-merge-review" },
+    "REVISE":                   { "class": "revise",      "origin": "council-review" },
+    "MAJOR REWRITE":            { "class": "revise",      "origin": "doc-critique" },
+    "RECONSIDER":               { "class": "redirect",    "origin": "council-review" },
+    "SPLIT":                    { "class": "redirect",    "origin": "council-review" },
+    "WRONG ARTIFACT":           { "class": "redirect",    "origin": "doc-critique" },
+    "BLOCKED":                  { "class": "blocked",     "origin": "feature-implement-loop" }
+  },
+  "rules": [
+    "Every gate declares at least one `pass` verdict and at least one non-pass verdict. A gate that can only succeed is not a gate.",
+    "Every gate can emit BLOCKED. A missing input is always possible and must never be fabricated past (AGENTS.md, non-interactive invocation).",
+    "A `revise` verdict is subject to the loop's `cap`. On the cap-th revise, the loop emits its conditional or blocked terminal instead of looping again.",
+    "A `redirect` verdict leaves the loop. It names where the work goes instead."
+  ]
+}