session-orchestrator 3.23.0 → 4.0.0

package/.agents/skills/repo-audit/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: repo-audit
+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:
+  model: inherit
+  color: cyan
+---
+
+# repo-audit
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/repo-audit/SKILL.md`](../../../skills/repo-audit/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/session-end/SKILL.md

@@ -0,0 +1,20 @@
+---
+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
+---
+
+# session-end
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/session-end/SKILL.md`](../../../skills/session-end/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/session-plan/SKILL.md

@@ -0,0 +1,20 @@
+---
+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
+---
+
+# session-plan
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/session-plan/SKILL.md`](../../../skills/session-plan/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/session-start/SKILL.md

@@ -0,0 +1,20 @@
+---
+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
+---
+
+# session-start
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/session-start/SKILL.md`](../../../skills/session-start/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/spinout/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: spinout
+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"
+  model: sonnet
+---
+
+# spinout
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/spinout/SKILL.md`](../../../skills/spinout/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/sunset-review/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: sunset-review
+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:
+  model: inherit
+  color: amber
+---
+
+# sunset-review
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/sunset-review/SKILL.md`](../../../skills/sunset-review/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/test-runner/SKILL.md

@@ -0,0 +1,20 @@
+---
+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
+---
+
+# test-runner
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/test-runner/SKILL.md`](../../../skills/test-runner/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/tmux-layout/SKILL.md

@@ -0,0 +1,21 @@
+---
+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
+---
+
+# tmux-layout
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/tmux-layout/SKILL.md`](../../../skills/tmux-layout/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/using-orchestrator/SKILL.md

@@ -0,0 +1,17 @@
+---
+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
+---
+
+# using-orchestrator
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/using-orchestrator/SKILL.md`](../../../skills/using-orchestrator/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/vault-mirror/SKILL.md

@@ -0,0 +1,15 @@
+---
+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
+---
+
+# vault-mirror
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/vault-mirror/SKILL.md`](../../../skills/vault-mirror/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/vault-sync/SKILL.md

@@ -0,0 +1,15 @@
+---
+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
+---
+
+# vault-sync
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/vault-sync/SKILL.md`](../../../skills/vault-sync/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/wave-executor/SKILL.md

@@ -0,0 +1,20 @@
+---
+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
+---
+
+# wave-executor
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/wave-executor/SKILL.md`](../../../skills/wave-executor/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.agents/skills/write-executable-plan/SKILL.md

@@ -0,0 +1,22 @@
+---
+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
+---
+
+# write-executable-plan
+
+> **Portable mirror — generated, do not edit.** The canonical skill body lives at
+> [`skills/write-executable-plan/SKILL.md`](../../../skills/write-executable-plan/SKILL.md); read that file for the full instructions.
+> This mirror carries only agentskills.io-spec-legal frontmatter so harnesses that
+> discover skills under `.agents/skills/` can find and route to the skill.
+>
+> Regenerate with `node scripts/generate-agents-skills.mjs`.

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "Loop engineering for AI coding agents — turn ad-hoc sessions into a repeatable research → plan → wave-execute → close loop with verification gates. Runs on Claude Code, Codex CLI, Cursor, and Pi.",
-    "version": "3.23.0"
+    "version": "4.0.0"
   },
   "plugins": [
     {

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "session-orchestrator",
-  "version": "3.23.0",
+  "version": "4.0.0",
   "description": "Loop engineering for AI coding agents — turn ad-hoc sessions into a repeatable research → plan → wave-execute → close loop with verification gates. Runs on Claude Code, Codex CLI, Cursor, and Pi.",
   "author": {
     "name": "Bernhard Goetzendorfer",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "session-orchestrator",
-  "version": "3.23.0+codex.20260828183221",
+  "version": "4.0.0+codex.20260906130352",
   "description": "Loop engineering for AI coding agents — turn ad-hoc sessions into a repeatable research → plan → wave-execute → close loop with verification gates. Runs on Claude Code, Codex CLI, Cursor, and Pi.",
   "keywords": [
     "session",

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

package/.cursor/commands/sunset-review.md

@@ -1,6 +1,6 @@
 ---
-description: Identify unused / near-zero-use / stale skills, agents, and commands as Demote or Retire candidates (read-only; never deletes)
-argument-hint: [--kind skill|agent|command] [--window-days N]
+description: "Identify unused / near-zero-use / stale skills, agents, and commands as Demote or Retire candidates (read-only; never deletes)"
+argument-hint: "[--kind skill|agent|command] [--window-days N]"
 ---
 
 # /sunset-review

package/.cursor/commands/templates-ack.md

@@ -1,6 +1,6 @@
 ---
-description: Acknowledge templates-first policy for the current session — bypasses the pre-bash-templates-first hook for the remainder of the session
-argument-hint: [optional-reason]
+description: "Acknowledge templates-first policy for the current session — bypasses the pre-bash-templates-first hook for the remainder of the session"
+argument-hint: "[optional-reason]"
 ---
 
 # /templates-ack

package/.cursor/commands/test.md

@@ -1,6 +1,6 @@
 ---
-description: Agentic end-to-end test orchestrator — drive web/macOS flows, evaluate UX rubric, reconcile issues
-argument-hint: [scope|profile-name] [--since <git-ref>] [--full]
+description: "Agentic end-to-end test orchestrator — drive web/macOS flows, evaluate UX rubric, reconcile issues"
+argument-hint: "[scope|profile-name] [--since <git-ref>] [--full]"
 ---
 
 # /test

package/.cursor/skills/brainstorm/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: brainstorm
-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.
+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."
 disable-model-invocation: true
 ---
 

package/.cursor/skills/eval/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: eval
-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-v1 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.
+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-v1 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."
 ---
 
 # eval

package/.cursor/skills/quality-gates/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: quality-gates
-description: Use this skill when referencing canonical quality check commands for typecheck, test, and lint. Defines 4 variants (Baseline, Incremental, Full Gate, Per-File) used by session-start, wave-executor, session-end, and session-reviewer. Reference skill — not invoked directly.
+description: "Use this skill when referencing canonical quality check commands for typecheck, test, and lint. Defines 4 variants (Baseline, Incremental, Full Gate, Per-File) used by session-start, wave-executor, session-end, and session-reviewer. Reference skill — not invoked directly."
 disable-model-invocation: true
 ---
 

package/.cursor/skills/remote-offload/SKILL.md

@@ -0,0 +1,13 @@
+---
+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"
+disable-model-invocation: true
+---
+
+# remote-offload
+
+Canonical skill: `skills/remote-offload/SKILL.md`
+
+Read that file and follow it exactly. Resolve relative links against `skills/remote-offload/`, not this wrapper.
+
+Cursor has no Skill tool. Treat "invoke the remote-offload skill" as: Read `skills/remote-offload/SKILL.md`.