@hecer/yoke 1.5.1 → 1.6.0

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "yoke",
   "displayName": "Yoke",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Cross-agent coding harness: one curated skill canon (TDD, brainstorming, plans, reviews, shipping, design verification) plus mechanical safety gates and an autonomous loop via the yoke CLI.",
   "author": { "name": "HECer", "url": "https://github.com/HECer" },
   "homepage": "https://github.com/HECer/yoke#readme",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "yoke",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Cross-agent coding discipline, mechanical gates, and release workflows",
   "skills": "./canon/skills/",
   "hooks": "./hooks/hooks.json"

package/CHANGELOG.md

@@ -1,24 +1,39 @@
 # Changelog
 
-## Unreleased
-
-## 1.5.1 — 2026-08-17
-
-### Fixed
-- Serena MCP configurations generated by Yoke no longer open the local web dashboard automatically on every startup.
-
-## 1.5.0 — 2026-08-16
+## Unreleased
+
+## 1.6.0 — 2026-08-20
 
 ### Added
-- Failed verify, executable-criterion, performance, configured custom-audit, and completion gates now produce deterministic byte-bounded previews and preserve large complete stdout/stderr in content-addressed `.yoke/artifacts/` files with SHA-256 references.
+- The canon now includes `no-ai-slop`, `domain-modeling`, `codebase-design`, `resolving-merge-conflicts`, and `writing-for-agents`, with their supporting templates and evaluation material. Source adaptations are credited in `canon/skills/ATTRIBUTION.md`.
+- UI projects receive an automatic design-quality gate with configurable `design.mode` (`off`, `auto`, or `on`) and score budget. Detection uses package dependencies, UI source files, and configured smoke flows.
+- Durable context now includes a project glossary and can expose an optional bounded-context map.
+
+### Changed
+- Retrofit installs complete skill packages for Claude, Codex, and Gemini instead of copying only `SKILL.md`. Local resources, binary files, and executable bits are preserved where supported.
+- Every canon skill declares `invocation: auto|manual`; retrofit maps that policy to Claude frontmatter, Codex `agents/openai.yaml`, and Gemini's generated automatic-skill index.
+- Canon validation rejects missing local Markdown resources, unsafe package entries, symlinks, and provider metadata that conflicts with the manifest.
+
+### Fixed
+- Windows provider cleanup now treats a successful `taskkill` as a request and confirms that the recorded PID has stopped before deleting its ownership record.
+
+## 1.5.1 — 2026-08-17
+
+### Fixed
+- Serena MCP configurations generated by Yoke no longer open the local web dashboard automatically on every startup.
+
+## 1.5.0 — 2026-08-16
+
+### Added
+- Failed verify, executable-criterion, performance, configured custom-audit, and completion gates now produce deterministic byte-bounded previews and preserve large complete stdout/stderr in content-addressed `.yoke/artifacts/` files with SHA-256 references.
 - Projects can tune `output.previewBytes` and `output.artifactThresholdBytes`; existing projects use backward-compatible 2 KiB/8 KiB defaults.
 - A deterministic local benchmark verifies signal retention, preview bounds, compression measurement, and artifact digest round-trips without making provider-token claims.
 
-### Security
-- Output artifact paths sanitize story identifiers, stay below a project-local root, use user-only file modes where supported, and are excluded from Yoke's clean-tree and story-commit operations even in upgraded projects. Raw artifacts are never injected automatically and documentation warns that project commands may emit secrets or personal data.
-- Gate command capture is capped at 16 MiB per stdout/stderr stream. Quota overflow fails closed and labels retained evidence as truncated instead of risking unbounded memory or claiming partial output is complete.
-
-## 1.4.0 — 2026-08-15
+### Security
+- Output artifact paths sanitize story identifiers, stay below a project-local root, use user-only file modes where supported, and are excluded from Yoke's clean-tree and story-commit operations even in upgraded projects. Raw artifacts are never injected automatically and documentation warns that project commands may emit secrets or personal data.
+- Gate command capture is capped at 16 MiB per stdout/stderr stream. Quota overflow fails closed and labels retained evidence as truncated instead of risking unbounded memory or claiming partial output is complete.
+
+## 1.4.0 — 2026-08-15
 
 ### Added
 - `yoke loop run --parallel=N` now executes dependency-ready, non-colliding stories through real provider subprocess workers, isolated worktrees, leased claims, and a FIFO integration queue with fresh integrated-system gates.

package/README.md

@@ -2,9 +2,9 @@
 
 # 🐂 Yoke
 
