@cleocode/skills 2026.5.112 → 2026.5.114

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/skills",
-  "version": "2026.5.112",
+  "version": "2026.5.114",
   "description": "CLEO skill definitions - bundled with CLEO monorepo",
   "main": "index.js",
   "types": "index.d.ts",

package/skills/ct-adr-recorder/SKILL.md

@@ -115,7 +115,26 @@ cleo docs add T4798 docs/adr/ADR-0042.md \
   `spec | adr | research | handoff | note | llm-readme`.
 - `--slug` MUST follow `adr-<NNNN>-<short-topic>`. The numeric segment
   is the canonical ADR id; the topic segment makes the slug human
-  readable. Collisions return `E_SLUG_TAKEN` with 3 alternatives.
+  readable. Collisions return `E_SLUG_RESERVED` with 3 alternatives
+  (legacy `E_SLUG_TAKEN` aliased under `details.aliases` for one release —
+  T10386).
+- Near-duplicate slugs trigger `W_SLUG_SIMILAR` (T10361). The CLI
+  surfaces the top match and hints `--allow-similar`. Use `--allow-similar`
+  only when the new ADR genuinely forks from the existing one (e.g.
+  versioned re-issue); every bypass is audited to
+  `.cleo/audit/similar-bypass.jsonl`.
+- Unknown flags fail fast with `E_UNKNOWN_FLAG` + did-you-mean
+  suggestions (T10359) — `--lbls` becomes "did you mean --labels?".
+- TODO(T10360 · E3.2 pending): when shipped, ADR drafts will accept
+  `--title "<human title>"` and CLEO will auto-allocate the next
+  `adr-NNN-<kebab-title>` via the E1 slug allocator. Until then,
+  you MUST hand-pick the next free `NNNN` by inspecting
+  `cleo docs list --type adr --project`. Example future call:
+  ```bash
+  # FUTURE — DO NOT USE until T10360 ships:
+  # cleo docs add T4798 docs/drafts/draft.md --type adr \
+  #   --title "Adopt Drizzle ORM v1 beta"
+  ```
 - The owner ID is the consensus task whose verdict drives the ADR
   (`T4798` above). This is how downstream supersession cascades find
   the chain — never attach an ADR to an arbitrary task.

package/skills/ct-docs-write/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ct-docs-write
 description: This skill should be used when creating, editing, or reviewing documentation files (markdown, MDX, README, guides). Use when the user asks to "write docs", "create documentation", "edit the README", "improve doc clarity", "make docs more readable", "follow the style guide", or "write user-facing content". Applies CLEO's conversational, clear, and user-focused writing style.
-version: 1.1.0
+version: 1.2.0
 tier: 3
 core: false
 category: composition
@@ -193,8 +193,19 @@ cleo docs add T1234 docs/drafts/saml-setup.md \
   For user-facing prose use `note`; for end-user docs use `note` or `spec`
   depending on whether the doc carries REQ-XXX requirements.
 - `--slug` is the human-friendly handle for retrieval. Use kebab-case. If the
-  slug is already taken the CLI returns `E_SLUG_TAKEN` with 3 alternatives —
-  pick one rather than overwriting silently.
+  slug is already taken the CLI returns `E_SLUG_RESERVED` with 3 alternatives
+  (legacy `E_SLUG_TAKEN` aliased under `details.aliases` for one release —
+  T10386) — pick one rather than overwriting silently.
+- If the slug is too close to an existing one the CLI surfaces a
+  `W_SLUG_SIMILAR` warning with the top match + a `--allow-similar` hint
+  (T10361). Pass `--allow-similar` to proceed when the fork is intentional;
+  every bypass is logged to `.cleo/audit/similar-bypass.jsonl`.
+- Unknown flags (typos, removed options) fail fast with `E_UNKNOWN_FLAG`
+  + did-you-mean suggestions (T10359). The legacy "silently absorb as
+  positional" behaviour from citty's `parseArgs` is rejected.
+- TODO(T10360 · E3.2 pending): when shipped, `--type adr` will accept a
+  `--title <human-title>` flag and auto-allocate `adr-NNN-<kebab-title>`
+  via the E1 slug allocator — no more manual ADR-079 numbering.
 - The owner ID (`T1234` above) auto-classifies the attachment by prefix:
   `T###` → task, `ses_*` → session, `O-*` → observation.
 

