@casomoltd/tooling 0.26.2 → 0.27.0

package/README.md

@@ -388,6 +388,26 @@ duplicated coverage, and missing back-links. It judges structure and
 cross-reference coherence against `docs-style` — not mechanical broken links
 (that's a markdown link linter) or prose voice (a content reviewer).
 
+**`casomoltd:doc-review`** reviews *one repository doc* against `docs-style`:
+whether it gets to the point or buries it under furniture, whether it is one
+subject or three, whether a leaf carries an index belonging in the README,
+whether a section says "not built yet" where content should be, and whether the
+session's own progress has leaked in. A doc can be right in every sentence and
+fail this review, because what it judges is shape. Not link validity (a markdown
+link linter), not the corpus reference graph (`docs-xray`), not skills or agent
+briefs (`skill-review`).
+
+**`casomoltd:skill-review`** reviews changed *skills and agent briefs* against
+`docs-style` and [the authoring schema](docs/skill-agent-schema.md): prose that
+narrates its own past rather than stating current truth, a unit missing the
+sections its profile needs, a rule restated from the skill that owns it, and a
+description that won't route. It closes with an explicit history sweep — the
+units it read and the count flagged, including zero — because that finding sits
+where a justification would and otherwise survives an ordinary read-through. The
+[`commit`](skills/commit/SKILL.md) skill routes staged `SKILL.md` and
+`agents/*.md` changes to it. Not link validity (a markdown link linter), not the
+corpus reference graph (`docs-xray`), not prose voice (a content reviewer).
+
 **Report output & `SCRATCH_DIR`.** `design-xray` and `docs-xray` persist their
 report — the `.md` plus an `.html` rendered by `bin/render-report.mjs` — so it
 outlives the run and opens in a browser. Each writes to a gitignored

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@casomoltd/tooling",
-  "version": "0.26.2",
+  "version": "0.27.0",
   "description": "Casomo's shared dev config: ESLint, Prettier, commitlint, knip & jscpd presets and dev CLIs (git hooks, readability, screenshots)",
   "license": "MIT",
   "repository": {