pantheon-opencode 1.5.1 → 1.6.0-beta.1

package/src/plugin-v2.ts

@@ -4,27 +4,38 @@
  * Registers:
  * - 6 orchestration tools via V2 tool.transform (with V1 bridge fallback)
  * - 4 event subscriptions (session.created, idle, error, compacted)
- * - Session hooks (prompt, context) and tool hooks (execute.before/after)
+ * - Session hooks (prompt, context, compaction) and tool hooks (execute.before/after)
  * - Permission hooks for custom authorization
  *
- * V2 Plugin API surface (confirmed by investigation):
- *   ctx.tool.transform / ctx.event.subscribe / ctx.session.hook /
- *   ctx.tool.hook / ctx.permission.hook
+ * The transitional SDK types used here expose these domains:
+ *   ctx.agent / ctx.command / ctx.model / ctx.reference / ctx.skill /
+ *   ctx.tool / ctx.event / ctx.permission / ctx.session
  *
- * When a V2 API domain is unavailable, the feature is gracefully skipped
- * and documented in V2_UNSUPPORTED_FEATURES. The plugin never breaks.
+ * A separate OpenCode 2.0.18 host runtime probe confirmed ctx.integration and
+ * ctx.skill have callable `.transform` methods; only ctx.catalog was absent.
+ * The probe's callback effects were
+ * not observed for any domain. This runtime probe is not an SDK compatibility
+ * claim. Pantheon's Phase 1/config transform
+ * registrations cover agent, command, and reference; `ctx.tool.transform` is
+ * attempted separately in Phase 2. Integration and skill transform callbacks
+ * are not registered by Pantheon, so their effects remain unproven. The
+ * narrower `SkillEditor.source()` helper is absent from the inspected SDK
+ * editor shape, so directory-source registration remains unsupported; that
+ * does not imply that `ctx.skill` or its transform is absent.
+ *
+ * V2_UNSUPPORTED_FEATURES distinguishes adapter limitations from observed
+ * host-absent APIs; setup handles optional registrations on a best-effort basis.
  *
  * @module plugin-v2
  */
 
