session-orchestrator 3.24.0 → 4.0.1

package/.codex-plugin/skills/remote-offload/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: remote-offload
+description: Use when local resource pressure would shrink or coordinator-direct a wave, a wave plan carries heavy build/test/audit roles (test, ui, perf), or the operator says offload, remote host, or auslagern — reference for routing that wave role to a declared SSH-reachable host instead of reducing agent count
+metadata:
+  user-invocable: 'false'
+  tags: reference, remote, offload, wave-executor, resource-gate
+  model: haiku
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# remote-offload
+
+Read [`skills/remote-offload/SKILL.md`](../../../skills/remote-offload/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

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

@@ -0,0 +1,19 @@
+---
+name: repo-audit
+description: Run a 9-category baseline compliance audit on the current repository
+---
+
+<!-- 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.
+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/agents/openai.yaml

@@ -0,0 +1,5 @@
+# Generated by scripts/generate-codex-skills.mjs; do not edit.
+interface:
+  display_name: repo-audit
+policy:
+  allow_implicit_invocation: true

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

@@ -0,0 +1,21 @@
+---
+name: session
+description: Start a development session (housekeeping, feature, deep; ultradeep = deep + profile)
+metadata:
+  argument-hint: '[housekeeping|feature|deep|ultradeep]'
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# session
+
+Read [`commands/session.md`](../../../commands/session.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/agents/openai.yaml

@@ -0,0 +1,5 @@
+# Generated by scripts/generate-codex-skills.mjs; do not edit.
+interface:
+  display_name: session
+policy:
+  allow_implicit_invocation: true

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

@@ -0,0 +1,22 @@
+---
+name: session-end
+description: 'Use this skill when performing a full session close-out: verifies all planned work against the agreed plan, creates issues for gaps, runs quality gates, commits cleanly, mirrors to GitHub, and produces a session summary. Triggered by /close command.'
+metadata:
+  user-invocable: 'false'
+  tags: orchestration, verification, commits, issues
+  model: inherit
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# session-end
+
+Read [`skills/session-end/SKILL.md`](../../../skills/session-end/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

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

@@ -0,0 +1,22 @@
+---
+name: session-plan
+description: Creates a structured wave execution plan with role-based assignment after user alignment. Decomposes agreed tasks into configurable waves (default 5) with optimal agent assignment, dependency ordering, and inter-wave checkpoints. Activated by session-start after Q&A phase completes.
+metadata:
+  user-invocable: 'false'
+  tags: orchestration, planning, waves, agents
+  model: inherit
+  model-preference: opus
+  model-preference-codex: gpt-5.4
+  model-preference-cursor: claude-opus-4-6
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# session-plan
+
+Read [`skills/session-plan/SKILL.md`](../../../skills/session-plan/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

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

@@ -0,0 +1,22 @@
+---
+name: session-start
+description: Use this skill when initializing a session for any project repo. Autonomously analyzes git state, VCS issues, SSOT files, branches, environment, and cross-repo status. Then presents structured findings with recommendations for user alignment before creating a wave plan. Triggered by /session [housekeeping|feature|deep] command.
+metadata:
+  user-invocable: 'false'
+  tags: orchestration, initialization, analysis, alignment
+  model: inherit
+  model-preference: opus
+  model-preference-codex: gpt-5.4
+  model-preference-cursor: claude-opus-4-6
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# session-start
+
+Read [`skills/session-start/SKILL.md`](../../../skills/session-start/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

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

@@ -0,0 +1,21 @@
+---
+name: spinout
+description: Guided 5-step venture-spinout / sanitized-fork runbook (copy + fresh-init + SNAPSHOT-FREEZE) — interactive, not scripted
+metadata:
+  argument-hint: '[--type venture|snapshot] [--dry-run]'
+---
+
+<!-- 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.
+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/spinout/agents/openai.yaml

@@ -0,0 +1,5 @@
+# Generated by scripts/generate-codex-skills.mjs; do not edit.
+interface:
+  display_name: spinout
+policy:
+  allow_implicit_invocation: true

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

@@ -0,0 +1,21 @@
+---
+name: sunset-review
+description: Identify unused / near-zero-use / stale skills, agents, and commands as Demote or Retire candidates (read-only; never deletes)
+metadata:
+  argument-hint: '[--kind skill|agent|command] [--window-days N]'
+---
+
+<!-- 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.
+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/agents/openai.yaml

@@ -0,0 +1,5 @@
+# Generated by scripts/generate-codex-skills.mjs; do not edit.
+interface:
+  display_name: sunset-review
+policy:
+  allow_implicit_invocation: true

package/.codex-plugin/skills/templates-ack/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: templates-ack
+description: Acknowledge templates-first policy for the current session — bypasses the pre-bash-templates-first hook for the remainder of the session
+metadata:
+  argument-hint: '[optional-reason]'
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# templates-ack
+
+Read [`commands/templates-ack.md`](../../../commands/templates-ack.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/templates-ack/agents/openai.yaml

@@ -0,0 +1,5 @@
+# Generated by scripts/generate-codex-skills.mjs; do not edit.
+interface:
+  display_name: templates-ack
+policy:
+  allow_implicit_invocation: true

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

@@ -0,0 +1,21 @@
+---
+name: test
+description: Agentic end-to-end test orchestrator — drive web/macOS flows, evaluate UX rubric, reconcile issues
+metadata:
+  argument-hint: '[scope|profile-name] [--since <git-ref>] [--full]'
+---
+
+<!-- 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.
+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/agents/openai.yaml

@@ -0,0 +1,5 @@
+# Generated by scripts/generate-codex-skills.mjs; do not edit.
+interface:
+  display_name: test
+policy:
+  allow_implicit_invocation: true

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

@@ -0,0 +1,22 @@
+---
+name: test-runner
+description: 'Use this skill when orchestrating agentic end-to-end tests. Resolves target + profile, dispatches the right driver(s) (playwright for web today, peekaboo for macOS (issue #381)), invokes the ux-evaluator agent (opus, read-only) against driver artifacts, reconciles findings with the open issue tracker via scripts/lib/test-runner/issue-reconcile.mjs, and writes report.md + JSONL roll-up. Wraps upstream tools (no forks). Hard-gates Playwright MCP for browser drive (4× token cost vs CLI per Microsoft''s own benchmark).'
+metadata:
+  user-invocable: 'false'
+  tags: test, orchestrator, e2e, ux
+  model: sonnet
+  model-preference: sonnet
+  model-preference-codex: gpt-5.4
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# test-runner
+
+Read [`skills/test-runner/SKILL.md`](../../../skills/test-runner/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/tmux-layout/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: tmux-layout
+description: 'Use this skill when the operator wants a prepared tmux visualization layout for the session''s side-channels (STATE.md tail, CI-watch, events.jsonl tail). Renders a 4-pane default layout or debug layout. Read-only side-channel observability — the coordinator chat stays in the operator''s original terminal. Trigger phrases: "tmux layout", "split panes for ci watch", "visualize session side-channels", "show me state-md tail and ci".'
+metadata:
+  model: inherit
+  color: cyan
+allowed-tools:
+  - Read
+  - Bash
+  - Grep
+  - Glob
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# tmux-layout
+
+Read [`skills/tmux-layout/SKILL.md`](../../../skills/tmux-layout/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/using-orchestrator/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: using-orchestrator
+description: 'Use this skill when dispatching implicit slash-command intent from the user''s first message. Inspects the user''s first message for implicit slash-command intent and dispatches to the highest-confidence matching entry-point skill via the Skill tool. Only active when `auto-skill-dispatch: true` in Session Config. Silent no-op otherwise.'
+metadata:
+  user-invocable: 'false'
+  tags: dispatch, meta, routing, auto-skill
+  model: haiku
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# using-orchestrator
+
+Read [`skills/using-orchestrator/SKILL.md`](../../../skills/using-orchestrator/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/vault-mirror/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: vault-mirror
+description: 'Use when you need to populate the Meta-Vault with machine-generated notes derived from session-orchestrator JSONL records. Converts entries from `.orchestrator/metrics/sessions.jsonl` and `.orchestrator/metrics/learnings.jsonl` into vault-conformant Markdown under `50-sessions/` and `40-learnings/`. Called automatically at session-end Phase 3.7 and after evolve Phase 3.5 — only when `vault-integration.enabled=true` and `vault-integration.mode != "off"`. Idempotent: re-runs safely; skips hand-authored notes. Triggers: "mirror to vault", "sync session notes to vault", "write learning notes to vault", "vault-mirror failed at session close". <example>Context: session-end is finalizing, vault-integration.mode is "warn". user: "/close" assistant: "Running vault-mirror to write 50-sessions/session-2026-05-17.md from the closing session record — 1 created, 0 skipped."</example>'
+metadata:
+  model: haiku
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# vault-mirror
+
+Read [`skills/vault-mirror/SKILL.md`](../../../skills/vault-mirror/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/vault-sync/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: vault-sync
+description: 'Use when you need to validate the Meta-Vault''s Markdown frontmatter and wiki-link integrity before closing a session or after vault edits. Runs as a hard gate at session-end Phase 1 — blocks close if any `.md` file fails the Zod frontmatter schema or has dangling `[[wiki-links]]`. Supports three modes: `hard` (blocks on errors), `warn` (reports without blocking), `off` (skip). Reads `vault-sync.*` from Session Config; respects per-vault exclude globs from `CLAUDE.md`. Triggers: "vault validation failed at session close", "fix vault frontmatter errors", "check vault wiki-links", "why is session-end blocked by vault-sync". <example>Context: session-end Phase 1 quality gate, vault-sync.enabled=true, vault-sync.mode="hard". user: "/close" assistant: "vault-sync found 2 frontmatter errors in vault/40-learnings/ml-notes.md — missing required `id` field. Fixing before close."</example>'
+metadata:
+  model: haiku
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# vault-sync
+
+Read [`skills/vault-sync/SKILL.md`](../../../skills/vault-sync/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/wave-executor/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: wave-executor
+description: Use this skill when executing the agreed session plan in waves with role-based execution and parallel subagents. Handles inter-wave quality checks, plan adaptation, and progress tracking. Core orchestration engine for feature and deep sessions. Triggered by /go command.
+metadata:
+  user-invocable: 'false'
+  tags: orchestration, execution, agents, waves
+  model: inherit
+  model-preference: opus
+  model-preference-codex: gpt-5.4-mini
+  model-preference-cursor: claude-sonnet-4-6
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# wave-executor
+
+Read [`skills/wave-executor/SKILL.md`](../../../skills/wave-executor/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.codex-plugin/skills/write-executable-plan/SKILL.md

@@ -0,0 +1,24 @@
+---
+name: write-executable-plan
+description: Use when you have a PRD or design spec and need a bite-sized, executable implementation plan that any agent can follow without re-deriving structure. Produces `docs/plans/YYYY-MM-DD-<feature>.md` with per-task Files block, complete code per step (no placeholders), and exact verification commands. Rejects "TBD", "TODO", "add error handling", "similar to Task N".
+metadata:
+  model: inherit
+  color: green
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Bash
+  - Write
+---
+
+<!-- Generated by scripts/generate-codex-skills.mjs; do not edit. -->
+
+# write-executable-plan
+
+Read [`skills/write-executable-plan/SKILL.md`](../../../skills/write-executable-plan/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.
+
+Regenerate with `node scripts/generate-codex-skills.mjs`.

package/.cursor/commands/autopilot.md

@@ -1,6 +1,6 @@
 ---
-description: Autonomous session-orchestration loop with kill-switches (Phase C-1.b — all 10 kill-switches shipped)
-argument-hint: [--headless] [--verbose] [--max-sessions=N] [--max-hours=H] [--confidence-threshold=0.X] [--dry-run]
+description: "Autonomous session-orchestration loop with kill-switches (Phase C-1.b — all 10 kill-switches shipped)"
+argument-hint: "[--headless] [--verbose] [--max-sessions=N] [--max-hours=H] [--confidence-threshold=0.X] [--dry-run]"
 ---
 
 # /autopilot

package/.cursor/commands/bootstrap.md

@@ -1,6 +1,6 @@
 ---
 description: Scaffold the minimum repo structure required by session-orchestrator
-argument-hint: [--upgrade <tier>]
+argument-hint: "[--upgrade <tier>]"
 ---
 
 # /bootstrap

package/.cursor/commands/brainstorm.md

@@ -1,6 +1,6 @@
 ---
 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.
-argument-hint: [topic-or-feature-slug]
+argument-hint: "[topic-or-feature-slug]"
 ---
 
 # /brainstorm

package/.cursor/commands/debug.md

@@ -1,6 +1,6 @@
 ---
 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."
-argument-hint: [bug-description-or-issue-ref]
+argument-hint: "[bug-description-or-issue-ref]"
 ---
 
 # /debug

package/.cursor/commands/discovery.md

@@ -1,6 +1,6 @@
 ---
 description: Systematic quality discovery and issue detection
-argument-hint: [all|code|infra|ui|arch|session|audit|vault|feature] [--since <git-ref>] [--full]
+argument-hint: "[all|code|infra|ui|arch|session|audit|vault|feature] [--since <git-ref>] [--full]"
 ---
 
 # /discovery

package/.cursor/commands/dispatcher.md

@@ -1,6 +1,6 @@
 ---
-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
-argument-hint: [--dry-run] [--repo <name>]
+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"
+argument-hint: "[--dry-run] [--repo <name>]"
 ---
 
 # /dispatcher

package/.cursor/commands/eli5.md

@@ -1,6 +1,6 @@
 ---
-description: Say the last answer again in plain words — same facts, in the order the operator needs them. Optional topic argument.
-argument-hint: [topic]
+description: "Say the last answer again in plain words — same facts, in the order the operator needs them. Optional topic argument."
+argument-hint: "[topic]"
 ---
 
 # /eli5

package/.cursor/commands/eval.md

@@ -1,6 +1,6 @@
 ---
-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
-argument-hint: [--session <id>] [--no-write] [--verify <run-id>]
+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"
+argument-hint: "[--session <id>] [--no-write] [--verify <run-id>]"
 ---
 
 # /eval

package/.cursor/commands/evolve.md

@@ -1,6 +1,6 @@
 ---
 description: Extract session patterns into reusable learnings
-argument-hint: [analyze|review|list|dialectic [--apply]]
+argument-hint: "[analyze|review|list|dialectic [--apply]]"
 ---
 
 # /evolve

package/.cursor/commands/go.md

@@ -1,6 +1,6 @@
 ---
 description: Approve session plan and begin wave execution
-argument-hint: [optional instructions]
+argument-hint: "[optional instructions]"
 ---
 
 # /go

package/.cursor/commands/grill.md

@@ -1,6 +1,6 @@
 ---
-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.
-argument-hint: [file-path-or-topic]
+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."
+argument-hint: "[file-path-or-topic]"
 ---
 
 # /grill

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

@@ -1,6 +1,6 @@
 ---
-description: Manual memory consolidation — review, consolidate, and prune memory files (Dream-equivalent)
-argument-hint: [--dry-run | --apply-pending]
+description: "Manual memory consolidation — review, consolidate, and prune memory files (Dream-equivalent)"
+argument-hint: "[--dry-run | --apply-pending]"
 ---
 
 # /memory-cleanup

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

@@ -1,6 +1,6 @@
 ---
 description: Run a parallel multi-persona domain-expert review panel against a file, directory, or output range
-argument-hint: <target> [--personas <names,...>] [--mode <voting|hard-gate|summary>] [--threshold <M-of-N|all|any>] [--grounding <off|re-derive>] [--dry-run]
+argument-hint: "<target> [--personas <names,...>] [--mode <voting|hard-gate|summary>] [--threshold <M-of-N|all|any>] [--grounding <off|re-derive>] [--dry-run]"
 ---
 
 # /persona-panel

package/.cursor/commands/plan.md

@@ -1,6 +1,6 @@
 ---
 description: Plan a new project, feature, or retrospective with structured requirement gathering
-argument-hint: [new|feature|retro]
+argument-hint: "[new|feature|retro]"
 ---
 
 # /plan

package/.cursor/commands/portfolio.md

@@ -1,6 +1,6 @@
 ---
 description: Aggregate cross-repo issue/MR/CI health across vault-registered projects into a single Markdown dashboard
-argument-hint: [--dry-run] [--repo <name>]
+argument-hint: "[--dry-run] [--repo <name>]"
 ---
 
 # /portfolio

package/.cursor/commands/reconcile.md

@@ -1,6 +1,6 @@
 ---
-description: Reconcile learnings into .claude/rules/ proposals — on-demand version of session-end Phase 3.6.8
-argument-hint: [--dry-run]
+description: "Reconcile learnings into .claude/rules/ proposals — on-demand version of session-end Phase 3.6.8"
+argument-hint: "[--dry-run]"
 ---
 
 # /reconcile

package/.cursor/commands/release.md

@@ -1,6 +1,6 @@
 ---
-description: Cut a release — the order the steps must run in, and the criteria that abort a release
-argument-hint: [X.Y.Z]
+description: "Cut a release — the order the steps must run in, and the criteria that abort a release"
+argument-hint: "[X.Y.Z]"
 ---
 
 # /release

package/.cursor/commands/session.md

@@ -1,6 +1,6 @@
 ---
-description: Start a development session (housekeeping, feature, deep)
-argument-hint: [housekeeping|feature|deep]
+description: "Start a development session (housekeeping, feature, deep; ultradeep = deep + profile)"
+argument-hint: "[housekeeping|feature|deep|ultradeep]"
 ---
 
 # /session

package/.cursor/commands/spinout.md

@@ -1,6 +1,6 @@
 ---
-description: Guided 5-step venture-spinout / sanitized-fork runbook (copy + fresh-init + SNAPSHOT-FREEZE) — interactive, not scripted
-argument-hint: [--type venture|snapshot] [--dry-run]
+description: "Guided 5-step venture-spinout / sanitized-fork runbook (copy + fresh-init + SNAPSHOT-FREEZE) — interactive, not scripted"
+argument-hint: "[--type venture|snapshot] [--dry-run]"
 ---
 
 # /spinout