package/skills/ct-documentor/SKILL.md

@@ -1,11 +1,15 @@
 ---
 name: ct-documentor
 description: Documentation coordinator with CLEO style guide compliance. Routes every canonical-doc write (spec, adr, research, handoff, note, llm-readme) through the docs SSoT via `cleo docs add` / `cleo docs publish` / `cleo docs fetch` — never raw filesystem writes. Coordinates ct-docs-lookup, ct-docs-write, ct-docs-review, ct-spec-writer, and ct-adr-recorder. Use when creating or updating documentation files, consolidating scattered documentation, or validating documentation against style standards. Triggers on documentation tasks, doc update requests, or style guide compliance checks.
-version: 3.6.0
+version: 3.12.0
 tier: 3
 core: false
 category: specialist
 protocol: null
+metadata:
+  version: 3.12.0
+  lastReviewed: 2026-05-24
+  stability: stable
 dependencies:
   - ct-docs-lookup
   - ct-docs-write
@@ -61,7 +65,7 @@ and every owner writes through `cleo docs add` — not raw filesystem writes.
 | Doc Type | Owner Skill | SSoT Command |
 |----------|-------------|--------------|
 | `spec` (REQ-XXX requirements) | `ct-spec-writer` | `cleo docs add <ownerId> <path> --type spec --slug spec-<feature>` |
-| `adr` (architecture decisions) | `ct-adr-recorder` | `cleo docs add <ownerId> <path> --type adr --slug adr-<NNN>-<rest>` |
+| `adr` (architecture decisions) | `ct-adr-recorder` | `cleo docs add <ownerId> <path> --type adr --slug adr-<NNN>-<rest>` (TODO T10360 · E3.2 pending: `--title` + auto-`adr-NNN` allocation) |
 | `research` (multi-source investigation) | `ct-research-agent` | `cleo docs add <ownerId> <path> --type research --slug research-<topic>` |
 | `handoff` (session/agent transition) | `ct-documentor` (this skill) | `cleo docs add <ownerId> <path> --type handoff --slug handoff-<context>` |
 | `note` (conversational prose) | `ct-docs-write` | `cleo docs add <ownerId> <path> --type note --slug <kebab-topic>` |
@@ -293,6 +297,193 @@ the canonical `changeset` DocKind) are allowlisted in the script.
 Per-line opt-out (use sparingly): append
 `// dockind-writer-allowed: <reason>` on the writeFile line.
 
