@cleocode/skills 2026.5.110 → 2026.5.112

package/package.json

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

package/skills/ct-documentor/SKILL.md

@@ -1,7 +1,7 @@
 ---
 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.4.0
+version: 3.6.0
 tier: 3
 core: false
 category: specialist
@@ -241,6 +241,58 @@ T10366 establishes the registry contract; T10367 (docs add) and T10368
 allocator — callers should continue invoking the existing writers
 (`cleo docs add` dispatch handler, `writeChangesetEntry`) directly.
 
+**T10367 LIVE — `cleo docs add --type changeset` delegates to
+`writeChangesetEntry`.** The dispatch handler in
+`packages/cleo/src/dispatch/domains/docs.ts` now branches on
+`payload.type === 'changeset'` and routes the call through the
+canonical dual-write transaction. This eliminates the second writer
+for the `changeset` DocKind (the SG-DOCS-INTEGRITY invariant) — the
+bytes that land on `.changeset/<slug>.md` AND the SSoT blob are
+byte-identical regardless of which verb the operator invoked. The
+`cleo changeset add` CLI remains the friendlier authoring surface
+(it prompts for every required frontmatter field) while
+`cleo docs add --type changeset --file <path>` works for agents that
+already have a fully-formed changeset markdown blob in hand.
+
+Contract for the docs-add path:
+- The input file MUST carry valid changeset frontmatter
+  (`id`, `tasks`, `kind`, `summary`). Missing → `E_REQUIRES_CHANGESET_VERB`
+  with a fix hint pointing at `cleo changeset add` for guided authoring.
+- When `--slug` is also passed it MUST match the frontmatter `id`
+  (the frontmatter is canonical) — divergence → `E_SLUG_MISMATCH`.
+- The LAFS envelope on success carries `data.type === 'changeset'`,
+  `data.slug`, `data.attachmentId`, and `data.sha256` — round-trip
+  identical to what `cleo changeset add` emits.
+
+#### CI gate — DocKind Writer Uniqueness (T10369)
+
+`scripts/lint-dockind-writer-uniqueness.mjs` (CI job:
+`DocKind Writer Uniqueness (T10369)`) enforces the
+WriterRegistry invariants at PR-time. It refuses to merge a PR that:
+
+1. Adds a new entry to `BUILTIN_DOC_KINDS` (in
+   `packages/contracts/src/docs-taxonomy.ts`) without a matching
+   descriptor in `writer-registry.ts` (`dockind-coverage-missing`).
+2. Declares more than one descriptor for the same DocKind
+   (`dockind-coverage-collision` — the registry itself throws at module
+   load too, this gate surfaces it earlier in CI).
+3. Has a `mode: 'ssot-first'` descriptor that does NOT match
+   `.cleo/canon.yml`'s `canonicalHome` for the same kind, or vice versa
+   (`canon-yml-ssot-first-drift`).
+4. Adds a NEW raw `writeFileSync(path.md, …)` / `writeFile(path.md, …)`
+   call inside `packages/core/src/**` that is not in
+   `.lint-dockind-writer-baseline.json` (`unregistered-md-write`).
+
+Schema-parity rules (#1-#3) are ALWAYS strict — there is no baseline.
+The unregistered-md-write rule runs in baseline mode by default; count
+decreases always pass, count increases fail. The two legitimate
+non-DocKind `.md` writers (`packages/core/src/sessions/handoff-markdown.ts`
+for session snapshots and `packages/core/src/changesets/writer.ts` for
+the canonical `changeset` DocKind) are allowlisted in the script.
+
+Per-line opt-out (use sparingly): append
+`// dockind-writer-allowed: <reason>` on the writeFile line.
+
 ### Slug similarity warn (T10361 · closes T10167)
 
 `cleo docs add` runs a fuzzy-match check against existing slugs for the