+import { appendFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 import type {
   AgentDraft,
-  CatalogDraft,
   CommandDraft,
   PluginContext,
   ReferenceDraft,
-  SkillDraft,
 } from '@opencode-ai/plugin/v2/promise'
 import { define } from '@opencode-ai/plugin/v2/promise'
 import {
@@ -36,34 +47,53 @@ import {
 // ─── Unsupported Features Registry ───────────────────────────────────────
 
 /**
- * Features not yet supported by the installed V2 plugin API.
- * Updated dynamically at setup time based on actual API availability.
- * Initialized with features known to be absent from the V2 promise API;
- * additional features are appended during setup if their API is missing.
+ * Features not implemented by the current Pantheon V2 adapter or absent from
+ * the observed host. A listed feature is not necessarily a host-absent API.
+ * Additional features are appended during setup when a required API is missing.
  */
-export const V2_UNSUPPORTED_FEATURES: string[] = ['legacy-hooks']
+export const V2_UNSUPPORTED_FEATURES: string[] = [
+  'legacy-hooks',
+  // `catalog` alone was absent in the OpenCode 2.0.18 runtime probe.
+  'catalog-transform',
+  // The host exposes callable transforms for integration and skill, but
+  // Pantheon does not register/use them and no host callback effects were
+  // observed. These entries describe adapter support, not host availability.
+  'integration-transform',
+  // The inspected SkillEditor shape has no `source()` helper for adding a
+  // directory source. This is narrower than (and distinct from) ctx.skill's
+  // host availability or callable transform.
+  'skill-transform',
+]
 
 // ─── Constants ───────────────────────────────────────────────────────────
 
 const POLICY_MARKER = '<!-- pantheon-v2-policy -->'
 const POLICY = `${POLICY_MARKER}\nFollow Pantheon routing policy: delegate implementation work to the named specialist and do not claim work was performed without verification.`
 
+/** 2.0.16 `system` on a session hook payload is `Array<SystemPart>`. */
+interface SystemPart {
+  type: 'text'
+  text: string
+}
+
+function isTextPart(entry: unknown): entry is SystemPart {
+  return (
+    typeof entry === 'object' &&
+    entry !== null &&
+    typeof (entry as { text?: unknown }).text === 'string'
+  )
+}
+
 /**
- * SystemPart shape sniffing (beta 19192 `Schema validation failed` in
- * system[N]): host sends SystemPart objects ({type,text}) but pinned SDK
- * (@opencode-ai/plugin 1.18.18) only knows string/string[]. Detect at runtime.
- * Never throws (fail-open).
+ * Extract text from a `system` entry. The host's own coercion accepts a bare
+ * string, but the canonical 2.0.16 shape is `{ type: 'text', text }`; the
+ * string branch is retained so the handler still works against a host that
+ * sends primitives. Never throws.
  */
 function systemEntryText(entry: unknown): string | null {
   try {
     if (typeof entry === 'string') return entry
-    if (
-      typeof entry === 'object' &&
-      entry !== null &&
-      typeof (entry as { text?: unknown }).text === 'string'
-    ) {
-      return (entry as { text: string }).text
-    }
+    if (isTextPart(entry)) return entry.text
     return null
   } catch {
     return null
@@ -81,19 +111,30 @@ function hasPolicyMarker(arr: unknown[]): boolean {
   }
 }
 
-function usesObjectShape(arr: unknown[]): boolean {
-  try {
-    return arr.some(
-      (s) =>
-        typeof s === 'object' && s !== null && typeof (s as { text?: unknown }).text === 'string',
-    )
-  } catch {
-    return false
+/**
+ * Normalize a `system` value to the 2.0.16 `Array<SystemPart>` shape.
+ *
+ * `SessionContext.system` is `Array<SystemPart>` where a part is
+ * `{ type: 'text', text }`. A raw string (the whole value, or an element) is
+ * not that shape, so it is upgraded: element strings become parts, and a bare
+ * string value becomes a one-element part array. Non-array, non-string values
+ * are returned unchanged.
+ *
+ * Returns the normalized array, or `null` when `system` is neither a string
+ * nor an array (nothing to normalize).
+ */
+function normalizeSystemToParts(system: unknown): unknown[] | null {
+  if (typeof system === 'string') {
+    return [{ type: 'text', text: system } satisfies SystemPart]
   }
-}
-
-function toSystemEntry(text: string, useObject: boolean): string | { type: 'text'; text: string } {
-  return useObject ? { type: 'text', text } : text
+  if (!Array.isArray(system)) return null
+  for (let i = 0; i < system.length; i++) {
+    const entry = system[i]
+    if (typeof entry === 'string') {
+      system[i] = { type: 'text', text: entry } satisfies SystemPart
+    }
+  }
+  return system
 }
 
 /**
@@ -191,16 +232,6 @@ function transformAgents(draft: AgentDraft): void {
   }
 }
 
-function transformCatalog(draft: CatalogDraft, options: PluginContext['options']): void {
-  const configured = options.default_model
-  if (typeof configured !== 'string') return
-  const separator = configured.indexOf('/')
-  if (separator <= 0 || separator === configured.length - 1) return
-  const providerID = configured.slice(0, separator)
-  const modelID = configured.slice(separator + 1)
-  if (draft.model.get(providerID, modelID)) draft.model.default.set(providerID, modelID)
-}
-
 function transformCommands(draft: CommandDraft): void {
   // Beta 19192 guard (issue #92): draft may not have `list`, or list()
   // may return a non-iterable. Never throw — mark unsupported and return.
@@ -237,41 +268,6 @@ function transformCommands(draft: CommandDraft): void {
   }
 }
 
-function transformSkills(draft: SkillDraft): void {
-  // Beta 19192 guard (issue #92): draft may not have `list`, or list()
-  // may return a non-iterable. Never throw — mark unsupported and return.
-  let sources: Array<{ type: string; path: string }>
-  try {
-    const maybeList = (draft as unknown as { list?: unknown }).list
-    if (typeof maybeList !== 'function') {
-      markUnsupported('skill-transform-list')
-      return
-    }
-    const result = (maybeList as (this: unknown) => unknown).call(draft)
-    if (
-      result == null ||
-      typeof (result as { [Symbol.iterator]?: unknown })[Symbol.iterator] !== 'function'
-    ) {
-      markUnsupported('skill-transform-list')
-      return
-    }
-    sources = Array.isArray(result)
-      ? (result as Array<{ type: string; path: string }>)
-      : Array.from(result as Iterable<{ type: string; path: string }>)
-  } catch {
-    markUnsupported('skill-transform-list')
-    return
-  }
-  try {
-    const path = fileURLToPath(new URL('./skills', import.meta.url))
-    if (!sources.some((source) => source.type === 'directory' && source.path === path)) {
-      draft.source({ type: 'directory', path })
-    }
-  } catch {
-    markUnsupported('skill-transform')
-  }
-}
-
 function transformReferences(draft: ReferenceDraft): void {
   draft.add('pantheon-agents', {
     type: 'local',
@@ -453,21 +449,32 @@ async function registerV2SessionHooks(context: PluginContext): Promise<boolean>
     // "context" hook — inject routing policy + compaction state
     await sessionCtx.hook('context', (event: unknown) => {
       try {
-        // Beta 19192 hardening + SystemPart sniffing: host may send string[],
-        // SystemPart objects ({type,text}), mixed arrays, a single string, or
-        // a non-array system. Preserve string-path behavior; inject object
-        // shape when the array contains objects (else `Schema validation
-        // failed` in system[N]). Never throw to the host (fail-open).
-        const ctx = event as { system?: unknown } | null | undefined
-        const rawSystem: unknown = ctx?.system
-        if (typeof rawSystem === 'string' && ctx != null) {
-          ctx.system = rawSystem.includes(POLICY_MARKER) ? [rawSystem] : [rawSystem, POLICY]
-        } else if (Array.isArray(rawSystem)) {
-          if (!hasPolicyMarker(rawSystem)) {
-            rawSystem.push(toSystemEntry(POLICY, usesObjectShape(rawSystem)))
+        // Opt-in lifetime proof for the host-backed hook canary (MODE=real).
+        // Inert unless PANTHEON_HOOK_CANARY_LIFETIME_PROOF is set.
+        if (process.env.PANTHEON_HOOK_CANARY_LIFETIME_PROOF) {
+          try {
+            appendFileSync(
+              process.env.PANTHEON_HOOK_CANARY_LIFETIME_PROOF,
+              'plugin-v2:session.hook:context\n',
+            )
+          } catch {
+            // Best-effort instrumentation.
           }
         }
-        // Non-string, non-array system (or null event): ignore silently.
+        // 2.0.16 payload is `{ system: Array<SystemPart> }`. Normalize any
+        // string entries to `{ type: 'text', text }` parts and append the
+        // policy as a part. Junk entries are ignored; a non-array,
+        // non-string system is left untouched. Never throws (fail-open).
+        const ctx = event as { system?: unknown } | null | undefined
+        if (ctx == null) return
+        const normalized = normalizeSystemToParts(ctx.system)
+        if (normalized == null) return
+        // A bare string is replaced by its part array; an array is mutated in
+        // place (the host may read the original reference).
+        if (typeof ctx.system === 'string') ctx.system = normalized
+        if (!hasPolicyMarker(normalized)) {
+          normalized.push({ type: 'text', text: POLICY } satisfies SystemPart)
+        }
       } catch {
         // Fail-open: never throw to the host.
       }
@@ -699,17 +706,19 @@ export const plugin = define({
 
   async setup(context: PluginContext): Promise<void> {
     // ─── Phase 1: V2 Transforms (isolated per-domain, best-effort) ────
-    // Each domain registers independently: a failure in one transform
-    // (e.g. draft.list missing on beta 19192 → TypeError) must never
-    // reject setup() nor prevent the other domains from registering.
+    // Each transform registration is individually wrapped and settled via Promise.allSettled:
+    // a rejection marks only that transform unsupported
+    // and does not reject setup() or prevent later hook registrations.
     // See issue #92.
+    //
+    // Pantheon's Phase 1/config transform registrations cover agent, command,
+    // and reference; ctx.tool.transform is attempted separately in Phase 2.
+    // The 2.0.18 runtime probe found ctx.integration and ctx.skill with
+    // callable transforms, but no callback effects were observed; neither is
+    // registered here. Only ctx.catalog was absent in that probe.
+    // The hook canary tests hook firing only, not transform callback effects.
     const phase1Transforms: Array<{ feature: string; register: () => Promise<unknown> }> = [
       { feature: 'agent-transform', register: () => context.agent.transform(transformAgents) },
-      {
-        feature: 'catalog-transform',
-        register: () =>
-          context.catalog.transform((draft) => transformCatalog(draft, context.options)),
-      },
       {
         feature: 'command-transform',
         register: () => context.command.transform(transformCommands),
@@ -718,7 +727,6 @@ export const plugin = define({
         feature: 'reference-transform',
         register: () => context.reference.transform(transformReferences),
       },
-      { feature: 'skill-transform', register: () => context.skill.transform(transformSkills) },
     ]
     const phase1Results = await Promise.allSettled(
       phase1Transforms.map((t) => Promise.resolve().then(() => t.register())),
@@ -771,9 +779,31 @@ export const plugin = define({
       | undefined
     if (compactionCtx?.hook) {
       try {
-        await compactionCtx.hook('compacting', (_event: unknown) => {
+        // 2.0.16 `SessionHooks` key is `compaction` (the migration doc maps
+        // `experimental.session.compacting` → `ctx.session.hook("compaction")`).
+        // `compacting` is not a valid key: the registry accepts any string and
+        // silently drops unknown names, so the old name was a permanent no-op.
+        // Proven by the canary's negative control.
+        await compactionCtx.hook('compaction', (_event: unknown) => {
           // Compaction context build — injects active goals, pending todos,
           // and in-flight delegations. Wired through V1 infrastructure.
+          //
+          // Opt-in lifetime proof for the host-backed hook canary
+          // (tests/pantheon/plugin-v2-hook-canary.test.mjs, MODE=real). It is
+          // inert unless PANTHEON_HOOK_CANARY_LIFETIME_PROOF is set, so
+          // production behaviour is unchanged. This exists because a rename to
+          // `compacting` was a silent no-op for an unknown length of time: the
+          // canary can now observe that THIS registration fired.
+          if (process.env.PANTHEON_HOOK_CANARY_LIFETIME_PROOF) {
+            try {
+              appendFileSync(
+                process.env.PANTHEON_HOOK_CANARY_LIFETIME_PROOF,
+                'plugin-v2:session.hook:compaction\n',
+              )
+            } catch {
+              // Proof is best-effort: never let instrumentation break the host.
+            }
+          }
         })
       } catch {
         markUnsupported('compaction-hook')

package/src/plugins/tui/dist/tui.js

@@ -165,7 +165,7 @@ async function detectVersion(api) {
 			if (ver) return ver;
 		}
 	} catch {}
-	return "1.5.1";
+	return "1.6.0-beta.1";
 }
 /**
 * usage-bar — AI subscription usage gauge for the opencode TUI.

package/src/plugins/tui/package-lock.json

@@ -1,32 +1,32 @@
 {
   "name": "pantheon-tui",
-  "version": "1.5.1",
+  "version": "1.6.0-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pantheon-tui",
-      "version": "1.5.1",
+      "version": "1.6.0-beta.1",
       "license": "MIT",
       "dependencies": {
-        "@opencode-ai/plugin": ">=1.14.0",
-        "@opentui/core": ">=0.5.10",
-        "@opentui/solid": ">=0.5.10",
-        "solid-js": ">=1.9.12"
+        "@opencode-ai/plugin": "1.18.30",
+        "@opentui/core": "0.5.10",
+        "@opentui/solid": "0.5.10",
+        "solid-js": "1.9.12"
       },
       "devDependencies": {
-        "rolldown-plugin-solid": "^0.2.1",
-        "tsdown": "^0.22.14"
+        "rolldown-plugin-solid": "0.2.1",
+        "tsdown": "0.22.14"
       },
       "engines": {
         "node": "^22.22.2 || ^24.15.0 || >=26.0.0"
       },
       "peerDependencies": {
-        "@opencode-ai/plugin": ">=1.14.0",
-        "@opencode-ai/sdk": ">=1.14.0",
-        "@opentui/core": ">=0.5.10",
-        "@opentui/solid": ">=0.5.10",
-        "solid-js": ">=1.9.12"
+        "@opencode-ai/plugin": "1.18.30",
+        "@opencode-ai/sdk": "1.18.30",
+        "@opentui/core": "0.5.10",
+        "@opentui/solid": "0.5.10",
+        "solid-js": "1.9.12"
       }
     },
     "node_modules/@ai-sdk/provider": {
@@ -626,13 +626,13 @@
       }
     },
     "node_modules/@opencode-ai/plugin": {
-      "version": "1.18.7",
-      "resolved": "https://registry.npmjs.org/@opencode-ai/plugin/-/plugin-1.18.7.tgz",
-      "integrity": "sha512-kXm5hqur5JiF/xJPaQYkuNn7vSl4ya09YgL/pIvIrggWCLFsfo1gXqNbONRcGW7m5Ih2k6kgMXFyjB9or1+dEg==",
+      "version": "1.18.30",
+      "resolved": "https://registry.npmjs.org/@opencode-ai/plugin/-/plugin-1.18.30.tgz",
+      "integrity": "sha512-bXWcA2VD478PXXke1qAYANTq58fCcbgY0GAUqZIFZqPpo48FoG8RH37nNZ78eHtz+ddiKIhFTBZJRaHF3IgFqw==",
       "license": "MIT",
       "dependencies": {
         "@ai-sdk/provider": "3.0.8",
-        "@opencode-ai/sdk": "1.18.7",
+        "@opencode-ai/sdk": "1.18.30",
         "effect": "4.0.0-beta.83",
         "zod": "4.1.8"
       },
@@ -654,9 +654,9 @@
       }
     },
     "node_modules/@opencode-ai/sdk": {
-      "version": "1.18.7",
-      "resolved": "https://registry.npmjs.org/@opencode-ai/sdk/-/sdk-1.18.7.tgz",
-      "integrity": "sha512-5txVELvCxzC3O/MYnRKdTvBN3TqQjE3PaEks3kDRA/moWzMSUhdm15xCth/Mz/NPYyGTn2u4IdScdV9vLTfLRg==",
+      "version": "1.18.30",
+      "resolved": "https://registry.npmjs.org/@opencode-ai/sdk/-/sdk-1.18.30.tgz",
+      "integrity": "sha512-uviJ+PZLc/D1szt33WGzzt/rqJ+IaNmRGBb+UcOXrcQANl8XXKJrp4CNQQ2UAnUJ3Ek+VqcamIwjtKHUW/OjOQ==",
       "license": "MIT",
       "dependencies": {
         "cross-spawn": "7.0.6"

package/src/plugins/tui/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pantheon-tui",
   "type": "module",
-  "version": "1.5.1",
+  "version": "1.6.0-beta.1",
   "description": "Pantheon TUI plugin — sidebar (version, preset, sessions, real-time delegations) + AI subscription usage gauges incl. OpenCode Go/Zen dollar limits (vendored, MIT)",
   "license": "MIT",
   "engines": {
@@ -20,20 +20,20 @@
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@opencode-ai/plugin": ">=1.14.0",
-    "@opencode-ai/sdk": ">=1.14.0",
-    "@opentui/core": ">=0.5.10",
-    "@opentui/solid": ">=0.5.10",
-    "solid-js": ">=1.9.12"
+    "@opencode-ai/plugin": "1.18.30",
+    "@opencode-ai/sdk": "1.18.30",
+    "@opentui/core": "0.5.10",
+    "@opentui/solid": "0.5.10",
+    "solid-js": "1.9.12"
   },
   "devDependencies": {
-    "rolldown-plugin-solid": "^0.2.1",
-    "tsdown": "^0.22.14"
+    "rolldown-plugin-solid": "0.2.1",
+    "tsdown": "0.22.14"
   },
   "dependencies": {
-    "@opencode-ai/plugin": ">=1.14.0",
-    "@opentui/core": ">=0.5.10",
-    "@opentui/solid": ">=0.5.10",
-    "solid-js": ">=1.9.12"
+    "@opencode-ai/plugin": "1.18.30",
+    "@opentui/core": "0.5.10",
+    "@opentui/solid": "0.5.10",
+    "solid-js": "1.9.12"
   }
 }

package/src/routing.yml

@@ -134,7 +134,6 @@ agents:
     - artifact-management
     - context-compression
     - auto-continue
-    - orchestration-workflow
     - incremental-implementation
   athena:
     role: Strategic planner

package/src/skills/README.md

@@ -4,7 +4,7 @@
 
 Skills are reference modules loaded on demand by agents. Each skill provides domain-specific knowledge — architecture patterns, security checklists, optimization strategies, and implementation guides. Agents load skills when their task matches the skill's description, keeping context focused and token-efficient.
 
-There are **21 skills** divided into **5 domains**.
+There are **20 skills** divided into **5 domains**.
 
 ## Skills by Domain
 
@@ -30,75 +30,71 @@ There are **21 skills** divided into **5 domains**.
    - Memory bank rules, structure, and optimization — complete guide to Pantheon memory management.
    - Used by: Mnemosyne, Athena
 
-6. **orchestration-workflow** — `orchestration-workflow/SKILL.md`
-   - Practical step-by-step walkthrough for orchestrating features end-to-end using the multi-agent system, from planning through deployment.
-   - Used by: Zeus
-
-7. **session-goal** — `session-goal/SKILL.md`
+6. **session-goal** — `session-goal/SKILL.md`
    - Pin session objectives to prevent scope creep across long multi-agent sessions.
    - Used by: Zeus, Mnemosyne
 
 ### Domain 2: Development Tools
 
-8. **clonedeps** — `clonedeps/SKILL.md`
+7. **clonedeps** — `clonedeps/SKILL.md`
    - Clones dependency source locally so agents can inspect library internals, understand behavior, and debug integration issues.
    - Used by: Hermes, Hephaestus
 
-9. **git-workflow-and-versioning** — `git-workflow-and-versioning/SKILL.md`
+8. **git-workflow-and-versioning** — `git-workflow-and-versioning/SKILL.md`
    - Atomic commits, conventional commits, trunk-based development workflow.
    - Used by: Hermes, Prometheus, Iris
 
-10. **incremental-implementation** — `incremental-implementation/SKILL.md`
+9. **incremental-implementation** — `incremental-implementation/SKILL.md`
     - Implement in thin vertical slices — one commit per task, testable, rollback-safe.
     - Used by: Zeus, Hermes, Aphrodite, Demeter, Prometheus, Talos
 
-11. **loop-engineering** — `loop-engineering/SKILL.md`
+10. **loop-engineering** — `loop-engineering/SKILL.md`
     - Iterative refinement pattern for complex problems — solve, review, improve, repeat in controlled cycles.
     - Used by: All agents
 
-12. **reflect** — `reflect/SKILL.md`
+11. **reflect** — `reflect/SKILL.md`
     - Turns repeated workflow friction into reusable skills, agents, or configuration improvements.
     - Used by: All agents
 
-13. **simplify** — `simplify/SKILL.md`
+12. **simplify** — `simplify/SKILL.md`
     - Behavior-preserving code simplification for readability, maintainability, and reduced complexity.
     - Used by: All agents
 
-14. **worktrees** — `worktrees/SKILL.md`
+13. **worktrees** — `worktrees/SKILL.md`
     - Git worktrees as safe, isolated coding lanes for risky or parallel work without affecting the main workspace.
     - Used by: All agents
 
 ### Domain 3: Quality & Security
 
-15. **code-review-checklist** — `code-review-checklist/SKILL.md`
+14. **code-review-checklist** — `code-review-checklist/SKILL.md`
     - Systematic code review with quality gates, security audit, and parallel checks for structured feedback.
     - Used by: Themis
 
-16. **security-hardening** — `security-hardening/SKILL.md`
+15. **security-hardening** — `security-hardening/SKILL.md`
     - Security gate — OWASP, SAST, secrets detection, MCP hardening, dependency audit.
     - Used by: Themis, Nyx
 
-17. **tdd-with-agents** — `tdd-with-agents/SKILL.md`
+16. **tdd-with-agents** — `tdd-with-agents/SKILL.md`
     - TDD enforcement with RED→GREEN→REFACTOR cycle and advanced testing patterns across all layers.
     - Used by: Hermes, Aphrodite, Demeter, Themis, Hephaestus
 
 ### Domain 4: Planning
 
-18. **codemap** — `codemap/SKILL.md`
+17. **codemap** — `codemap/SKILL.md`
     - Generates hierarchical repository maps so agents understand codebase structure without re-reading every file.
     - Used by: Apollo, Zeus
 
-19. **spec-driven-development** — `spec-driven-development/SKILL.md`
+18. **spec-driven-development** — `spec-driven-development/SKILL.md`
     - Define requirements via spec-first before any code — PRD, edge cases, acceptance criteria.
     - Used by: Athena
 
-20. **verification-planning** — `verification-planning/SKILL.md`
+19. **verification-planning** — `verification-planning/SKILL.md`
     - Plans an evidence path before non-trivial changes, ensuring changes are testable and verifiable.
     - Used by: Athena, Zeus
 
 ### Domain 5: Frontend Development
 
-21. **visual-review-pipeline** — `visual-review-pipeline/SKILL.md`
+20. **visual-review-pipeline** — `visual-review-pipeline/SKILL.md`
     - Automated visual review pipeline — Playwright screenshots, self-analysis, fix loop, escalation.
     - Used by: Aphrodite
 
@@ -130,22 +126,21 @@ The `SKILL.md` file contains YAML frontmatter with `name`, `description`, and pl
 | 3 | auto-continue | Orchestration & Workflow | Zeus, Apollo, Hephaestus, Nyx, Gaia |
 | 4 | context-compression | Orchestration & Workflow | Zeus, Mnemosyne, Themis |
 | 5 | memory-bank | Orchestration & Workflow | Mnemosyne, Athena |
-| 6 | orchestration-workflow | Orchestration & Workflow | Zeus |
-| 7 | session-goal | Orchestration & Workflow | Zeus, Mnemosyne |
-| 8 | clonedeps | Development Tools | Hermes, Hephaestus |
-| 9 | git-workflow-and-versioning | Development Tools | Hermes, Prometheus, Iris |
-| 10 | incremental-implementation | Development Tools | Zeus, Hermes, Aphrodite, Demeter, Prometheus, Talos |
-| 11 | loop-engineering | Development Tools | All agents |
-| 12 | reflect | Development Tools | All agents |
-| 13 | simplify | Development Tools | All agents |
-| 14 | worktrees | Development Tools | All agents |
-| 15 | code-review-checklist | Quality & Security | Themis |
-| 16 | security-hardening | Quality & Security | Themis, Nyx |
-| 17 | tdd-with-agents | Quality & Security | Hermes, Aphrodite, Demeter, Themis, Hephaestus |
-| 18 | codemap | Planning | Apollo, Zeus |
-| 19 | spec-driven-development | Planning | Athena |
-| 20 | verification-planning | Planning | Athena, Zeus |
-| 21 | visual-review-pipeline | Frontend Development | Aphrodite |
+| 6 | session-goal | Orchestration & Workflow | Zeus, Mnemosyne |
+| 7 | clonedeps | Development Tools | Hermes, Hephaestus |
+| 8 | git-workflow-and-versioning | Development Tools | Hermes, Prometheus, Iris |
+| 9 | incremental-implementation | Development Tools | Zeus, Hermes, Aphrodite, Demeter, Prometheus, Talos |
+| 10 | loop-engineering | Development Tools | All agents |
+| 11 | reflect | Development Tools | All agents |
+| 12 | simplify | Development Tools | All agents |
+| 13 | worktrees | Development Tools | All agents |
+| 14 | code-review-checklist | Quality & Security | Themis |
+| 15 | security-hardening | Quality & Security | Themis, Nyx |
+| 16 | tdd-with-agents | Quality & Security | Hermes, Aphrodite, Demeter, Themis, Hephaestus |
+| 17 | codemap | Planning | Apollo, Zeus |
+| 18 | spec-driven-development | Planning | Athena |
+| 19 | verification-planning | Planning | Athena, Zeus |
+| 20 | visual-review-pipeline | Frontend Development | Aphrodite |
 
 ---