+#### Audit complement — manual-write sweep (T10372)
+
+`scripts/sweep-manual-doc-writes.mjs` (CI job:
+`Manual Write Sweep (T10372)`) is the read-only audit counterpart to
+the writer-uniqueness lint. Where T10369 prevents *new* raw `.md`
+writers from landing in `packages/core/src/**`, this sweep walks every
+`*.md` file *already* added under `.cleo/canon.yml`'s `rawMdPaths`
+directories since the T9791 docs-import cutoff (commit `251814e86`)
+and classifies each one against the docs SSoT:
+
+| Remediation | Meaning | Fix |
+|---|---|---|
+| `in-sync` | File SHA matches a blob already in the SSoT — bytes are tracked. | None. |
+| `drift` | Slug exists in SSoT but the on-disk content has changed. | Re-publish via `cleo docs publish` or re-add as a new version. |
+| `orphan` | Neither SHA nor slug resolves — the file is a raw fs write that bypassed `cleo docs add`. | Migrate via `cleo docs add <ownerId> <file> --type <kind> --slug <slug>`. |
+| `deleted` | File was added since the cutoff but no longer exists on disk. | Informational only — does not count toward `unresolved`. |
+
+Each run writes a timestamped report to
+`audit/manual-write-sweep-<date>.json` and prints the summary block to
+stdout. The CI job uploads the report as a workflow artefact on every
+run and is wired with `continue-on-error: true` initially so the
+existing orphan corpus does not break PRs. Saga T10288 / Epic T10293
+E5.3 closes the orphan migration; the gate flips strict after that
+lands.
+
+```bash
+# Local invocation — uses the globally-installed `cleo` on PATH.
+node scripts/sweep-manual-doc-writes.mjs
+
+# CI / monorepo build — point at the just-built local CLI bundle.
+node scripts/sweep-manual-doc-writes.mjs \
+  --cleo-bin "node packages/cleo/dist/cli/index.js" \
+  --allow-unresolved
+```
+
+Exit codes: `0` (clean OR `--allow-unresolved`), `1` (at least one
+`orphan` or `drift` entry), `2` (canon.yml parse failure, git not
+available, SSoT query failed).
+
+### T10179 + T10203 manual-write migration (T10371)
+
+Saga T10176's two known raw-write workarounds are normalised:
+
+| Original file | SSoT slug | Type | Notes |
+|---|---|---|---|
+| `docs/research/t10179-executor-probe-result.md` | `t10179-executor-probe` | research | in-sync via earlier T9791 import — verified by SHA. |
+| `.changeset/t10179-executor-probe.md` (consumed v5.108) | `t10179-changeset-archive` | note | bytes preserved verbatim from git `cc48ca10e`; archived because the pnpm/changesets `"@cleocode/cleo": patch` frontmatter does not satisfy the `changeset` DocKind schema. |
+| `.changeset/t10203-napi-step-exports.md` (consumed v5.108) | `t10203-napi-step-exports` | changeset | in-sync via the `cleo changeset add` dual-write at PR-time. |
+
+Round-trip parity is regression-locked by
+`packages/core/src/docs/__tests__/manual-write-migration.test.ts`. The
+test embeds the canonical bytes inline and asserts that
+`createAttachmentStore().put(...) → findBySlug(...)` returns the same
+SHA-256 it started with. Any future migration that silently rewrites or
+recompresses these blobs fails the test.
+
+### Sweep-driven remediation loop (T10373)
+
+T10371 only covers the *known* manual-write set declared in the original
+Saga T10176 disposition. The T10372 sweep surfaces *every* orphan
+remaining under `rawMdPaths` at the moment it runs. T10373 closes the
+loop by consuming the sweep report and migrating each orphan into the
+SSoT using the same `cleo docs add --slug` pattern T10371 established.
+
+The recurring pattern (use this any time the sweep flags fresh
+orphans):
+
+1. Run the sweep: `node scripts/sweep-manual-doc-writes.mjs`. The
+   report lands at `audit/manual-write-sweep-<date>.json`.
+2. For each `orphan` entry, derive the migration tuple:
+   - `--type` from the file's parent directory (`.cleo/adrs/` → `adr`,
+     `.cleo/research/` → `research`, `.cleo/agent-outputs/` →
+     `handoff` or `note` based on content, `.cleo/rcasd/` → `rcasd`).
+   - `--slug` from the filename — lowercase, kebab-case, no
+     extension (e.g. `ADR-085-cross-db-invariants.md` →
+     `adr-085-cross-db-invariants`).
+   - `<owner-id>` from the file's frontmatter `task:` field if
+     present, otherwise from `cleo find "<filename-keyword>"`.
+3. Run `cleo docs add <ownerId> <file> --type <kind> --slug <slug>
+   --desc "<sweep-remediation context>"`. The `--desc` should
+   reference the originating task ID so future operators can trace
+   the migration.
+4. Verify via `cleo docs fetch <slug>` and re-run the sweep — the
+   `orphan` count MUST drop by the number of files migrated.
+5. Add the new (slug, sha256, type, ownerId) row to a
+   round-trip parity test alongside the T10371 set. The canonical
+   example lives at
+   `packages/core/src/docs/__tests__/sweep-remediation.test.ts`.
+
+T10373 migrated five orphans this way: `ADR-083`, `ADR-085`,
+`T10268-saga-closeout`, `t10292-e4-cli-verb-matrix`, and
+`t10292-e4-sdk-import-edges`. The last two were direct fallout from
+the pre-T10389 worktree-unreachable bug — T10353 and T10354 workers
+fell back to raw filesystem writes because `cleo docs add` rejected
+inside their spawned worktrees. Re-publishing the bytes via the SSoT
+proves the round-trip and closes the loop the bug opened.
+
+If a sweep run surfaces a file that should genuinely stay as raw
+markdown (e.g. an audit log not meant for SSoT propagation), add an
+entry to `audit/sweep-exemptions.yml` rather than migrating it. The
+sweep script honours exemptions and does not flag them as orphans.
+
+### Stuck-saga closure via `cleo saga reconcile` (T10374 · Saga T10288 / Epic T10293)
+
+When a Saga's docs-related closeout was completed under the saga's
+member Epics — every Epic flipped to `status='done'` — but the parent
+Saga row itself is still `pending`, the recovery verb is
+`cleo saga reconcile <sagaId>`. This is the cron-safe T10121 path
+that the ADR-076 / T10113 auto-close path delivers; sagas that pre-date
+the auto-close path (T9625 is the canonical example) need an explicit
+nudge.
+
+The recipe — use this any time a docs-canon Saga is observably stuck
+even though its members have all shipped via `cleo docs add` /
+`cleo docs publish`:
+
+1. Verify member-Epic terminality:
+   `for E in <memberIds>; do cleo show $E | jq '.data.task.status'; done`.
+   Every member must be `done`, `cancelled`, or `archived` before
+   reconcile will close the parent. If any member is genuinely stuck,
+   close THAT one first (evidence-based per ADR-051) — do NOT cancel
+   a member just to satisfy the gate.
+2. Verify the SSoT fetch-gate the Saga's acceptance gates on (typically
+   a research plan or closure note):
+   `cleo docs fetch <slug>` — must return `success: true` with the
+   expected bytes.
+3. Reconcile: `cleo saga reconcile <sagaId>`. The verb is idempotent
+   (re-runs return `action: 'no-op'`) and never modifies member rows.
+4. Confirm: `cleo show <sagaId>` — `status` must be `done` and
+   `completedAt` populated. The action is appended to
+   `.cleo/audit/saga-reconcile.jsonl` for audit.
+5. Write a closure-evidence handoff via
+   `cleo docs add <taskId> <file> --type handoff --slug <saga>-closure-evidence`
+   capturing: member statuses (table), reconcile envelope output,
+   sibling-saga sanity check (no cross-saga side effects), and
+   ADR-076 + T10113 path validation. The slug `t9625-closure-evidence`
+   is the canonical reference.
+
+Regression coverage for this path lives at
+`packages/core/src/sagas/__tests__/t9625-closure.test.ts` and locks
+three invariants: stuck-saga closure (AC1), sibling-saga isolation
+(AC2), and idempotency (AC3). Add a new case there whenever you close
+another stuck docs-canon Saga so the recovery pattern stays under
+test.
+
+### Docs->memory auto-emit (T9976 · regression-tested by T10375)
+
+Every successful `cleo docs add` fires a fire-and-forget memory observation
+into `brain_observations`. The CLI never blocks on this write — a BRAIN
+failure cannot fail `docs add` — but the observation is the bridge that
+makes `cleo memory find '<slug>'` surface attached docs.
+
+**Title shape**: `"Doc attached: <slug>"` (or `"Doc attached: <attachmentId>"`
+when no slug is provided). This is what the FTS index matches on, so the
+slug is also a memory-discovery key — not just a docs-lookup key.
+
+**Narrative payload** (the {@link DocAttachmentObservationPayload} contract):
+
+```jsonc
+{
+  "kind": "doc-attachment",        // discriminator
+  "attachmentId": "<id>",          // assigned by the docs store
+  "ownerId": "<T#### | SG-#### | …>",
+  "slug": "<kebab-slug>",          // omitted only when --slug not passed
+  "type": "<docKind>",             // omitted only when --type not passed
+  "addedAt": "<ISO 8601 timestamp>"
+}
+```
+
+The payload is consumed by `cleo memory verify <observationId>` for
+round-trip checks against the docs store — see AC3 of the original T9976
+suite at `packages/cleo/src/dispatch/domains/__tests__/docs-memory-observation.test.ts`.
+
+**Retroactive sweeps**: when migrating manual `Write`-based docs back into
+the SSoT (the T10371 + T10373 pattern), the auto-emit fires uniformly for
+the kebab-case slugs the sweep uses (`t<num>-<kebab>`, `adr-<num>-<kebab>`).
+Regression coverage lives at
+`packages/cleo/src/dispatch/domains/__tests__/docs-memory-observation-retroactive.test.ts`
+(T10375). Add a new case to that table whenever you discover a slug shape
+not yet under test.
+
+**Anti-pattern**: do NOT write a `cleo memory observe` manually after a
+`cleo docs add` — the auto-emit already happened, and the duplicate
+observation pollutes the FTS index. Use `cleo memory backfill-docs` (AC4
+of T9976) only to repair attachments that pre-date the auto-emit feature
+or were written outside the SSoT.
+
 ### Slug similarity warn (T10361 · closes T10167)
 
 `cleo docs add` runs a fuzzy-match check against existing slugs for the

