session-orchestrator 5.1.0 → 5.3.0

package/.codex-plugin/skills/reconcile/SKILL.md

@@ -1,21 +1,26 @@
 ---
 name: reconcile
-description: Reconcile learnings into .claude/rules/ proposals — on-demand version of session-end Phase 3.6.8
+description: Use this skill when the user wants to reconcile learnings into rules, run /reconcile, propose rules from learnings, turn learnings into .claude/rules/ entries, or review what rules would be generated from current session learnings. On-demand version of session-end Phase 3.6.8.
 metadata:
+  user-invocable: 'true'
   argument-hint: '[--dry-run]'
+  tags: learning, rules, intelligence, meta
+  model: sonnet
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+  args-schema: '[{"flag":"--dry-run","description":"Print proposals without writing anything or rendering the approval AUQ"}]'
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # reconcile
 
-Read [`commands/reconcile.md`](../../../commands/reconcile.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/reconcile/SKILL.md`](../../../skills/reconcile/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/release/SKILL.md

@@ -2,21 +2,21 @@
 name: release
 description: Cut a release — the order the steps must run in, and the criteria that abort a release
 metadata:
+  user-invocable: 'true'
   disable-model-invocation: 'true'
   argument-hint: '[X.Y.Z]'
+  model: inherit
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # release
 
-Read [`commands/release.md`](../../../commands/release.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/release/SKILL.md`](../../../skills/release/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/repo-audit/SKILL.md

@@ -1,19 +1,21 @@
 ---
 name: repo-audit
-description: Run a 9-category baseline compliance audit on the current repository
+description: 'Use this skill when the user wants to audit a repository for baseline compliance, check code quality, security posture, CI/CD setup, testing, documentation, and ecosystem configuration. Runs 9 checklist categories and emits a Markdown report plus JSON sidecar at .orchestrator/metrics/repo-audit-<timestamp>.json. <example>Context: User is in a project repo and wants a baseline compliance check. user: "/repo-audit" assistant: "Running repo-audit across 9 categories — Configuration, Code Quality, Git Hygiene, CI/CD, Testing, Security, Documentation, Clank Integration (optional), and MCP Configuration. Will produce a Markdown checklist report and JSON sidecar." <commentary>The user wants a compliance check; this skill is appropriate because it runs all 9 categories with pass/fail/warn/skipped statuses and writes structured output.</commentary></example>'
+metadata:
+  user-invocable: 'true'
+  model: inherit
+  color: cyan
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # repo-audit
 
-Read [`commands/repo-audit.md`](../../../commands/repo-audit.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/repo-audit/SKILL.md`](../../../skills/repo-audit/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/session/SKILL.md

@@ -2,7 +2,7 @@
 name: session
 description: Start a development session (housekeeping, feature, deep; ultradeep = deep + profile)
 metadata:
-  argument-hint: '[housekeeping|feature|deep|ultradeep]'
+  argument-hint: '[housekeeping|feature|deep|ultradeep] [task context]'
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->

package/.codex-plugin/skills/spinout/SKILL.md

@@ -1,21 +1,21 @@
 ---
 name: spinout
-description: Guided 5-step venture-spinout / sanitized-fork runbook (copy + fresh-init + SNAPSHOT-FREEZE) — interactive, not scripted
+description: 'Use when extracting a project into its own repo — a venture spinout (e.g. a product leaving its incubator repo) or a sanitized content-snapshot fork. Guided 5-step runbook: target sphere + path, confidentiality/sanitize check, copy + fresh git init, SNAPSHOT-FREEZE marker in the source repo, remotes + registration. Trigger on ''spin out X'', ''extract this into its own repo'', ''fork X sanitized''.'
 metadata:
+  user-invocable: 'true'
   argument-hint: '[--type venture|snapshot] [--dry-run]'
+  model: sonnet
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # spinout
 
-Read [`commands/spinout.md`](../../../commands/spinout.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/spinout/SKILL.md`](../../../skills/spinout/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/sunset-review/SKILL.md

@@ -1,21 +1,22 @@
 ---
 name: sunset-review
-description: Identify unused / near-zero-use / stale skills, agents, and commands as Demote or Retire candidates (read-only; never deletes)
+description: 'Use this skill when the user wants to identify unused, near-zero-use, or stale skills/agents/commands in the plugin surface so they can be demoted or retired. Combines agent-dispatch telemetry (start-events only) with static reference scanning, classifies every surface item into Active / Investigate / Demote / Retire, and emits a Markdown report plus JSON sidecar. NEVER auto-deletes — surfaces candidates for human decision. Quarterly cadence. <example>Context: The plugin surface has grown and the maintainer wants to prune dead weight. user: "/sunset-review" assistant: "Running the sunset walk — classifying skills, agents, and commands by usage telemetry + static refs, grouped by Retire / Demote / Investigate / Active. No item is deleted automatically; I''ll surface Retire/Demote candidates for your decision." <commentary>The user wants a usage-driven prune candidate list; this skill runs the read-only walker, presents grouped verdicts, and writes a sidecar — it never deletes.</commentary></example>'
 metadata:
+  user-invocable: 'true'
   argument-hint: '[--kind skill|agent|command] [--window-days N]'
+  model: inherit
+  color: amber
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # sunset-review
 
-Read [`commands/sunset-review.md`](../../../commands/sunset-review.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/sunset-review/SKILL.md`](../../../skills/sunset-review/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/test/SKILL.md

@@ -2,20 +2,20 @@
 name: test
 description: Agentic end-to-end test orchestrator — drive web/macOS flows, evaluate UX rubric, reconcile issues
 metadata:
+  user-invocable: 'true'
   argument-hint: '[scope|profile-name] [--since <git-ref>] [--full]'
+  model: inherit
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # test
 
-Read [`commands/test.md`](../../../commands/test.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/test/SKILL.md`](../../../skills/test/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/ux-grill/SKILL.md

@@ -1,21 +1,28 @@
 ---
 name: ux-grill
-description: Grill a running web app's UX — a deterministic mechanical pass (axe, target size, overflow, journeys) followed by a screenshot-grounded interrogation of the operator.
+description: Use when a running web app's UX has to be audited reproducibly rather than by feel — a deterministic mechanical pass over routes and viewports (axe, target size, horizontal overflow, page title, scripted journeys) followed by a screenshot-grounded interrogation of the operator, journey by journey, with two persona lenses from the target repo's manifest. Triggered by "grill the UX", "roast the dashboard", "UX-Audit", "/ux-grill". Bootstraps its own manifest from a loopback URL on the first run, so it never requires a hand-written file to start.
 metadata:
+  user-invocable: 'true'
   argument-hint: '[url | manifest-path]'
+  model: inherit
+  color: magenta
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
 ---
 
 <!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
 
 # ux-grill
 
-Read [`commands/ux-grill.md`](../../../commands/ux-grill.md) in full before taking any action, then follow its complete workflow.
+Read [`skills/ux-grill/SKILL.md`](../../../skills/ux-grill/SKILL.md) in full before taking any action, then follow its complete workflow.
 The linked document is authoritative, including its prechecks, argument rules, and stop conditions.
 
 Resolve this link relative to this SKILL.md, not the project working directory. The plugin root is three directories above this file. Resolve package paths such as `skills/` and `scripts/` from that root; resolve relative links inside the canonical document from its own directory. Keep the user’s project as the target of project operations.
 
 `$ARGUMENTS` means the trailing user input after the selected command skill, or an empty string when absent. Preserve flags, quoted text, and Unicode as data. Do not perform global substitution in the command document, shell expansion on the argument string, or execution of that string as shell code. When the workflow needs a command, pass its arguments through structured tool parameters or safely quoted individual arguments.
 
-Read the full command before invoking an internal skill. An instruction to invoke a skill (including `session-orchestrator:<name>` or the `Skill` tool) means read and follow the canonical `skills/<name>/SKILL.md` beneath the plugin root. Do not redispatch the public command adapter: a same-named command and internal skill are distinct documents, and redispatch would recurse.
-
 Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.cursor/commands/autopilot.md

@@ -1,14 +1,14 @@
 ---
-description: "Autonomous session-orchestration loop with kill-switches (Phase C-1.b — all 10 kill-switches shipped)"
+description: "Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan → wave-executor → session-end for N iterations with all 10 kill-switches (SPIRAL, FAILED wave, carryover > 50%, max-hours, max-sessions, resource-overload, token-budget, stall-timeout, sub-threshold confidence, user-abort). Reads Mode-Selector output (Phase B) to decide auto-execute vs. fallback. Writes one autopilot.jsonl record per loop run. Phase C scaffold (issue #277); implementation lives in scripts/lib/autopilot.mjs (Phase C-1 follow-up)."
 argument-hint: "[--headless] [--verbose] [--max-sessions=N] [--max-hours=H] [--confidence-threshold=0.X] [--dry-run]"
 ---
 
 # /autopilot
 
-Use the Session Orchestrator command definition at `commands/autopilot.md`.
+Use the Session Orchestrator skill definition at `skills/autopilot/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/bootstrap.md

@@ -1,14 +1,15 @@
 ---
-description: Scaffold the minimum repo structure required by session-orchestrator
+description: "Use this skill when scaffolding the minimum repository structure required by session-orchestrator. Invoked automatically by the Bootstrap Gate when CLAUDE.md, Session Config, or bootstrap.lock is missing. Also available as /bootstrap for manual invocation. Three intensity tiers: fast (demos/spikes), standard (MVPs), deep (production/team)."
 argument-hint: "[--upgrade <tier>]"
+disable-model-invocation: true
 ---
 
 # /bootstrap
 
-Use the Session Orchestrator command definition at `commands/bootstrap.md`.
+Use the Session Orchestrator skill definition at `skills/bootstrap/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/brainstorm.md

@@ -1,14 +1,15 @@
 ---
-description: Run a lightweight Socratic design dialogue (3-5 AUQ rounds) and write a spec markdown file before any implementation work. Use BEFORE /plan feature when scope/UX is ambiguous.
+description: "Use when you have a feature idea but the scope or UX is still ambiguous — runs a lightweight Socratic design dialogue (3-5 AUQ rounds) and writes a spec markdown file. Use BEFORE /plan feature when product intent needs validation; skip to /plan feature when scope is already clear. HARD-GATE prevents any code work until the design is user-approved."
 argument-hint: "[topic-or-feature-slug]"
+disable-model-invocation: true
 ---
 
 # /brainstorm
 
-Use the Session Orchestrator command definition at `commands/brainstorm.md`.
+Use the Session Orchestrator skill definition at `skills/brainstorm/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/close.md

@@ -1,13 +1,14 @@
 ---
 description: End session with verification, commits, and documentation
+disable-model-invocation: true
 ---
 
 # /close
 
-Use the Session Orchestrator command definition at `commands/close.md`.
+Use the Session Orchestrator skill definition at `skills/close/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/debug.md

@@ -1,14 +1,14 @@
 ---
-description: "Run a 4-phase systematic debugging investigation before proposing any fix. Iron Law — NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST. Produces a `.orchestrator/debug/` artifact the fixer agent must reference."
+description: "Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging process before proposing any fix. Iron Law: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST. Produces a `.orchestrator/debug/` artifact the fixer agent must reference."
 argument-hint: "[bug-description-or-issue-ref]"
 ---
 
 # /debug
 
-Use the Session Orchestrator command definition at `commands/debug.md`.
+Use the Session Orchestrator skill definition at `skills/debug/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/discovery.md

@@ -1,14 +1,14 @@
 ---
-description: Systematic quality discovery and issue detection
+description: "Use this skill when running systematic quality discovery and issue detection. Runs modular probes adapted to the project's tech stack, presents findings interactively for user triage, and creates VCS issues for confirmed problems. Invoked standalone via /discovery or embedded in session-end."
 argument-hint: "[all|code|infra|ui|arch|session|audit|vault|feature] [--since <git-ref>] [--full]"
 ---
 
 # /discovery
 
-Use the Session Orchestrator command definition at `commands/discovery.md`.
+Use the Session Orchestrator skill definition at `skills/discovery/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/dispatcher.md

@@ -1,14 +1,14 @@
 ---
-description: "Pick the next-best repo to work on across the portfolio — rank free repos, recommend one, claim its lease atomically, and route to the entry command"
+description: "Use when you want the orchestrator to pick the next repo to work on across your whole portfolio — it enumerates candidate repos below the confinement root, resolves free/busy from each repo's session.lock lease, ranks the FREE ones by backlog priority × staleness × readiness, recommends the single most worthwhile one via AskUserQuestion, atomically claims it, and routes you to the chosen entry command. Triggers: \"what should I work on next\", \"dispatch me to a repo\", \"pick the next project\", \"run /dispatcher\". <example>Context: operator finished a session and wants the next-best repo across the portfolio. user: \"/dispatcher\" assistant: \"Ranked 18 free repos — top recommendation: Pencil-Designs (score 4.50, 90d stale). Confirm via the picker, I'll claim its lease atomically, then route you to /session deep.\"</example>"
 argument-hint: "[--dry-run] [--repo <name>]"
 ---
 
 # /dispatcher
 
-Use the Session Orchestrator command definition at `commands/dispatcher.md`.
+Use the Session Orchestrator skill definition at `skills/dispatcher/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/eli5.md

@@ -1,14 +1,14 @@
 ---
-description: "Say the last answer again in plain words — same facts, in the order the operator needs them. Optional topic argument."
+description: "Explain a topic like I'm a 5 year old — restate my last output, or a named topic, in plain words without dropping a single fact. Use when the user types /eli5 [topic], or says an answer was too technical, too long, or unclear about what he now has to do."
 argument-hint: "[topic]"
 ---
 
 # /eli5
 
-Use the Session Orchestrator command definition at `commands/eli5.md`.
+Use the Session Orchestrator skill definition at `skills/eli5/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/eval.md

@@ -1,14 +1,14 @@
 ---
-description: "Run an honest session-process evaluation (Standard v1, aiat-llm-eval/1.0) — score the last completed session against the pre-registered rubric-v1 dimensions"
+description: "Use this skill to run an honest session-process evaluation (Standard v1, aiat-llm-eval/1.0) — score the last completed orchestrator session against the pre-registered rubric-v2 dimensions, run /eval, evaluate this session, produce an eval report, or re-verify a stored eval run for reproducibility. Deterministic-first with an optional advisory LLM judge; never produces a global score."
 argument-hint: "[--session <id>] [--no-write] [--verify <run-id>]"
 ---
 
 # /eval
 
-Use the Session Orchestrator command definition at `commands/eval.md`.
+Use the Session Orchestrator skill definition at `skills/eval/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/evolve.md

@@ -1,14 +1,14 @@
 ---
-description: Extract session patterns into reusable learnings
+description: "Use this skill when extracting session patterns into reusable learnings. Three modes: analyze (extract from session history), review (edit/manage existing learnings), list (display active learnings). Manages .orchestrator/metrics/learnings.jsonl."
 argument-hint: "[analyze|review|list|dialectic [--apply]]"
 ---
 
 # /evolve
 
-Use the Session Orchestrator command definition at `commands/evolve.md`.
+Use the Session Orchestrator skill definition at `skills/evolve/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/go.md

@@ -1,14 +1,15 @@
 ---
 description: Approve session plan and begin wave execution
 argument-hint: "[optional instructions]"
+disable-model-invocation: true
 ---
 
 # /go
 
-Use the Session Orchestrator command definition at `commands/go.md`.
+Use the Session Orchestrator skill definition at `skills/go/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/grill.md

@@ -1,14 +1,14 @@
 ---
-description: "Stress-test a plan, design, or PRD before any build — relentless one-question-at-a-time interrogation that hunts contradictions against the code and challenges assumptions. Composable; no HARD-GATE."
+description: "Use when the user wants a plan, design, or PRD stress-tested before any build — relentlessly interrogates one decision at a time, grounds every question in the codebase, hunts contradictions against the domain language and the code, and challenges the load-bearing assumptions. Triggered by \"grill me\", \"stress-test this plan\", \"poke holes in my design\". Composable — run standalone or as an adversarial pass before /plan feature."
 argument-hint: "[file-path-or-topic]"
 ---
 
 # /grill
 
-Use the Session Orchestrator command definition at `commands/grill.md`.
+Use the Session Orchestrator skill definition at `skills/grill/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/harness-audit.md

@@ -4,10 +4,10 @@ description: Run the harness audit and report the rubric score for this reposito
 
 # /harness-audit
 
-Use the Session Orchestrator command definition at `commands/harness-audit.md`.
+Use the Session Orchestrator skill definition at `skills/harness-audit/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/memory-cleanup.md

@@ -1,14 +1,14 @@
 ---
-description: "Manual memory consolidation — review, consolidate, and prune memory files (Dream-equivalent)"
+description: "Use this skill when performing manual memory consolidation (Dream-equivalent). Reviews, consolidates, and prunes memory files under ~/.claude/projects/*/memory/. Run after major refactors, every 5+ sessions, or when memory quality degrades (broken links, stale references, contradictions, MEMORY.md > 200 lines). Invoke with /memory-cleanup."
 argument-hint: "[--dry-run | --apply-pending]"
 ---
 
 # /memory-cleanup
 
-Use the Session Orchestrator command definition at `commands/memory-cleanup.md`.
+Use the Session Orchestrator skill definition at `skills/memory-cleanup/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/persona-panel.md

@@ -1,14 +1,14 @@
 ---
-description: Run a parallel multi-persona domain-expert review panel against a file, directory, or output range
+description: "Use this skill when you need multi-persona parallel content review — domain experts, buyer personas, compliance reviewers, or custom catalog entries reviewing a target file or output. Dispatches N persona agents in parallel, consolidates verdicts via a configurable mode (voting-quorum, hard-gate-threshold, or coordinator-summary), and writes a timestamped sidecar to .orchestrator/persona-panel/. Invoked via /persona-panel <target-path>."
 argument-hint: "<target> [--personas <names,...>] [--mode <voting|hard-gate|summary>] [--threshold <M-of-N|all|any>] [--grounding <off|re-derive>] [--dry-run]"
 ---
 
 # /persona-panel
 
-Use the Session Orchestrator command definition at `commands/persona-panel.md`.
+Use the Session Orchestrator skill definition at `skills/persona-panel/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/plan.md

@@ -1,14 +1,15 @@
 ---
-description: Plan a new project, feature, or retrospective with structured requirement gathering
+description: "Use this skill when performing structured project planning and PRD generation with three modes: new (project kickoff with repo scaffolding), feature (compact feature PRD), retro (data-driven retrospective). All modes share a researched Q&A engine that dispatches parallel Explore agents before each question wave, presents options via AskUserQuestion with recommendations, and produces documents with prioritized issue creation."
 argument-hint: "[new|feature|retro]"
+disable-model-invocation: true
 ---
 
 # /plan
 
-Use the Session Orchestrator command definition at `commands/plan.md`.
+Use the Session Orchestrator skill definition at `skills/plan/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/portfolio.md

@@ -5,10 +5,10 @@ argument-hint: "[--dry-run] [--repo <name>]"
 
 # /portfolio
 
-Use the Session Orchestrator command definition at `commands/portfolio.md`.
+Use the Session Orchestrator skill definition at `skills/portfolio/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.

package/.cursor/commands/reconcile.md

@@ -1,14 +1,14 @@
 ---
-description: "Reconcile learnings into .claude/rules/ proposals — on-demand version of session-end Phase 3.6.8"
+description: Use this skill when the user wants to reconcile learnings into rules, run /reconcile, propose rules from learnings, turn learnings into .claude/rules/ entries, or review what rules would be generated from current session learnings. On-demand version of session-end Phase 3.6.8.
 argument-hint: "[--dry-run]"
 ---
 
 # /reconcile
 
-Use the Session Orchestrator command definition at `commands/reconcile.md`.
+Use the Session Orchestrator skill definition at `skills/reconcile/SKILL.md`.
 
 Arguments: $ARGUMENTS
 
-Read that command file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
+Read that skill file and follow it exactly. When it references `$ARGUMENTS`, substitute the arguments above. Keep all Session Orchestrator platform fallbacks intact.
 
-Cursor has no Skill tool. When the command says to invoke a skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.
+Cursor has no Skill tool. When the skill says to invoke another skill, Read `skills/<skill-name>/SKILL.md` and follow it. Supporting files (`soul.md`, phase docs) live in that same `skills/<skill-name>/` directory.