-<!-- yoke:version:start -->1.5.1<!-- yoke:version:end -->
-<!-- yoke:tests:start -->971<!-- yoke:tests:end -->
-<!-- yoke:skills:start -->29<!-- yoke:skills:end -->
+<!-- yoke:version:start -->1.6.0<!-- yoke:version:end -->
+<!-- yoke:tests:start -->1014<!-- yoke:tests:end -->
+<!-- yoke:skills:start -->34<!-- yoke:skills:end -->
 <!-- yoke:agents:start -->Claude | Codex | Gemini<!-- yoke:agents:end -->
 
 ### One harness, three agents — and zero trust in "done."
@@ -17,7 +17,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](#-license)
 ![Node](https://img.shields.io/badge/node-%E2%89%A520-339933?logo=node.js&logoColor=white)
 ![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=white)
-![Tests](https://img.shields.io/badge/tests-971%20passing-brightgreen.svg)
+![Tests](https://img.shields.io/badge/tests-1014%20passing-brightgreen.svg)
 ![Agents](https://img.shields.io/badge/agents-Claude%20%7C%20Codex%20%7C%20Gemini-8A2BE2)
 ![Built with TDD](https://img.shields.io/badge/built%20with-TDD%20%2B%20review-ff69b4.svg)
 
@@ -25,14 +25,14 @@
 
 </div>
 
-> **TL;DR** — `yoke setup .` asks six questions and installs the native harness for your agent. `yoke new my-app --idea="..."` bootstraps a project and drafts its story backlog. `yoke loop run my-app --isolate --review` then implements it behind hard gates: **clean tree → acceptance criteria → your real tests green → an independent model approves → commit**. Add `--parallel=N` for dependency-aware workers, or declare a reference and add `--quality` for a bounded critic/repair gauntlet. If any blocking gate is red, nothing is committed. Proof lives in `.yoke/proof/<story>/`.
-
-Yoke 1.5 keeps failed gate output compact without throwing evidence away: deterministic previews
-retain actionable failures and final summaries, while large complete stdout/stderr remains available
-in private, content-addressed local artifacts. Existing projects keep their serial behavior and use
-safe 2 KiB preview / 8 KiB artifact defaults unless configured otherwise.
-
-Yoke 1.4 adds opt-in parallel workers and a bounded, reference-driven quality gauntlet without
+> **TL;DR** — `yoke setup .` asks six questions and installs the native harness for your agent. `yoke new my-app --idea="..."` bootstraps a project and drafts its story backlog. `yoke loop run my-app --isolate --review` then implements it behind hard gates: **clean tree → acceptance criteria → your real tests green → an independent model approves → commit**. Add `--parallel=N` for dependency-aware workers, or declare a reference and add `--quality` for a bounded critic/repair gauntlet. If any blocking gate is red, nothing is committed. Proof lives in `.yoke/proof/<story>/`.
+
+Yoke 1.5 keeps failed gate output compact without throwing evidence away: deterministic previews
+retain actionable failures and final summaries, while large complete stdout/stderr remains available
+in private, content-addressed local artifacts. Existing projects keep their serial behavior and use
+safe 2 KiB preview / 8 KiB artifact defaults unless configured otherwise.
+
+Yoke 1.4 adds opt-in parallel workers and a bounded, reference-driven quality gauntlet without
 changing existing serial loop defaults. See [the 1.4 migration guide](docs/MIGRATING-TO-1.4.md)
 for the new flags, configuration, cleanup behavior, and review-verdict contract.
 
@@ -81,7 +81,7 @@ $ ls reading-app/.yoke/proof/STORY-2/
 home.png  list.png                            # photographic evidence, labelled per story
 ```
 
-Every claim in that transcript is enforced by code paths with tests behind them — 971 of them, and this repo was built by its own loop and gates ([how it was built](#-why--how-it-was-built)).
+Every claim in that transcript is enforced by code paths with tests behind them — 1014 of them, and this repo was built by its own loop and gates ([how it was built](#-why--how-it-was-built)).
 
 ## 🚀 Quickstart
 
@@ -164,7 +164,7 @@ Yoke's CLI is deterministic and chainable by design: an agent (or a shell `&&`)
 | `yoke prd draft [dir] --idea= [--runner=] [--force]` | Idea → 5–12 stories with testable acceptance criteria | `0` · `1` invalid/guarded · `2` agent unavailable |
 | `yoke prd check [dir]` | PRD lint gate (schema, dependencies, cycles, duplicate ids, acceptance) | `0` valid · `1` violations |
 | `yoke change add\|status [dir] [--idea=]` | Queue a change at any time; the loop turns it into append-only stories at the next safe boundary | `0` · `1` invalid inbox/request |
-| `yoke context init\|status [dir]` | Durable context layer (`PROJECT/DECISIONS/KNOWLEDGE.md`) | `0` |
+| `yoke context init\|status [dir]` | Durable context layer (`PROJECT/DECISIONS/KNOWLEDGE/GLOSSARY.md`, optional `CONTEXT-MAP.md`) | `0` |
 | `yoke loop on\|off\|status\|decision\|answer\|resume\|run\|cleanup [dir]` | Autonomous loop; `run` supports `--parallel=N`, bounded reference-driven `--quality`, and blind `--candidates=N` selection; `--max=N` creates an intentional batch cap; `cleanup` retains worktrees unless `--remove-worktrees` is explicit | run: `0` complete · `1` blocked/cap · `2` not runnable / already locked · `3` paused |
 | `yoke review [dir] [--reviewer=] [--base=] [--focus=] [--json] [--allow-self-review]` | An independent model writes a schema-valid verdict | `0` approved · `1` findings/invalid verdict · `2` no independent reviewer |
 | `yoke audit [dir] [--json]` | Dependency, high-confidence secret, and sensitive-change audit | `0` green · `1` blocking findings · `2` not runnable |
@@ -216,9 +216,9 @@ Three layers — **Canon** (`yoke validate`) → **Retrofit** (`yoke retrofit`)
 
 | Agent | Artifacts |
 |---|---|
-| **Claude** | `.claude/skills/`, `AGENTS.md`, `CLAUDE.md`, `.mcp.json` (code-graph + Playwright), and an rtk `PreToolUse` hook when WSL is available |
-| **Codex** | `.agents/skills/`, `AGENTS.md`, `RTK.md`, `.codex/config.toml`, native hooks, reusable `.codex/agents/*.toml`, and package plugin metadata |
-| **Gemini** | `GEMINI.md`, `.gemini/commands/*.toml` (one per skill, full body), `.gemini/settings.json` (MCP + `AGENTS.md` context) |
+| **Claude** | Complete skill packages under `.claude/skills/` (including referenced resources), `AGENTS.md`, `CLAUDE.md`, `.mcp.json` (code-graph + Playwright), and an rtk `PreToolUse` hook when WSL is available |
+| **Codex** | Complete skill packages under `.agents/skills/`, per-skill implicit-invocation policy, `AGENTS.md`, `RTK.md`, `.codex/config.toml`, native hooks, reusable `.codex/agents/*.toml`, and package plugin metadata |
+| **Gemini** | Complete skill packages under `.gemini/skills/`, an auto-invocation index, `GEMINI.md`, `.gemini/commands/*.toml`, and `.gemini/settings.json` (MCP + `AGENTS.md` context) |
 
 > **rtk integration:** Claude receives its PreToolUse hook; Codex receives a native hook adapter around `rtk hook check`; Gemini retains instruction-mode fallback where its CLI has no equivalent command-rewrite lifecycle.
 
@@ -231,12 +231,17 @@ Three layers — **Canon** (`yoke validate`) → **Retrofit** (`yoke retrofit`)
 > instructions (tech stack, workflow, `@`-includes) inside it. Works in any yoke-written file;
 > content *outside* the markers is still replaced (and backed up under `.yoke/backup/`).
 
-## 🧰 What's in the canon — 29 skills
+## 🧰 What's in the canon — 34 skills
 
 `yoke retrofit` installs all of these into each agent natively. Provenance is credited in [`canon/skills/ATTRIBUTION.md`](canon/skills/ATTRIBUTION.md).
 
 To stop overlapping skills from auto-invoking against each other, `canon/AGENTS.md` carries a **skill routing & precedence** block (methodology before role; one canonical entrypoint per concern — e.g. pre-merge code review is always `review`), emitted into all three agents.
 
+Each manifest entry also declares `invocation: auto|manual`. Retrofit translates that intent into
+the provider's native controls: Claude disables model invocation for manual skills, Codex writes
+`agents/openai.yaml`, and Gemini lists only automatic skills in its generated index. Validation
+rejects conflicting package metadata and broken local Markdown links before anything is installed.
+
 **Process / methodology** — *superpowers-derived discipline (13)*
 
 | Skill | What it does |
@@ -267,7 +272,7 @@ To stop overlapping skills from auto-invoking against each other, `canon/AGENTS.
 | `retro` | Engineering retrospective from commit history |
 | `document-release` | Post-ship documentation sync (README / CHANGELOG / …) |
 
-**Yoke-native** — *authored or adapted for this harness (9)*
+**Yoke-native** — *authored or adapted for this harness (14)*
 
 | Skill | What it does |
 |---|---|
@@ -280,6 +285,11 @@ To stop overlapping skills from auto-invoking against each other, `canon/AGENTS.
 | `workflow` | The default order of operations, from idea to deploy |
 | `unslop-ui` | Detect & remove AI-slop design tells (purple gradients, neon glow, emoji-icons…) |
 | `visual-verification` | Widen verify to design-scan + the built-in `yoke flow-smoke` gate (screenshot proofs; video on failure) |
+| `no-ai-slop` | Detect and edit generic AI prose while preserving the author's voice; includes its evaluation rubric |
+| `domain-modeling` | Model boundaries, invariants, vocabulary, context maps, and decision records before implementation |
+| `codebase-design` | Explore architecture, deepen a chosen design, and compare two viable approaches when tradeoffs matter |
+| `resolving-merge-conflicts` | Resolve conflicts by reconstructing intent, then verify the integrated result |
+| `writing-for-agents` | Write compact agent instructions with explicit triggers, constraints, resources, and checks |
 
 ## 🌱 Zero to 100: `yoke new` + `yoke prd`
 
@@ -328,7 +338,9 @@ flowchart LR
     C -- yes --> D[agent implements<br/>one story]
     D --> E{suite + criterion<br/>proof green?}
     E -- no --> X
-    E -- yes --> F{reviewer<br/>approves?}
+    E -- yes --> V{UI design<br/>within budget?}
+    V -- no --> X
+    V -- yes --> F{reviewer<br/>approves?}
     F -- no --> X
     F -- yes --> G[commit + mark passes:true<br/>+ proof in .yoke/proof/]
     G --> I
@@ -599,7 +611,7 @@ be fast" is a vibe the loop cannot enforce. Yoke makes it mechanical, at two lev
 
 ### Artifact-backed gate output: compact context, complete local evidence
 
-Failed verify, executable-criterion, performance, configured custom-audit, and completion commands can emit thousands of
+Failed verify, executable-criterion, performance, configured custom-audit, and completion commands can emit thousands of
 low-signal lines. Yoke keeps the model-visible failure summary deterministic and bounded while
 preserving large raw stdout/stderr below `.yoke/artifacts/`:
 
@@ -619,16 +631,16 @@ for example:
 
 An agent can read that ordinary file when the preview is insufficient; nothing is injected into
 later stories automatically. Repeated identical failures reuse the same content-addressed path.
-Successful gate output is discarded as before. This affects only commands executed by Yoke's own
-gates. It does **not** intercept tool output generated internally by Claude Code, Codex, or Gemini,
-so benchmark ratios for this feature are not provider-token or billing claims.
-
-Command capture is capped at 16 MiB per stdout/stderr stream. Exceeding that quota fails the gate
-closed and stores the captured prefix with a `[truncated output: ...]` marker; Yoke never labels
-partial evidence as full output.
-
-Yoke treats `.yoke/artifacts/` as local, non-committable runtime state and excludes it from its
-clean-tree and story-commit operations; `yoke retrofit` also adds it to `.gitignore`. Raw command output is intentionally stored
+Successful gate output is discarded as before. This affects only commands executed by Yoke's own
+gates. It does **not** intercept tool output generated internally by Claude Code, Codex, or Gemini,
+so benchmark ratios for this feature are not provider-token or billing claims.
+
+Command capture is capped at 16 MiB per stdout/stderr stream. Exceeding that quota fails the gate
+closed and stores the captured prefix with a `[truncated output: ...]` marker; Yoke never labels
+partial evidence as full output.
+
+Yoke treats `.yoke/artifacts/` as local, non-committable runtime state and excludes it from its
+clean-tree and story-commit operations; `yoke retrofit` also adds it to `.gitignore`. Raw command output is intentionally stored
 without redaction so it remains valid evidence and may therefore contain credentials, personal
 data, or other sensitive text emitted by project commands. Inspect artifacts before sharing them.
 
@@ -693,8 +705,14 @@ Unit tests don't catch a blank page, an unwired route, or generic AI-slop design
 - **`unslop-ui` + `visual-verification` skills** — the design rubric, plus how to compose a verify
   pipeline (`types → units → design-scan → flow-smoke`).
 
-Because the loop trusts **verify as the source of truth**, widening `verify.command` to include the
-scanner and the flow-smoke makes visual quality a real gate — not an afterthought.
+Retrofit adds `design: { mode: auto, max: 4 }` when it detects UI dependencies, UI source files,
+or configured smoke flows. In `auto` mode the loop runs the design scan after functional verify and
+before performance/audit; `on` forces it for any project and `off` disables it. Existing explicit
+settings are preserved. `flow-smoke` remains an explicit project verify step because Yoke cannot
+infer how to start each application's server.
+
+`unslop-ui` is the visual-design skill. `no-ai-slop` is separate: it reviews prose for generic AI
+patterns and edits only confirmed problems while preserving meaning and voice.
 
 *Tell set informed by the MIT-licensed [vibecoded-design-tells](https://github.com/JCarterJohnson/vibecoded-design-tells) research.*
 
@@ -739,8 +757,11 @@ Yoke keeps durable, cross-session context so a fresh-context agent is never blin
 - `PROJECT.md` — the north star (goal, constraints, non-goals, success criteria).
 - `DECISIONS.md` — an append-only ledger. The loop adds an entry per completed story; you and agents add the *why*.
 - `KNOWLEDGE.md` — reusable gotchas and conventions.
+- `GLOSSARY.md` — the project's canonical terms, meanings, and aliases.
+- `CONTEXT-MAP.md` — optional bounded-context relationships for projects that need domain mapping.
 
-`yoke retrofit` scaffolds these files (non-destructively — your edits are never overwritten).
+`yoke retrofit` scaffolds the four core files non-destructively; your edits are never overwritten.
+It reports `CONTEXT-MAP.md` when the optional file already exists.
 The loop reads them into every agent + reviewer prompt and logs decisions back on each story's
 commit. Decision history is explicitly delimited as untrusted reference data, so stored text is
 never treated as fresh instructions. Manage the files directly with `yoke context init` and `yoke context status`. The
@@ -835,7 +856,7 @@ release provenance.
 ## 🧪 Development
 
 ```bash
-npm test          # vitest (971 tests)
+npm test          # vitest (1014 tests)
 npm run build     # tsc, no emit errors
 npm run yoke -- validate canon
 ```

package/canon/context/GLOSSARY.md

@@ -0,0 +1,11 @@
+# Glossary
+
+Record canonical project-specific domain terms here when they are settled.
+
+## Language
+
+<!--
+**Canonical term**
+: One or two sentences defining what the term is in this project.
+  _Avoid_: ambiguous alias, rejected synonym
+-->

package/canon/manifest.yaml

@@ -1,42 +1,48 @@
 name: yoke-canon
-version: 1.5.1
+version: 1.6.0
 agents: [claude, codex, gemini]
 skills:
-  - { id: tdd, path: skills/tdd, kind: methodology }
-  - { id: yoke-retrofit, path: skills/yoke-retrofit, kind: methodology }
-  - { id: yoke-workflow, path: skills/yoke-workflow, kind: methodology }
-  - { id: minimal-code, path: skills/minimal-code, kind: methodology }
-  - { id: maintaining-context, path: skills/maintaining-context, kind: methodology }
+  - { id: tdd, path: skills/tdd, kind: methodology, invocation: auto }
+  - { id: yoke-retrofit, path: skills/yoke-retrofit, kind: methodology, invocation: auto }
+  - { id: yoke-workflow, path: skills/yoke-workflow, kind: methodology, invocation: auto }
+  - { id: minimal-code, path: skills/minimal-code, kind: methodology, invocation: auto }
+  - { id: maintaining-context, path: skills/maintaining-context, kind: methodology, invocation: auto }
   # superpowers skills (kind: methodology)
-  - { id: brainstorming, path: skills/brainstorming, kind: methodology }
-  - { id: writing-plans, path: skills/writing-plans, kind: methodology }
-  - { id: executing-plans, path: skills/executing-plans, kind: methodology }
-  - { id: subagent-driven-development, path: skills/subagent-driven-development, kind: methodology }
-  - { id: systematic-debugging, path: skills/systematic-debugging, kind: methodology }
-  - { id: verification-before-completion, path: skills/verification-before-completion, kind: methodology }
-  - { id: using-git-worktrees, path: skills/using-git-worktrees, kind: methodology }
-  - { id: requesting-code-review, path: skills/requesting-code-review, kind: methodology }
-  - { id: receiving-code-review, path: skills/receiving-code-review, kind: methodology }
-  - { id: dispatching-parallel-agents, path: skills/dispatching-parallel-agents, kind: methodology }
-  - { id: finishing-a-development-branch, path: skills/finishing-a-development-branch, kind: methodology }
-  - { id: writing-skills, path: skills/writing-skills, kind: methodology }
+  - { id: brainstorming, path: skills/brainstorming, kind: methodology, invocation: auto }
+  - { id: writing-plans, path: skills/writing-plans, kind: methodology, invocation: auto }
+  - { id: executing-plans, path: skills/executing-plans, kind: methodology, invocation: auto }
+  - { id: subagent-driven-development, path: skills/subagent-driven-development, kind: methodology, invocation: auto }
+  - { id: systematic-debugging, path: skills/systematic-debugging, kind: methodology, invocation: auto }
+  - { id: verification-before-completion, path: skills/verification-before-completion, kind: methodology, invocation: auto }
+  - { id: using-git-worktrees, path: skills/using-git-worktrees, kind: methodology, invocation: auto }
+  - { id: requesting-code-review, path: skills/requesting-code-review, kind: methodology, invocation: auto }
+  - { id: receiving-code-review, path: skills/receiving-code-review, kind: methodology, invocation: auto }
+  - { id: dispatching-parallel-agents, path: skills/dispatching-parallel-agents, kind: methodology, invocation: auto }
+  - { id: finishing-a-development-branch, path: skills/finishing-a-development-branch, kind: methodology, invocation: auto }
+  - { id: writing-skills, path: skills/writing-skills, kind: methodology, invocation: auto }
   # gstack skills (kind: role)
-  - { id: review, path: skills/review, kind: role }
-  - { id: ship, path: skills/ship, kind: role }
-  - { id: health, path: skills/health, kind: role }
-  - { id: retro, path: skills/retro, kind: role }
-  - { id: document-release, path: skills/document-release, kind: role }
-  - { id: plan-ceo-review, path: skills/plan-ceo-review, kind: role }
-  - { id: plan-eng-review, path: skills/plan-eng-review, kind: role }
+  - { id: review, path: skills/review, kind: role, invocation: auto }
+  - { id: ship, path: skills/ship, kind: role, invocation: auto }
+  - { id: health, path: skills/health, kind: role, invocation: auto }
+  - { id: retro, path: skills/retro, kind: role, invocation: auto }
+  - { id: document-release, path: skills/document-release, kind: role, invocation: auto }
+  - { id: plan-ceo-review, path: skills/plan-ceo-review, kind: role, invocation: auto }
+  - { id: plan-eng-review, path: skills/plan-eng-review, kind: role, invocation: auto }
   # authored workflow skill (kind: methodology)
-  - { id: workflow, path: skills/workflow, kind: methodology }
+  - { id: workflow, path: skills/workflow, kind: methodology, invocation: auto }
   # visual & design verification (kind: methodology)
-  - { id: unslop-ui, path: skills/unslop-ui, kind: methodology }
-  - { id: visual-verification, path: skills/visual-verification, kind: methodology }
+  - { id: unslop-ui, path: skills/unslop-ui, kind: methodology, invocation: auto }
+  - { id: visual-verification, path: skills/visual-verification, kind: methodology, invocation: auto }
   # zero-to-100 bootstrap (kind: methodology)
-  - { id: authoring-prd, path: skills/authoring-prd, kind: methodology }
+  - { id: authoring-prd, path: skills/authoring-prd, kind: methodology, invocation: auto }
   # measured efficiency (kind: methodology)
-  - { id: performance, path: skills/performance, kind: methodology }
+  - { id: performance, path: skills/performance, kind: methodology, invocation: auto }
+  # prose, domain, and codebase capabilities
+  - { id: no-ai-slop, path: skills/no-ai-slop, kind: methodology, invocation: auto }
+  - { id: domain-modeling, path: skills/domain-modeling, kind: methodology, invocation: auto }
+  - { id: codebase-design, path: skills/codebase-design, kind: methodology, invocation: auto }
+  - { id: resolving-merge-conflicts, path: skills/resolving-merge-conflicts, kind: methodology, invocation: auto }
+  - { id: writing-for-agents, path: skills/writing-for-agents, kind: methodology, invocation: auto }
 policy:
   - { path: policy/gates.md }
   - { path: policy/roles.md }

package/canon/skills/ATTRIBUTION.md

@@ -50,6 +50,34 @@ was copied.
 
 ---
 
+## no-ai-slop
+
+**Source:** https://github.com/petergyang/no-ai-slop
+
+**Copyright:** Copyright (c) 2026 Peter Yang
+
+**Skills adapted:** no-ai-slop and its evaluation checklist
+
+Yoke preserves the upstream Edit and Detect modes, voice-preserving workflow, named-pattern
+approach, and no-authorship-guess boundary. The adaptation adds Yoke's precise-domain-term rule,
+portable package wording, and a shorter evaluation checklist.
+
+---
+
+## mattpocock/skills
+
+**Source:** https://github.com/mattpocock/skills
+
+**Copyright:** Copyright (c) 2026 Matt Pocock
+
+**Skills adapted:** domain-modeling, codebase-design, resolving-merge-conflicts,
+writing-for-agents, and their supporting references
+
+The adaptations use `.yoke/context/` as Yoke's durable context location, preserve Yoke's existing
+authorization and verification rules, and remove provider-specific metadata from Canon source.
+
+---
+
 ## MIT License
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/canon/skills/codebase-design/DEEPENING.md

@@ -0,0 +1,15 @@
+# Deepening
+
+Classify dependencies before moving shallow behavior behind one interface.
+
+1. **In-process:** pure computation or in-memory state. Merge and test through the new interface.
+2. **Local-substitutable:** a real local stand-in exists, such as an in-memory filesystem. Test the
+   module with that stand-in; the seam can remain internal.
+3. **Remote but owned:** define a port at the seam. Use the production transport adapter and an
+   in-memory test adapter.
+4. **True external:** inject a narrow port for the third-party dependency and test with a controlled
+   adapter.
+
+Replace shallow implementation tests with tests at the deepened interface once equivalent
+observable coverage exists. Avoid layering both suites indefinitely. If a test must change for an
+internal refactor, it is probably reaching past the interface.

package/canon/skills/codebase-design/DESIGN-IT-TWICE.md

@@ -0,0 +1,12 @@
+# Design it twice
+
+Use this only for a consequential interface with more than one credible shape.
+
+1. State constraints, dependency categories, required invariants, error modes, and the current
+   seam. A small sketch may clarify the problem but must not preselect the answer.
+2. Produce at least two materially different interfaces. When parallel agents are authorized and
+   available, one can minimize surface area while another optimizes the common caller or adapter
+   flexibility. Otherwise, explore the alternatives sequentially.
+3. For each design, show caller usage, hidden implementation, adapters, and trade-offs.
+4. Compare designs by depth, locality, seam placement, migration cost, and verification surface.
+5. Recommend one design or a concrete hybrid. Do not leave the user with an unranked menu.

package/canon/skills/codebase-design/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: codebase-design
+description: Design or improve deep modules, small interfaces, real seams, and public-interface tests. Use when shaping a module, placing a dependency seam, evaluating shallow pass-through layers, improving testability, or comparing architecture alternatives; do not force unrelated refactors.
+---
+
+# Codebase design
+
+Design deep modules: substantial behavior behind a small interface, placed at a real seam and
+tested through that interface. Optimize for caller leverage and maintainer locality.
+
+## Vocabulary
+
+- **Module:** anything with one interface and an implementation, from a function to a package.
+- **Interface:** everything a caller must know: types, invariants, ordering, errors, configuration,
+  and relevant performance behavior.
+- **Implementation:** the behavior hidden inside a module.
+- **Depth:** useful behavior per unit of interface a caller must learn.
+- **Seam:** a place where behavior can change without editing the caller at that place.
+- **Adapter:** a concrete implementation that satisfies an interface at a seam.
+- **Leverage:** capability callers gain from a small interface.
+- **Locality:** change, knowledge, bugs, and verification concentrated in one place.
+
+Use these terms consistently. Prefer **seam** over the overloaded word **boundary** when discussing
+replaceable behavior.
+
+## Design checks
+
+- Reduce methods and parameters when callers do not need the exposed choice.
+- Hide repeated orchestration, invariants, and error handling inside the module.
+- Apply the deletion test: deleting a useful module should make its complexity reappear across its
+  callers. A layer whose complexity simply vanishes was probably a pass-through.
+- Treat the interface as the test surface. Tests should survive internal refactors.
+- Accept dependencies at real seams instead of constructing hard-to-replace externals internally.
+- Introduce a seam for demonstrated variation. Production plus a meaningful test adapter can make
+  two real adapters; a single speculative adapter does not.
+- Return observable results where practical instead of requiring tests to inspect internal state.
+
+For dependency-specific deepening, read [DEEPENING.md](DEEPENING.md). For a consequential interface
+with several plausible shapes, read [DESIGN-IT-TWICE.md](DESIGN-IT-TWICE.md).

package/canon/skills/document-release/SKILL.md

@@ -18,6 +18,11 @@ You are running the `document-release` workflow. This runs **after `ship`** (cod
 
 You are mostly automated. Make obvious factual updates directly. Stop and ask only for risky or subjective decisions.
 
+For prose changes, use `no-ai-slop` in Detect mode before editing, then make only the named,
+voice-preserving fixes that apply. Check the result against that skill's `eval.md`. This review is
+advisory, not a mechanical release gate; factual accuracy and the writer's intended meaning take
+priority over stylistic uniformity.
+
 **Only stop for:**
 - Risky/questionable doc changes (narrative, philosophy, security, removals, large rewrites)
 - VERSION bump decision (if not already bumped)

package/canon/skills/domain-modeling/ADR-FORMAT.md

@@ -0,0 +1,19 @@
+# ADR-class decision format
+
+Append a concise entry to `.yoke/context/DECISIONS.md` only when the choice is:
+
+1. hard to reverse;
+2. surprising without context; and
+3. the result of a real trade-off.
+
+Use this shape:
+
+```md
+## YYYY-MM-DD — ADR: Short decision title
+
+Context: one sentence describing the constraint or trade-off.
+Decision: one sentence stating the chosen direction and why.
+```
+
+Add considered options or consequences only when a future maintainer would otherwise repeat the
+same investigation. Easy, obvious, or no-alternative choices stay out of the decision log.

package/canon/skills/domain-modeling/CONTEXT-FORMAT.md

@@ -0,0 +1,39 @@
+# Glossary and context-map format
+
+## GLOSSARY.md
+
+```md
+# Glossary
+
+## Ordering
+
+**Order**
+: A customer's confirmed request for one or more products.
+  _Avoid_: Purchase, transaction
+
+**Cancellation**
+: The reversal of an entire Order before fulfillment begins.
+  _Avoid_: Refund, deletion
+```
+
+Keep each definition to one or two sentences. Define what the term is, name aliases to avoid, and
+include only concepts specific to this project's domain. Group terms when natural clusters emerge.
+
+## CONTEXT-MAP.md
+
+Create this optional file only for multiple domain contexts:
+
+```md
+# Context Map
+
+## Contexts
+
+- **Ordering**: receives and tracks customer orders
+- **Billing**: issues invoices and processes payments
+
+## Relationships
+
+- **Ordering -> Billing**: Ordering emits `OrderConfirmed`; Billing creates an invoice.
+```
+
+Name ownership and the observable relationship. Do not turn the map into an implementation dump.

package/canon/skills/domain-modeling/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: domain-modeling
+description: Build or sharpen a project's domain language and durable decisions. Use when terminology is fuzzy or contradictory, relationships need scenario testing, the code disagrees with the stated model, or a glossary or ADR-class decision must be updated; do not trigger merely to read existing context.
+---
+
+# Domain modeling
+
+Build the model actively: challenge terms, test relationships with concrete scenarios, compare the
+stated behavior with code, and record a term when it becomes settled.
+
+Yoke stores durable context under `.yoke/context/`:
+
+- `GLOSSARY.md` is the canonical language for a single domain context.
+- `CONTEXT-MAP.md` is optional and maps multiple domain contexts plus their relationships.
+- `DECISIONS.md` records durable outcomes and ADR-class trade-offs.
+
+Read the existing files before proposing vocabulary. Merely consuming their terms is a normal
+context habit, not a reason to run this skill.
+
+## Workflow
+
+1. Identify overloaded, vague, conflicting, or missing terms in the request and current glossary.
+2. Propose one canonical term and name avoidable aliases. Ask when the distinction changes behavior.
+3. Stress-test relationships with specific scenarios, especially partial, repeated, failed, and
+   cross-context cases.
+4. Compare the model with public interfaces, persistence shapes, and relevant tests. Surface a
+   contradiction instead of silently choosing one side.
+5. When a term is settled, update `GLOSSARY.md` immediately using
+   [CONTEXT-FORMAT.md](CONTEXT-FORMAT.md). Preserve unrelated entries.
+6. Update `CONTEXT-MAP.md` only when the repository contains more than one genuine domain context.
+7. Record an ADR-class decision only when all three thresholds in
+   [ADR-FORMAT.md](ADR-FORMAT.md) pass.
+
+Glossary definitions describe the domain, not its implementation. General programming concepts do
+not belong there.