package/skills/ct-spec-writer/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: ct-spec-writer
 description: Technical specification writing using RFC 2119 language for clear, unambiguous requirements. Creates protocol specifications, technical requirements, API specifications, and architecture documents with testable requirements and compliance criteria. Use when writing specifications, defining protocols, documenting requirements, or creating API contracts. Triggers on specification tasks, protocol definition needs, or requirement documentation.
-version: 2.0.0
+version: 2.1.0
 tier: 2
 core: false
 category: recommended
@@ -161,8 +161,17 @@ cleo docs add T1234 docs/specs/auth-protocol.md \
   Other allowed values: `adr | research | handoff | note | llm-readme`.
 - `--slug` is the kebab-case retrieval handle. Use the spec topic +
   version (e.g. `auth-protocol-v2`, `release-pipeline-v3`). The CLI
-  returns `E_SLUG_TAKEN` with 3 alternatives on collision — pick one
-  rather than silently overwriting.
+  returns `E_SLUG_RESERVED` with 3 alternatives on collision (legacy
+  `E_SLUG_TAKEN` aliased under `details.aliases` for one release —
+  T10386) — pick one rather than silently overwriting.
+- Near-duplicate slugs (e.g. `auth-protocol-v2` vs an existing
+  `auth-protocol`) surface a `W_SLUG_SIMILAR` warning with the top
+  match (T10361). Pass `--allow-similar` to proceed when the new spec
+  intentionally forks; every bypass is audited to
+  `.cleo/audit/similar-bypass.jsonl`.
+- Unknown flags fail fast with `E_UNKNOWN_FLAG` + did-you-mean
+  suggestions (T10359) — `--titel`/`--lables` become "did you mean
+  --type/--labels?". Run `cleo docs add --help` for the canonical surface.
 - The owner ID (`T1234`) auto-attaches the spec to its parent task so
   downstream stages (`ct-validator`, decomposition, implementation)
   can discover the spec via `cleo docs list --task T1234 --type spec`.

package/skills.json

@@ -1,20 +1,30 @@
 {
   "version": "2.1.0",
-  "generated": "2026-03-02T05:45:00Z",
+  "generated": "2026-05-24T00:00:00Z",
   "skills": [
     {
       "name": "ct-cleo",
       "description": "CLEO task management protocol - core guidance for session, task, and workflow operations. Provides CLI-based workflow, session protocol, task discovery patterns, RCSD lifecycle overview, error handling, and the Human Render Contract (ADR-077). Load this skill for detailed CLEO protocol guidance.",
       "version": "2.2.0",
       "path": "skills/ct-cleo/SKILL.md",
-      "references": ["skills/ct-cleo/references/session-protocol.md", "skills/ct-cleo/references/loom-lifecycle.md", "skills/ct-cleo/references/anti-patterns.md"],
+      "references": [
+        "skills/ct-cleo/references/session-protocol.md",
+        "skills/ct-cleo/references/loom-lifecycle.md",
+        "skills/ct-cleo/references/anti-patterns.md"
+      ],
       "core": true,
       "category": "core",
       "tier": 0,
       "protocol": null,
       "dependencies": [],
-      "sharedResources": ["task-system-integration"],
-      "compatibility": ["claude-code", "gemini-cli", "codex-cli"],
+      "sharedResources": [
+        "task-system-integration"
+      ],
+      "compatibility": [
+        "claude-code",
+        "gemini-cli",
+        "codex-cli"
+      ],
       "license": "MIT",
       "metadata": {
         "version": "2.2.0",
@@ -27,14 +37,32 @@
       "description": "Pipeline-aware orchestration for multi-agent workflows. Manages RCASD-IVTR+C pipeline progression for epics, delegates all work to subagents via provider-neutral spawning, enforces lifecycle gates before spawning, and reads only manifests. Use when orchestrating complex workflows, delegating to subagents, or managing epic pipeline progression.",
       "version": "4.0.0",
       "path": "skills/ct-orchestrator/SKILL.md",
-      "references": ["skills/ct-orchestrator/references/autonomous-operation.md", "skills/ct-orchestrator/references/lifecycle-gates.md", "skills/ct-orchestrator/references/orchestrator-compliance.md", "skills/ct-orchestrator/references/orchestrator-handoffs.md", "skills/ct-orchestrator/references/orchestrator-patterns.md", "skills/ct-orchestrator/references/orchestrator-recovery.md", "skills/ct-orchestrator/references/orchestrator-spawning.md", "skills/ct-orchestrator/references/orchestrator-tokens.md", "skills/ct-orchestrator/references/SUBAGENT-PROTOCOL-BLOCK.md"],
+      "references": [
+        "skills/ct-orchestrator/references/autonomous-operation.md",
+        "skills/ct-orchestrator/references/lifecycle-gates.md",
+        "skills/ct-orchestrator/references/orchestrator-compliance.md",
+        "skills/ct-orchestrator/references/orchestrator-handoffs.md",
+        "skills/ct-orchestrator/references/orchestrator-patterns.md",
+        "skills/ct-orchestrator/references/orchestrator-recovery.md",
+        "skills/ct-orchestrator/references/orchestrator-spawning.md",
+        "skills/ct-orchestrator/references/orchestrator-tokens.md",
+        "skills/ct-orchestrator/references/SUBAGENT-PROTOCOL-BLOCK.md"
+      ],
       "core": true,
       "category": "core",
       "tier": 0,
       "protocol": "agent-protocol",
       "dependencies": [],
-      "sharedResources": ["subagent-protocol-base", "task-system-integration"],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "sharedResources": [
+        "subagent-protocol-base",
+        "task-system-integration"
+      ],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -49,8 +77,16 @@
       "tier": 0,
       "protocol": "implementation",
       "dependencies": [],
-      "sharedResources": ["subagent-protocol-base", "task-system-integration"],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "sharedResources": [
+        "subagent-protocol-base",
+        "task-system-integration"
+      ],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -59,14 +95,33 @@
       "description": "Epic planning and task decomposition for breaking down large initiatives into atomic, executable tasks. Provides dependency analysis, wave-based parallel execution planning, hierarchy management, and research linking.",
       "version": "3.0.0",
       "path": "skills/ct-epic-architect/SKILL.md",
-      "references": ["skills/ct-epic-architect/references/bug-epic-example.md", "skills/ct-epic-architect/references/commands.md", "skills/ct-epic-architect/references/feature-epic-example.md", "skills/ct-epic-architect/references/migration-epic-example.md", "skills/ct-epic-architect/references/output-format.md", "skills/ct-epic-architect/references/patterns.md", "skills/ct-epic-architect/references/refactor-epic-example.md", "skills/ct-epic-architect/references/research-epic-example.md", "skills/ct-epic-architect/references/shell-escaping.md", "skills/ct-epic-architect/references/skill-aware-execution.md"],
+      "references": [
+        "skills/ct-epic-architect/references/bug-epic-example.md",
+        "skills/ct-epic-architect/references/commands.md",
+        "skills/ct-epic-architect/references/feature-epic-example.md",
+        "skills/ct-epic-architect/references/migration-epic-example.md",
+        "skills/ct-epic-architect/references/output-format.md",
+        "skills/ct-epic-architect/references/patterns.md",
+        "skills/ct-epic-architect/references/refactor-epic-example.md",
+        "skills/ct-epic-architect/references/research-epic-example.md",
+        "skills/ct-epic-architect/references/shell-escaping.md",
+        "skills/ct-epic-architect/references/skill-aware-execution.md"
+      ],
       "core": false,
       "category": "recommended",
       "tier": 1,
       "protocol": "decomposition",
       "dependencies": [],
-      "sharedResources": ["subagent-protocol-base", "task-system-integration"],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "sharedResources": [
+        "subagent-protocol-base",
+        "task-system-integration"
+      ],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -81,15 +136,23 @@
       "tier": 1,
       "protocol": "research",
       "dependencies": [],
-      "sharedResources": ["subagent-protocol-base", "task-system-integration"],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "sharedResources": [
+        "subagent-protocol-base",
+        "task-system-integration"
+      ],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
     {
       "name": "ct-spec-writer",
       "description": "Technical specification writing using RFC 2119 language for clear, unambiguous requirements. Creates protocol specifications, technical requirements, API specifications, and architecture documents with testable requirements and compliance criteria.",
-      "version": "2.0.0",
+      "version": "2.1.0",
       "path": "skills/ct-spec-writer/SKILL.md",
       "references": [],
       "core": false,
@@ -97,8 +160,16 @@
       "tier": 1,
       "protocol": "specification",
       "dependencies": [],
-      "sharedResources": ["subagent-protocol-base", "task-system-integration"],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "sharedResources": [
+        "subagent-protocol-base",
+        "task-system-integration"
+      ],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -113,8 +184,16 @@
       "tier": 1,
       "protocol": "validation",
       "dependencies": [],
-      "sharedResources": ["subagent-protocol-base", "task-system-integration"],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "sharedResources": [
+        "subagent-protocol-base",
+        "task-system-integration"
+      ],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -129,24 +208,44 @@
       "tier": 2,
       "protocol": "contribution",
       "dependencies": [],
-      "sharedResources": ["subagent-protocol-base", "task-system-integration"],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "sharedResources": [
+        "subagent-protocol-base",
+        "task-system-integration"
+      ],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
     {
       "name": "ct-documentor",
       "description": "Documentation creation, editing, and review with CLEO style guide compliance. Coordinates specialized skills for lookup, writing, and review.",
-      "version": "3.4.0",
+      "version": "3.12.0",
       "path": "skills/ct-documentor/SKILL.md",
       "references": [],
       "core": false,
       "category": "specialist",
       "tier": 2,
       "protocol": null,
-      "dependencies": ["ct-docs-lookup", "ct-docs-write", "ct-docs-review"],
-      "sharedResources": ["subagent-protocol-base", "task-system-integration"],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "dependencies": [
+        "ct-docs-lookup",
+        "ct-docs-write",
+        "ct-docs-review"
+      ],
+      "sharedResources": [
+        "subagent-protocol-base",
+        "task-system-integration"
+      ],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -162,14 +261,19 @@
       "protocol": null,
       "dependencies": [],
       "sharedResources": [],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
     {
       "name": "ct-docs-write",
       "description": "Documentation writing with CLEO's conversational, clear, user-focused style. Use when creating, editing, or improving documentation files.",
-      "version": "1.1.0",
+      "version": "1.2.0",
       "path": "skills/ct-docs-write/SKILL.md",
       "references": [],
       "core": false,
@@ -178,7 +282,12 @@
       "protocol": null,
       "dependencies": [],
       "sharedResources": [],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -194,7 +303,12 @@
       "protocol": null,
       "dependencies": [],
       "sharedResources": [],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -209,8 +323,15 @@
       "tier": 2,
       "protocol": "contribution",
       "dependencies": [],
-      "sharedResources": ["subagent-protocol-base"],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "sharedResources": [
+        "subagent-protocol-base"
+      ],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -226,27 +347,59 @@
       "protocol": null,
       "dependencies": [],
       "sharedResources": [],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
     {
       "name": "ct-council",
-      "description": "Convene \"The Council\" — a 5-advisor, shuffled gate-based peer-review, chairman-synthesis workflow for reviewing a plan, decision, architecture, or piece of work inside the current project. Use when the user says \"convene the council\" (or \"counsel\"), \"get the council on this\", \"council review\", \"run the five advisors\", \"stress-test this\", \"get multiple perspectives\", or asks for a rigorous multi-angle challenge of a proposal (Contrarian, First Principles, Expansionist, Outsider, Executor → shuffled peer review with pass/fail gates → convergence detector → Chairman verdict). Operates on the current codebase — each advisor grounds their analysis in actual files/commits before opining. Output is validated by scripts/validate.py.",
+      "description": "Convene \"The Council\" \u2014 a 5-advisor, shuffled gate-based peer-review, chairman-synthesis workflow for reviewing a plan, decision, architecture, or piece of work inside the current project. Use when the user says \"convene the council\" (or \"counsel\"), \"get the council on this\", \"council review\", \"run the five advisors\", \"stress-test this\", \"get multiple perspectives\", or asks for a rigorous multi-angle challenge of a proposal (Contrarian, First Principles, Expansionist, Outsider, Executor \u2192 shuffled peer review with pass/fail gates \u2192 convergence detector \u2192 Chairman verdict). Operates on the current codebase \u2014 each advisor grounds their analysis in actual files/commits before opining. Output is validated by scripts/validate.py.",
       "version": "1.0.0",
       "path": "skills/ct-council/SKILL.md",
-      "references": ["skills/ct-council/references/chairman.md", "skills/ct-council/references/contrarian.md", "skills/ct-council/references/evidence-pack.md", "skills/ct-council/references/examples.md", "skills/ct-council/references/executor.md", "skills/ct-council/references/expansionist.md", "skills/ct-council/references/first-principles.md", "skills/ct-council/references/outsider.md", "skills/ct-council/references/peer-review.md"],
+      "references": [
+        "skills/ct-council/references/chairman.md",
+        "skills/ct-council/references/contrarian.md",
+        "skills/ct-council/references/evidence-pack.md",
+        "skills/ct-council/references/examples.md",
+        "skills/ct-council/references/executor.md",
+        "skills/ct-council/references/expansionist.md",
+        "skills/ct-council/references/first-principles.md",
+        "skills/ct-council/references/outsider.md",
+        "skills/ct-council/references/peer-review.md"
+      ],
       "core": false,
       "category": "specialist",
       "tier": 2,
       "protocol": null,
       "dependencies": [],
       "sharedResources": [],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {
-        "triggers": ["convene the council", "council review", "run the five advisors", "stress-test this", "get multiple perspectives"],
-        "advisors": ["Contrarian", "First Principles", "Expansionist", "Outsider", "Executor"]
+        "triggers": [
+          "convene the council",
+          "council review",
+          "run the five advisors",
+          "stress-test this",
+          "get multiple perspectives"
+        ],
+        "advisors": [
+          "Contrarian",
+          "First Principles",
+          "Expansionist",
+          "Outsider",
+          "Executor"
+        ]
       }
     },
     {
@@ -254,14 +407,22 @@
       "description": "Guide for creating effective skills. Use when creating a new skill or updating an existing skill that extends agent capabilities.",
       "version": "1.0.0",
       "path": "skills/ct-skill-creator/SKILL.md",
-      "references": ["skills/ct-skill-creator/references/output-patterns.md", "skills/ct-skill-creator/references/workflows.md"],
+      "references": [
+        "skills/ct-skill-creator/references/output-patterns.md",
+        "skills/ct-skill-creator/references/workflows.md"
+      ],
       "core": false,
       "category": "meta",
       "tier": 3,
       "protocol": null,
       "dependencies": [],
       "sharedResources": [],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -277,7 +438,12 @@
       "protocol": null,
       "dependencies": [],
       "sharedResources": [],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {}
     },
@@ -286,18 +452,43 @@
       "description": "LOOM (Logical Order of Operations Methodology) - the systematic framework for how CLEO processes project threads through the RCASD-IVTR+C pipeline. LOOM encompasses the full lifecycle methodology that transforms raw ideas into delivered artifacts, from Research through Release with the Contribution protocol (+C) running across all stages. References docs/concepts/CLEO-VISION.md for the complete LOOM framework, neural hierarchy model, and brain metaphor mapping.",
       "version": "1.0.0",
       "path": "docs/concepts/CLEO-VISION.md",
-      "references": [".cleo/adrs/ADR-007-domain-consolidation.md", ".cleo/adrs/ADR-009-BRAIN-cognitive-architecture.md"],
+      "references": [
+        ".cleo/adrs/ADR-007-domain-consolidation.md",
+        ".cleo/adrs/ADR-009-BRAIN-cognitive-architecture.md"
+      ],
       "core": false,
       "category": "core",
       "tier": 0,
       "protocol": null,
       "dependencies": [],
       "sharedResources": [],
-      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "compatibility": [
+        "claude-code",
+        "cursor",
+        "windsurf",
+        "gemini-cli"
+      ],
       "license": "MIT",
       "metadata": {
-        "concepts": ["LOOM", "RCASD-IVTR+C", "lifecycle pipeline", "neural hierarchy", "brain metaphor"],
-        "domains": ["tasks", "session", "memory", "check", "pipeline", "orchestrate", "tools", "admin", "nexus", "sticky"]
+        "concepts": [
+          "LOOM",
+          "RCASD-IVTR+C",
+          "lifecycle pipeline",
+          "neural hierarchy",
+          "brain metaphor"
+        ],
+        "domains": [
+          "tasks",
+          "session",
+          "memory",
+          "check",
+          "pipeline",
+          "orchestrate",
+          "tools",
+          "admin",
+          "nexus",
+          "sticky"
+        ]
       }
     }
   ]