@ikon85/agent-workflow-kit 0.26.2 → 0.27.1

package/.agents/skills/ask-matt/SKILL.md

@@ -90,8 +90,7 @@ An independent second model catches what one model rationalises. Read-only, boun
 
 Not feature work — upkeep.
 
-- **`/improve-codebase-architecture`** — run in spare moments to keep the codebase good for agents. Surfaces **deepening opportunities**; picking one _generates an idea_ for the main flow at `/grill-with-docs`.
-- **`/zoom-out`** — step back from the diff to the structure when a change is fighting the codebase; recon that becomes a planned slice or guides a refactor in place.
+- **`/improve-codebase-architecture`** — run in spare moments to keep the codebase good for agents, or step back from the diff to the structure when a change is fighting the codebase. Surfaces **deepening opportunities**; picking one _generates an idea_ for the main flow at `/grill-with-docs`.
 - **`/security-audit`** — a whole-app, application-layer security audit run as an independent two-model pass (two models audit the same code separately, then the remediation plan is hardened before any fix). Run before a release or after the attack surface changes (new endpoint, new input source, auth change, dependency bump). Infra hardening (ports/TLS/SSH/backups) is audited separately.
 
 ## Vocabulary underneath

package/.agents/skills/board-to-waves/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: board-to-waves
 disable-model-invocation: false
-"description": "Use when sweeping/grooming the GitHub backlog board to cluster open issues into thematic waves (Wellen) — \"lass uns das Board durchgehen\", \"was ist offen und passt zusammen\", \"clustern wir den Backlog\", \"welche Wellen stecken da drin\" — or to spot candidate waves before planning. Reads all open issues, groups them by the Gate+Booster+Splitter heuristic, estimates size/risk + grill-needed per candidate, and after the user confirms creates cluster/Wave-less candidate STUB issues with a To-Do checklist. STOPS at stubs: no PRD, no slicing, no sub-issue links, no promotion (downstream: to-prd matures the stub, to-issues slices + promotes). NOT for maturing/slicing ONE already-chosen candidate (to-prd/to-issues), NOT for per-issue triage labelling (triage), NOT for code comprehension (zoom-out) — this is board-WIDE thematic affinity grouping, not per-issue and not code-reading."
+"description": "Use when sweeping/grooming the GitHub backlog board to cluster open issues into thematic waves (Wellen) — \"lass uns das Board durchgehen\", \"was ist offen und passt zusammen\", \"clustern wir den Backlog\", \"welche Wellen stecken da drin\" — or to spot candidate waves before planning. Reads all open issues, groups them by the Gate+Booster+Splitter heuristic, estimates size/risk + grill-needed per candidate, and after the user confirms creates cluster/Wave-less candidate STUB issues with a To-Do checklist. STOPS at stubs: no PRD, no slicing, no sub-issue links, no promotion (downstream: to-prd matures the stub, to-issues slices + promotes). NOT for maturing/slicing ONE already-chosen candidate (to-prd/to-issues), NOT for per-issue triage labelling (triage), NOT for code comprehension — this is board-WIDE thematic affinity grouping, not per-issue and not code-reading."
 ---
 
 # board-to-waves
@@ -130,6 +130,6 @@ Next step (<maintainer>'s call, separate): grill → to-prd (matures the stub)
 
 ## Notes
 - **Stops at stubs.** Never write the PRD, slice, link, promote, or call `to-prd`/`to-issues` yourself.
-- Boundary: `triage` = per-issue state machine; `zoom-out` = code comprehension; `board-to-waves` = board-wide thematic affinity. Different altitudes.
+- Boundary: `triage` = per-issue state machine; `improve-codebase-architecture` = code structure; `board-to-waves` = board-wide thematic affinity. Different altitudes.
 - A leftover bucket is OK and intentional — not every issue belongs in a wave. Force-clustering dilutes the gate.
 - Size/risk are a rough estimate, not a commitment. <maintainer> can override the stub's "when to grill" recommendation at any time.

package/.agents/skills/improve-codebase-architecture/SKILL.md

@@ -8,8 +8,6 @@ description: "Find deepening opportunities in a codebase, informed by the domain
 
 Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
 
-For a quick one-off map of an unfamiliar area without the report/grilling loop below, use `zoom-out` instead.
-
 ## Glossary
 
 Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md).

package/.agents/skills/setup-workflow/board-sync.md

@@ -71,6 +71,9 @@ The optional `wrapup` block is a wrapup-only switch, not a board field: `wrapup.
   "headings": {
     "vorBau": "Clarify Before Build"
   },
+  "titles": {
+    "wavePrefix": "Wave"
+  },
   "wrapup": {
     "remoteBranchSweep": false
   }
@@ -93,6 +96,14 @@ follows; renaming an option later is one edit here. A role you don't have
 with a visible hint, and `--status-role` commands fail with the exact snippet
 to add.
 
+### Wave titles (`titles.wavePrefix`)
+
+The word that opens a wave anchor's title: `<prefix> <N> — <topic>` (e.g.
+`Wave 7 — Auth hardening`). `board-sync.py promote` writes it and strips an
+existing one idempotently on re-promote. A profile **without** the key keeps
+the historical default `"Welle"`, so boards created before this key keep
+their titles unchanged; set it once to match your board's language.
+
 ## If the IDs are not yet filled (stub)
 
 1. Create a GitHub-Projects (v2) board for this owner and add the fields above (at minimum a `Status` single-select with your stage options — the recommended stage names are `Idea, Triaged, Spec, In Progress, Review, Done`, matching the seeded `roles` defaults).

package/.claude/skills/ask-matt/SKILL.md

@@ -90,8 +90,7 @@ An independent second model catches what one model rationalises. Read-only, boun
 
 Not feature work — upkeep.
 
-- **`/improve-codebase-architecture`** — run in spare moments to keep the codebase good for agents. Surfaces **deepening opportunities**; picking one _generates an idea_ for the main flow at `/grill-with-docs`.
-- **`/zoom-out`** — step back from the diff to the structure when a change is fighting the codebase; recon that becomes a planned slice or guides a refactor in place.
+- **`/improve-codebase-architecture`** — run in spare moments to keep the codebase good for agents, or step back from the diff to the structure when a change is fighting the codebase. Surfaces **deepening opportunities**; picking one _generates an idea_ for the main flow at `/grill-with-docs`.
 - **`/security-audit`** — a whole-app, application-layer security audit run as an independent two-model pass (two models audit the same code separately, then the remediation plan is hardened before any fix). Run before a release or after the attack surface changes (new endpoint, new input source, auth change, dependency bump). Infra hardening (ports/TLS/SSH/backups) is audited separately.
 
 ## Vocabulary underneath

package/.claude/skills/board-to-waves/SKILL.md

@@ -12,7 +12,7 @@ description: >-
   stubs: no PRD, no slicing, no sub-issue links, no promotion (downstream:
   to-prd matures the stub, to-issues slices + promotes). NOT for
   maturing/slicing ONE already-chosen candidate (to-prd/to-issues), NOT for
-  per-issue triage labelling (triage), NOT for code comprehension (zoom-out) —
+  per-issue triage labelling (triage), NOT for code comprehension —
   this is board-WIDE thematic affinity grouping, not per-issue and not
   code-reading.
 ---
@@ -143,6 +143,6 @@ Next step (<maintainer>'s call, separate): grill → to-prd (matures the stub)
 
 ## Notes
 - **Stops at stubs.** Never write the PRD, slice, link, promote, or call `to-prd`/`to-issues` yourself.
-- Boundary: `triage` = per-issue state machine; `zoom-out` = code comprehension; `board-to-waves` = board-wide thematic affinity. Different altitudes.
+- Boundary: `triage` = per-issue state machine; `improve-codebase-architecture` = code structure; `board-to-waves` = board-wide thematic affinity. Different altitudes.
 - A leftover bucket is OK and intentional — not every issue belongs in a wave. Force-clustering dilutes the gate.
 - Size/risk are a rough estimate, not a commitment. <maintainer> can override the stub's "when to grill" recommendation at any time.

package/.claude/skills/improve-codebase-architecture/SKILL.md

@@ -8,8 +8,6 @@ description: Find deepening opportunities in a codebase, informed by the domain
 
 Surface architectural friction and propose **deepening opportunities** — refactors that turn shallow modules into deep ones. The aim is testability and AI-navigability.
 
-For a quick one-off map of an unfamiliar area without the report/grilling loop below, use `zoom-out` instead.
-
 ## Glossary
 
 Use these terms exactly in every suggestion. Consistent language is the point — don't drift into "component," "service," "API," or "boundary." Full definitions in [LANGUAGE.md](LANGUAGE.md).

package/.claude/skills/setup-pre-commit/SKILL.md

@@ -102,3 +102,6 @@ both: pick one hooks mechanism per repo.
 - Hooks are just scripts — `echo`-debug them freely; nothing is hidden behind a
   tool.
 - Exit non-zero = block the commit. Exit 0 = allow.
+- Keep the template's `unset GIT_DIR …` line: git exports these to hooks, and a
+  gate that runs tests which call git in their own temp repos would otherwise
+  operate on the host repo's index instead.

package/.claude/skills/setup-pre-commit/scripts/pre-commit.template.sh

@@ -11,6 +11,12 @@
 
 set -euo pipefail
 
+# --- Env sanitize (keep this) ----------------------------------------------
+# Git exports GIT_DIR & co. to hooks. If your gate runs a test suite whose
+# child tests call git in their own temp repos, these inherited vars redirect
+# every such git call onto THIS repo's index (mass-staged deletions).
+unset GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE GIT_PREFIX
+
 # --- Optional preflight ----------------------------------------------------
 # Bail early with a clear message if the toolchain isn't installed, so the
 # real checks don't fail with cryptic errors. Adapt or delete for your stack.

package/.claude/skills/setup-workflow/board-sync.md

@@ -71,6 +71,9 @@ The optional `wrapup` block is a wrapup-only switch, not a board field: `wrapup.
   "headings": {
     "vorBau": "Clarify Before Build"
   },
+  "titles": {
+    "wavePrefix": "Wave"
+  },
   "wrapup": {
     "remoteBranchSweep": false
   }
@@ -93,6 +96,14 @@ follows; renaming an option later is one edit here. A role you don't have
 with a visible hint, and `--status-role` commands fail with the exact snippet
 to add.
 
+### Wave titles (`titles.wavePrefix`)
+
+The word that opens a wave anchor's title: `<prefix> <N> — <topic>` (e.g.
+`Wave 7 — Auth hardening`). `board-sync.py promote` writes it and strips an
+existing one idempotently on re-promote. A profile **without** the key keeps
+the historical default `"Welle"`, so boards created before this key keep
+their titles unchanged; set it once to match your board's language.
+
 ## If the IDs are not yet filled (stub)
 
 1. Create a GitHub-Projects (v2) board for this owner and add the fields above (at minimum a `Status` single-select with your stage options — the recommended stage names are `Idea, Triaged, Spec, In Progress, Review, Done`, matching the seeded `roles` defaults).

package/.claude/skills/skill-manifest.json

@@ -167,15 +167,6 @@
       ],
       "provenance": "matt-pocock"
     },
-    "zoom-out": {
-      "class": "vendored",
-      "publish": true,
-      "surfaces": [
-        "claude",
-        "codex"
-      ],
-      "provenance": "matt-pocock"
-    },
     "improve-codebase-architecture": {
       "class": "vendored",
       "publish": true,

package/PROVENANCE.md

@@ -6,7 +6,7 @@ not byte-identity.
 
 ## Matt Pocock (MIT) — https://github.com/mattpocock/skills @ d574778
 
-to-prd, to-issues, grill-with-docs, grill-me, tdd, diagnose, zoom-out,
+to-prd, to-issues, grill-with-docs, grill-me, tdd, diagnose,
 improve-codebase-architecture, prototype, triage, write-a-skill,
 codebase-design, domain-modeling, implement, resolving-merge-conflicts, ask-matt,
 wayfinder, research, git-guardrails-claude-code, setup-workflow.
@@ -15,9 +15,10 @@ Folder↔upstream-name divergence (upstream renamed; local folder kept for
 invocation stability): `diagnose` = upstream `diagnosing-bugs`,
 `write-a-skill` = upstream `writing-great-skills`, `to-prd` = upstream
 `to-spec`, `to-issues` = upstream `to-tickets` (upstream merged to-issues +
-the short-lived to-plan into to-tickets @ v1.1.0). `zoom-out` was removed
-upstream (attribution pins to its last-seen SHA 2bf7005) and is retained here
-as a local fork.
+the short-lived to-plan into to-tickets @ v1.1.0). `zoom-out` (last-seen
+upstream SHA 2bf7005) was removed upstream and, after a period as a local
+fork, removed from this kit as well — `improve-codebase-architecture` covers
+the step-back-to-the-structure door.
 
 Each carries a `THIRD-PARTY-NOTICES.md` with its upstream path.
 

package/README.md

@@ -58,22 +58,20 @@ The skills aren't a grab-bag — they're four phases of one loop, entered throug
 single funnel no matter where your work starts. Each phase below names the failure
 mode it removes and the skills that remove it.
 
-![The workflow loop: idea / plan / backlog / raw-issue all funnel through an optional grill into one uniform PRD, which to-issues decomposes into an atomic issue or a wave anchor; a gate clears any unknown, then Execute → Land → Learn, which compounds back into the next idea. Two further streams enter outside the funnel — a bug/anomaly through diagnose, and a code-fighting-the-structure change through zoom-out — both joining at Execute; a one-time repo-setup lane (setup-workflow, git-guardrails, setup-pre-commit) sits off the loop and installs the pre-commit/pre-push gate that Land relies on.](docs/workflow.png)
+![The workflow as a subway map — one row per route, all converging on the same implement → wrapup → retro spine: a scale-check router sizes unclear work; the main line runs idea through an optional grill, to-prd, to-issues and a gate into implement (which drives tdd inside), wrapup, retro; a grill line scales from none over grill-me and grill-with-docs up to the +codex variants; a codex line adds cross-model review and build; program and board lines fund numbered waves built by orchestrate-wave; repair (diagnose) and structure (improve-codebase-architecture) lines enter from broken or tangled work; a learn line routes retro's findings into config by weight. Interchanges: verify-spike / decision-gate before an unknown, prototype for an unclear path, local-ci plus pre-commit/pre-push hooks before landing, ask-matt when lost, and a one-time setup lane.](docs/workflow.png)
 
 <!--
-  The image above is a pre-rendered PNG, not a live Mermaid block, on purpose:
-  GitHub's Mermaid renderer clips long node labels, and an <img>-embedded SVG
-  can't render Mermaid's foreignObject node text (shows blank). A rasterised PNG
-  renders identically everywhere.
-  Source of truth: tools/agent-workflow-kit/assets/workflow.mmd
-  Regenerate after editing the source:
-    npx -y @mermaid-js/mermaid-cli \
-      -i tools/agent-workflow-kit/assets/workflow.mmd \
-      -o tools/agent-workflow-kit/assets/workflow.png \
-      -t dark -b '#0d1117' -s 3
-  build-kit.mjs copies assets/workflow.png -> dist-kit/docs/workflow.png.
+  The image above is a pre-rendered PNG, not live HTML, on purpose: GitHub
+  READMEs can't embed HTML pages, and a PNG renders identically everywhere.
+  Source of truth: docs/workflow.html (same design language as
+  docs/methodology.html). Regenerate after editing the source:
+    serve docs/ locally, open workflow.html?theme=dark in a 1160px-wide
+    viewport, take a full-page screenshot -> docs/workflow.png
+  The interactive version is linked below and published via GitHub Pages.
 -->
 
+**[view the workflow map →](https://ikon85.github.io/agent-workflow-kit/workflow.html)**
+
 
 ### 1. Plan — turn a vague idea into shaped, tracked work
 
@@ -155,7 +153,7 @@ enter outside the plan funnel and feed straight into Execute:
 - **`diagnose`** — a disciplined root-cause hunt for bugs (reproduce → isolate →
   fix → prove), not a guess-and-patch. Entered from a bug or anomaly, never the PRD
   funnel; the fix it lands flows on into Execute.
-- **`zoom-out` / `improve-codebase-architecture`** — step back from the diff to
+- **`improve-codebase-architecture`** — step back from the diff to
   the structure when a change is fighting the codebase. A recon stream that either
   becomes a planned slice (back through `to-issues`) or guides a refactor in place.
 
@@ -332,6 +330,29 @@ still reference. Flags: `--force` (overwrite pre-existing files on `init`),
 
 ## Release notes
 
+### 0.27.1
+
+- changed: `scripts/release-parity.mjs`
+
+### 0.27.0
+
+- removed: `.agents/skills/zoom-out/SKILL.md`
+- removed: `.agents/skills/zoom-out/THIRD-PARTY-NOTICES.md`
+- removed: `.claude/skills/zoom-out/SKILL.md`
+- removed: `.claude/skills/zoom-out/THIRD-PARTY-NOTICES.md`
+- changed: `.agents/skills/ask-matt/SKILL.md`
+- changed: `.agents/skills/board-to-waves/SKILL.md`
+- changed: `.agents/skills/improve-codebase-architecture/SKILL.md`
+- changed: `.agents/skills/setup-workflow/board-sync.md`
+- changed: `.claude/skills/ask-matt/SKILL.md`
+- changed: `.claude/skills/board-to-waves/SKILL.md`
+- changed: `.claude/skills/improve-codebase-architecture/SKILL.md`
+- changed: `.claude/skills/setup-pre-commit/SKILL.md`
+- changed: `.claude/skills/setup-pre-commit/scripts/pre-commit.template.sh`
+- changed: `.claude/skills/setup-workflow/board-sync.md`
+- changed: `scripts/board-sync.py`
+- changed: `scripts/board_config.py`
+
 ### 0.26.2
 
 - Metadata-only release.
@@ -743,14 +764,15 @@ still reference. Flags: `--force` (overwrite pre-existing files on `init`),
 
 ## What's in the box
 
-**42 skills** (Router: ask-matt — "which skill/flow fits?" · Plan: grill-me,
+**43 skills** (Router: ask-matt — "which skill/flow fits?" · Plan: grill-me,
 grill-with-docs, to-prd, to-issues, board-to-waves, triage, spec-self-critique,
 verify-spike, decision-gate, scale-check, to-waves, wayfinder, research · Execute: tdd, prototype, implement, orchestrate-wave ·
-Design/diagnose/refactor streams: diagnose, zoom-out,
+Design/diagnose/refactor streams: diagnose,
 improve-codebase-architecture, codebase-design, domain-modeling, security-audit · Land: wrapup,
 resolving-merge-conflicts, code-review, local-ci, git-worktree-recover, kit-release,
-project-release · Learn: retro, audit-skills, write-a-skill · Setup:
-setup-workflow, git-guardrails, setup-pre-commit · Codex cross-model: grill-me-codex,
+project-release, kit-update · Learn: retro, audit-skills, write-a-skill,
+memory-lifecycle · Setup:
+setup-workflow, git-guardrails, setup-pre-commit, census-update · Codex cross-model: grill-me-codex,
 grill-with-docs-codex, codex-review, codex-build),
 installed for both surfaces — `.claude/skills`
 (Claude Code) and `.agents/skills` (Codex) — plus `codex-adapter-sync`

package/agent-workflow-kit.package.json

@@ -1,5 +1,5 @@
 {
-  "kitVersion": "0.26.2",
+  "kitVersion": "0.27.1",
   "files": [
     {
       "path": ".agents/skills/ask-matt/SKILL.md",
@@ -7,7 +7,7 @@
       "ownerSkill": "ask-matt",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "0231dfe9e39406a4c86f86fe93f00a01dbe0390cbc2ca0f425ac6fca4c2f0406",
+      "sha256": "23997067d90e7a14c49b0bf2000a1f042cca0db8f45197dac7a8e3a8316bfed9",
       "mode": 420,
       "origin": "kit"
     },
@@ -37,7 +37,7 @@
       "ownerSkill": "board-to-waves",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "edcfbab80c6fc019ae1ba25b2fbec564c832b1619a4a92d175e214415335160a",
+      "sha256": "1e145fd3da4426aa210169d9a47c5558588ee7317cbeb4ae8d0852c2cd672943",
       "mode": 420,
       "origin": "kit"
     },
@@ -347,7 +347,7 @@
       "ownerSkill": "improve-codebase-architecture",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "d7a51056b856fced86046c365ac68e3b7353af831a6313e6b0adf5a9c9042160",
+      "sha256": "594ef87762120abab778e454c27d240bf5b2c3411f7fe6c5f6ff028a6cdfeb4b",
       "mode": 420,
       "origin": "kit"
     },
@@ -557,7 +557,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "codex",
       "installRole": "consumer",
-      "sha256": "71fd0b2d637922d405981d12c2c65ba3b7509bb2ff48ea4eb12499b8c5dcdac4",
+      "sha256": "032c9654baf6f5e60007e7d0767a96ab823a442ed86cb52e801836130c9b5ba2",
       "mode": 420,
       "origin": "kit"
     },
@@ -971,26 +971,6 @@
       "mode": 420,
       "origin": "kit"
     },
-    {
-      "path": ".agents/skills/zoom-out/SKILL.md",
-      "kind": "skill",
-      "ownerSkill": "zoom-out",
-      "surface": "codex",
-      "installRole": "consumer",
-      "sha256": "cc448ec9d88e3c9d06fd1d6083a3c15a342b8399bc46829169b8c30d5e657a27",
-      "mode": 420,
-      "origin": "kit"
-    },
-    {
-      "path": ".agents/skills/zoom-out/THIRD-PARTY-NOTICES.md",
-      "kind": "skill",
-      "ownerSkill": "zoom-out",
-      "surface": "codex",
-      "installRole": "consumer",
-      "sha256": "87a6e3845e705204a009b26bab75f09e64d97f2d00e19ccd9ee1da39564dbc69",
-      "mode": 420,
-      "origin": "kit"
-    },
     {
       "path": ".claude/hooks/_hook_utils.py",
       "kind": "hook",
@@ -1181,7 +1161,7 @@
       "ownerSkill": "ask-matt",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "0d6dd8e359cb3084cb14fd700536d5bcd1e60edfb9a9f616078b8eb3d7ccd85d",
+      "sha256": "931ccbc6645adcb02f585061aaf32655ddc1ae547ebb131b6956e8fe227376aa",
       "mode": 420,
       "origin": "kit"
     },
@@ -1211,7 +1191,7 @@
       "ownerSkill": "board-to-waves",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "c68eb8a3328835bbad977b5981d38d64e43a67977f825a0b56766d6386caf4bc",
+      "sha256": "28c47d10f7508cadf5056c66a62d5891dfb61733a30ae517be24dd766c7996dd",
       "mode": 420,
       "origin": "kit"
     },
@@ -1641,7 +1621,7 @@
       "ownerSkill": "improve-codebase-architecture",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "ea979ce3b71da45cb15408f10f2481fb71bb72bba7b52747dd4f7fad45c64948",
+      "sha256": "bf96773f4ba75a53c8b916052e36a6c0f4bcae8b46b94bb72beb446048ca6d8a",
       "mode": 420,
       "origin": "kit"
     },
@@ -1841,7 +1821,7 @@
       "ownerSkill": "setup-pre-commit",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "b64a0af66a52f397f7495d2e27ea6a2bf33cd7bc9c57fd18061ae5036296e5d3",
+      "sha256": "32a6aba5f5a88079ea81ca31a04fcffd3973e7d52584dca570cd8777c0dd618d",
       "mode": 420,
       "origin": "kit"
     },
@@ -1851,7 +1831,7 @@
       "ownerSkill": "setup-pre-commit",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "b2c727f5922dce2acb21bfa055c208a20893f7a54e4967656a64beeedec90ebe",
+      "sha256": "61ab40452ed411170ef16fbe2d6e5df39a61457c343ecedd23dbf726c1d800b7",
       "mode": 420,
       "origin": "kit"
     },
@@ -1871,7 +1851,7 @@
       "ownerSkill": "setup-workflow",
       "surface": "claude",
       "installRole": "consumer",
-      "sha256": "71fd0b2d637922d405981d12c2c65ba3b7509bb2ff48ea4eb12499b8c5dcdac4",
+      "sha256": "032c9654baf6f5e60007e7d0767a96ab823a442ed86cb52e801836130c9b5ba2",
       "mode": 420,
       "origin": "kit"
     },
@@ -2315,26 +2295,6 @@
       "mode": 420,
       "origin": "kit"
     },
-    {
-      "path": ".claude/skills/zoom-out/SKILL.md",
-      "kind": "skill",
-      "ownerSkill": "zoom-out",
-      "surface": "claude",
-      "installRole": "consumer",
-      "sha256": "9e4fbb4e8c5d8cc847812b324db8e72aa716148bceb7d2d368e8bfda146fb84f",
-      "mode": 420,
-      "origin": "kit"
-    },
-    {
-      "path": ".claude/skills/zoom-out/THIRD-PARTY-NOTICES.md",
-      "kind": "skill",
-      "ownerSkill": "zoom-out",
-      "surface": "claude",
-      "installRole": "consumer",
-      "sha256": "87a6e3845e705204a009b26bab75f09e64d97f2d00e19ccd9ee1da39564dbc69",
-      "mode": 420,
-      "origin": "kit"
-    },
     {
       "path": "assets/memory-templates/meta_decision_layer_choice.md",
       "kind": "template",
@@ -2379,7 +2339,7 @@
       "path": "scripts/board_config.py",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "7fc5250de90ff87a11f169e05bc13b88fac1ef7765a447809ea546c6757bc637",
+      "sha256": "020b44d1df176d44d531e24bd7d01ead25182b287a0316239489475dfeb00aa3",
       "mode": 420,
       "origin": "kit"
     },
@@ -2395,7 +2355,7 @@
       "path": "scripts/board-sync.py",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "98e7d7a9dea198d0ea8bb3fc9f7d63a5cf621c3d263389c140f33e8bec16926c",
+      "sha256": "4cf206abfec87578863c99f11e00c99a2048f4f8776cbcb38a23c69e73e37c16",
       "mode": 493,
       "origin": "kit"
     },
@@ -2579,7 +2539,7 @@
       "path": "scripts/release-parity.mjs",
       "kind": "script",
       "installRole": "consumer",
-      "sha256": "faa4a1d1116d58f69c8541a586ebd6076ebc3f7af7809e9e4a53928f49298365",
+      "sha256": "32f61bf776974be63a017e90f428d4dab6098a9e2ba0c25c865d18ea3bd3e89e",
       "mode": 420,
       "origin": "kit"
     },

package/docs/agents/board-sync.md

@@ -61,6 +61,9 @@ The workflow board is [Agent Workflow Kit](https://github.com/users/iKon85/proje
   "headings": {
     "vorBau": "Clarify Before Build"
   },
+  "titles": {
+    "wavePrefix": "Welle"
+  },
   "wrapup": {
     "remoteBranchSweep": false
   }

package/docs/workflow.html

@@ -0,0 +1,259 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>agent-workflow-kit — Workflow</title>
+<style>
+  :root {
+    --page-bg: #F5F1E8;
+    --surface: #FAFAF7;
+    --ink: #1F2532;
+    --muted: #5B6579;
+    --border: #E8E4D8;
+    --accent-deep: #5C5630;
+
+    --plan:    #4A6280;  --plan-bg:    #DDE3EC;  --plan-text:    #2F4258;
+    --exec:    #5C7A4A;  --exec-bg:    #E8EDE0;  --exec-text:    #3D5230;
+    --land:    #C2902B;  --land-bg:    #F2E5C7;  --land-text:    #7A5B1D;
+    --learn:   #8A95A6;  --learn-bg:   #E8EBF0;  --learn-text:   #5B6579;
+    --gate:    #A8432D;  --gate-bg:    #F2DAD0;  --gate-text:    #6E2B1D;
+    --door:    #5B6579;  --door-bg:    #EFEDE4;  --door-text:    #454E60;
+  }
+  @media (prefers-color-scheme: dark) {
+    :root {
+      --page-bg:#1F2532; --surface:#2E3548; --ink:#F5F1E8; --muted:#A6B0BF;
+      --border:rgba(255,255,255,0.14); --accent-deep:#B5A86B;
+      --plan:#7C9BB2;  --plan-bg:#2E3850;  --plan-text:#8FA9C4;
+      --exec:#82A36C;  --exec-bg:#2A3A26;  --exec-text:#94B57E;
+      --land:#DBAC4F;  --land-bg:#3A3220;  --land-text:#DBAC4F;
+      --learn:#8A95A6; --learn-bg:#2A3142; --learn-text:#9CA6B5;
+      --gate:#D9554F;  --gate-bg:#3A2620;  --gate-text:#EC8780;
+      --door:#8A95A6;  --door-bg:#272E3E;  --door-text:#A6B0BF;
+    }
+  }
+  :root[data-theme="dark"] {
+    --page-bg:#1F2532; --surface:#2E3548; --ink:#F5F1E8; --muted:#A6B0BF;
+    --border:rgba(255,255,255,0.14); --accent-deep:#B5A86B;
+    --plan:#7C9BB2;  --plan-bg:#2E3850;  --plan-text:#8FA9C4;
+    --exec:#82A36C;  --exec-bg:#2A3A26;  --exec-text:#94B57E;
+    --land:#DBAC4F;  --land-bg:#3A3220;  --land-text:#DBAC4F;
+    --learn:#8A95A6; --learn-bg:#2A3142; --learn-text:#9CA6B5;
+    --gate:#D9554F;  --gate-bg:#3A2620;  --gate-text:#EC8780;
+    --door:#8A95A6;  --door-bg:#272E3E;  --door-text:#A6B0BF;
+  }
+  :root[data-theme="light"] {
+    --page-bg:#F5F1E8; --surface:#FAFAF7; --ink:#1F2532; --muted:#5B6579;
+    --border:#E8E4D8; --accent-deep:#5C5630;
+    --plan:#4A6280;  --plan-bg:#DDE3EC;  --plan-text:#2F4258;
+    --exec:#5C7A4A;  --exec-bg:#E8EDE0;  --exec-text:#3D5230;
+    --land:#C2902B;  --land-bg:#F2E5C7;  --land-text:#7A5B1D;
+    --learn:#8A95A6; --learn-bg:#E8EBF0; --learn-text:#5B6579;
+    --gate:#A8432D;  --gate-bg:#F2DAD0;  --gate-text:#6E2B1D;
+    --door:#5B6579;  --door-bg:#EFEDE4;  --door-text:#454E60;
+  }
+
+  * { box-sizing: border-box; }
+  body {
+    margin: 0; background: var(--page-bg); color: var(--ink);
+    font-family: Charter, "Bitstream Charter", "Iowan Old Style", Georgia, serif;
+    font-size: 17px; line-height: 1.6; overflow-x: hidden;
+  }
+  .wrap { max-width: 1010px; margin: 0 auto; padding: 40px 24px 80px; }
+  h1,h3 { font-family: system-ui, "Segoe UI", -apple-system, sans-serif; }
+  h1 { font-size: 1.9rem; font-weight: 650; letter-spacing: -0.015em; margin: 0 0 8px; text-wrap: balance; }
+  p  { margin: 0 0 1em; max-width: 72ch; }
+  a { color: var(--accent-deep); }
+  .eyebrow {
+    font-family: ui-monospace, Menlo, monospace; font-size: 0.72rem;
+    letter-spacing: 0.14em; text-transform: uppercase; color: var(--muted); margin-bottom: 12px;
+  }
+  .lede { color: var(--muted); font-size: 1.05rem; max-width: 66ch; }
+
+  .legend { display: flex; flex-wrap: wrap; gap: 8px 18px; margin: 18px 0 22px; }
+  .key { display: flex; align-items: center; gap: 7px; font-family: system-ui, sans-serif; font-size: 0.8rem; color: var(--muted); }
+  .dot { width: 11px; height: 11px; border-radius: 3px; background: var(--c); flex: none; }
+
+  .station {
+    font-family: ui-monospace, Menlo, monospace; font-size: 0.73rem;
+    background: var(--soft, var(--page-bg)); color: var(--sc, var(--ink));
+    border: 1px solid var(--border); border-radius: 5px; padding: 4px 8px; white-space: nowrap;
+  }
+  .station.plain { --soft: var(--page-bg); --sc: var(--muted); font-style: italic; }
+  .st-plan  { --soft: var(--plan-bg);  --sc: var(--plan-text);  border-color: color-mix(in srgb, var(--plan) 40%, var(--border)); }
+  .st-exec  { --soft: var(--exec-bg);  --sc: var(--exec-text);  border-color: color-mix(in srgb, var(--exec) 40%, var(--border)); }
+  .st-land  { --soft: var(--land-bg);  --sc: var(--land-text);  border-color: color-mix(in srgb, var(--land) 40%, var(--border)); }
+  .st-learn { --soft: var(--learn-bg); --sc: var(--learn-text); border-color: color-mix(in srgb, var(--learn) 40%, var(--border)); }
+  .st-gate  { --soft: var(--gate-bg);  --sc: var(--gate-text);  border-color: color-mix(in srgb, var(--gate) 50%, var(--border)); font-weight: 600; }
+  .st-door  { --soft: var(--door-bg);  --sc: var(--door-text);  border-color: color-mix(in srgb, var(--door) 40%, var(--border)); }
+  .arrow { color: var(--muted); font-family: system-ui, sans-serif; font-size: 0.85rem; padding: 0 2px; user-select: none; }
+  .decision { font-size: 0.76rem; color: var(--muted); font-style: italic; padding: 0 4px; }
+
+  .subway { display: grid; grid-template-columns: 158px 1fr; border: 1px solid var(--border);
+    border-radius: 8px; background: var(--surface); overflow: hidden; }
+  .sw-row { display: contents; }
+  .sw-label { padding: 14px 14px; border-bottom: 1px solid var(--border); border-right: 1px solid var(--border);
+    font-family: system-ui, sans-serif; font-size: 0.8rem; font-weight: 650; color: var(--lc, var(--muted));
+    display: flex; flex-direction: column; gap: 2px; justify-content: center; }
+  .sw-label small { font-weight: 400; color: var(--muted); font-size: 0.72rem; }
+  .sw-track { padding: 13px 16px; border-bottom: 1px solid var(--border); display: flex; flex-wrap: wrap;
+    align-items: center; gap: 7px 4px; background: linear-gradient(to right, color-mix(in srgb, var(--lbg, transparent) 45%, transparent), transparent 55%); }
+  .sw-row:last-of-type .sw-label, .sw-row:last-of-type .sw-track { border-bottom: none; }
+
+  .inter { grid-column: 1 / -1; padding: 12px 16px 14px; border-top: 1px dashed var(--border); }
+  .inter .i-title { font-family: system-ui, sans-serif; font-weight: 650; font-size: 0.82rem; color: var(--muted); margin-bottom: 8px; }
+  .inter .i-line { display: flex; flex-wrap: wrap; align-items: center; gap: 6px 4px; font-size: 0.85rem; color: var(--muted); margin-bottom: 7px; }
+  .inter .i-line:last-child { margin-bottom: 0; }
+
+  footer { margin-top: 28px; font-size: 0.85rem; color: var(--muted); font-family: system-ui, sans-serif; }
+
+  @media (max-width: 640px) {
+    .subway { grid-template-columns: 1fr; }
+    .sw-label { border-right: none; padding-bottom: 4px; }
+    .sw-track { border-bottom: 1px solid var(--border); }
+  }
+</style>
+</head>
+<body>
+<div class="wrap">
+  <div class="eyebrow">agent-workflow-kit · workflow</div>
+  <h1>One loop, many doors</h1>
+  <p class="lede">Every piece of work — idea, plan, backlog, bug — boards its own line, and every line converges on the same spine: <em>implement → wrapup → retro</em>. implement drives tdd internally — red → green → refactor at pre-agreed seams, code-review before landing.</p>
+
+  <div class="legend">
+    <span class="key"><span class="dot" style="--c: var(--door)"></span> Door / input</span>
+    <span class="key"><span class="dot" style="--c: var(--plan)"></span> Plan</span>
+    <span class="key"><span class="dot" style="--c: var(--exec)"></span> Execute</span>
+    <span class="key"><span class="dot" style="--c: var(--land)"></span> Land</span>
+    <span class="key"><span class="dot" style="--c: var(--learn)"></span> Learn</span>
+    <span class="key"><span class="dot" style="--c: var(--gate)"></span> Gate</span>
+  </div>
+
+  <div class="subway">
+    <div class="sw-row">
+      <div class="sw-label" style="--lc: var(--door-text); --lbg: var(--door-bg);">router<small>size unclear? start here</small></div>
+      <div class="sw-track" style="--lbg: var(--door-bg);">
+        <span class="station st-plan">scale-check</span>
+        <span class="decision">3–6 questions</span><span class="arrow">→</span>
+        <span class="station plain">Program → program line</span><span class="arrow">/</span>
+        <span class="station plain">Feature → main line</span><span class="arrow">/</span>
+        <span class="station plain">Direct-Slice → implement</span><span class="arrow">/</span>
+        <span class="station plain">Bug → repair line</span>
+      </div>
+    </div>
+    <div class="sw-row">
+      <div class="sw-label" style="--lc: var(--plan-text); --lbg: var(--plan-bg);">main line<small>idea → shipped</small></div>
+      <div class="sw-track" style="--lbg: var(--plan-bg);">
+        <span class="station plain">idea / plan / issue</span><span class="arrow">→</span>
+        <span class="station st-gate">grill? — see grill line</span><span class="arrow">→</span>
+        <span class="station st-plan">to-prd</span><span class="arrow">→</span>
+        <span class="station st-plan">to-issues</span><span class="arrow">→</span>
+        <span class="station st-gate">gate</span><span class="arrow">→</span>
+        <span class="station st-exec">implement</span>
+        <span class="decision">drives tdd inside</span><span class="arrow">→</span>
+        <span class="station st-land">wrapup</span><span class="arrow">→</span>
+        <span class="station st-learn">retro</span>
+      </div>
+    </div>
+    <div class="sw-row">
+      <div class="sw-label" style="--lc: var(--gate-text); --lbg: var(--gate-bg);">grill line<small>as deep as the stakes</small></div>
+      <div class="sw-track" style="--lbg: var(--gate-bg);">
+        <span class="station plain">mechanical change → none</span><span class="arrow">/</span>
+        <span class="station st-gate">grill-me</span>
+        <span class="decision">relentless interview, one question at a time</span><span class="arrow">/</span>
+        <span class="station st-gate">grill-with-docs</span>
+        <span class="decision">+ CONTEXT.md, ADRs updated inline</span><span class="arrow">/</span>
+        <span class="station st-gate">grill-me-codex · grill-with-docs-codex</span>
+        <span class="decision">+ Act 2: Codex reviews PLAN.md adversarially until APPROVED</span>
+      </div>
+    </div>
+    <div class="sw-row">
+      <div class="sw-label" style="--lc: var(--gate-text); --lbg: var(--gate-bg);">codex line<small>second model, high stakes</small></div>
+      <div class="sw-track" style="--lbg: var(--gate-bg);">
+        <span class="station st-gate">codex-review</span>
+        <span class="decision">plan already exists — cross-model review only</span><span class="arrow">·</span>
+        <span class="station st-exec">codex-build</span>
+        <span class="decision">Act 3: Codex implements the frozen spec, Claude verifies diff + proof</span>
+      </div>
+    </div>
+    <div class="sw-row">
+      <div class="sw-label" style="--lc: var(--plan-text); --lbg: var(--plan-bg);">program line<small>too big for one wave</small></div>
+      <div class="sw-track" style="--lbg: var(--plan-bg);">
+        <span class="station st-plan">scale-check</span><span class="arrow">→</span>
+        <span class="station st-gate">grill</span><span class="arrow">→</span>
+        <span class="station st-plan">to-waves</span>
+        <span class="decision">preview gate · zero board writes until yes</span><span class="arrow">→</span>
+        <span class="station st-exec">orchestrate-wave</span>
+        <span class="decision">per wave, often AFK</span><span class="arrow">→</span>
+        <span class="station st-land">wrapup</span><span class="arrow">→</span>
+        <span class="station st-learn">retro</span>
+      </div>
+    </div>
+    <div class="sw-row">
+      <div class="sw-label" style="--lc: var(--plan-text); --lbg: var(--plan-bg);">board line<small>it grew bottom-up</small></div>
+      <div class="sw-track" style="--lbg: var(--plan-bg);">
+        <span class="station plain">loose backlog</span><span class="arrow">→</span>
+        <span class="station st-plan">board-to-waves</span>
+        <span class="decision">wave-stub candidates, no number yet</span><span class="arrow">→</span>
+        <span class="station st-plan">to-prd</span>
+        <span class="decision">matures the stub</span><span class="arrow">→</span>
+        <span class="station st-plan">to-issues</span>
+        <span class="decision">≥2 slices → promotes to a numbered wave anchor</span><span class="arrow">→</span>
+        <span class="station plain">joins the program line</span>
+      </div>
+    </div>
+    <div class="sw-row">
+      <div class="sw-label" style="--lc: var(--gate-text); --lbg: var(--gate-bg);">repair line<small>something's broken</small></div>
+      <div class="sw-track" style="--lbg: var(--gate-bg);">
+        <span class="station plain">bug / anomaly</span><span class="arrow">→</span>
+        <span class="station st-door">diagnose</span>
+        <span class="decision">reproduce → isolate → fix → prove</span><span class="arrow">→</span>
+        <span class="station st-exec">implement</span><span class="arrow">→</span>
+        <span class="station st-land">wrapup</span>
+      </div>
+    </div>
+    <div class="sw-row">
+      <div class="sw-label" style="--lc: var(--exec-text); --lbg: var(--exec-bg);">structure line<small>code fights back</small></div>
+      <div class="sw-track" style="--lbg: var(--exec-bg);">
+        <span class="station plain">change fighting the codebase</span><span class="arrow">→</span>
+        <span class="station st-door">improve-codebase-architecture</span><span class="arrow">→</span>
+        <span class="station st-plan">to-issues</span>
+        <span class="decision">plan a slice — or refactor in place</span>
+      </div>
+    </div>
+    <div class="sw-row">
+      <div class="sw-label" style="--lc: var(--learn-text); --lbg: var(--learn-bg);">learn line<small>retro's real output</small></div>
+      <div class="sw-track" style="--lbg: var(--learn-bg);">
+        <span class="station st-learn">retro</span>
+        <span class="decision">user + agent friction, symmetric</span><span class="arrow">→</span>
+        <span class="station st-gate">CLAUDE.md rule</span><span class="arrow">/</span>
+        <span class="station st-land">spec-self-critique layer · ADR</span><span class="arrow">/</span>
+        <span class="station st-learn">memory</span><span class="arrow">/</span>
+        <span class="station st-plan">board issue</span>
+        <span class="decision">per-patch approval · Meta section in PR body</span>
+      </div>
+    </div>
+
+    <div class="inter">
+      <div class="i-title">Interchanges</div>
+      <div class="i-line">a slice hinging on an unknown inserts <span class="station st-gate">verify-spike / decision-gate</span> before its build</div>
+      <div class="i-line">unclear path inserts <span class="station st-exec">prototype</span> — throwaway that answers the design question first</div>
+      <div class="i-line">inside implement, <span class="station st-exec">tdd</span> runs red → green → refactor at pre-agreed seams</div>
+      <div class="i-line">before every PR, <span class="station st-land">local-ci</span> runs the full gate; the <span class="station st-gate">pre-commit / pre-push hooks</span> fire automatically once installed</div>
+      <div class="i-line">lost? <span class="station st-door">ask-matt</span> routes you to the right skill</div>
+      <div class="i-line">one-time setup, off-map: <span class="station st-door">setup-workflow</span> <span class="station st-door">git-guardrails</span> <span class="station st-door">setup-pre-commit</span></div>
+    </div>
+  </div>
+
+  <footer>
+    How waves, programs, and slices relate — the altitude model — lives on the
+    <a href="methodology.html">methodology page</a>.
+  </footer>
+</div>
+<script>
+  // Capture helper: ?theme=dark|light pins the palette for PNG rendering.
+  var t = new URLSearchParams(location.search).get("theme");
+  if (t === "dark" || t === "light") document.documentElement.dataset.theme = t;
+</script>
+</body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikon85/agent-workflow-kit",
-  "version": "0.26.2",
+  "version": "0.27.1",
   "description": "Portable AI-agent workflow skills (plan → execute → land → learn) for Claude Code & Codex — grilling, TDD, diagnosis, two-axis code review, cross-model Codex review, design & domain-modeling, plus a skill router (ask-matt). npx init/update/diff/uninstall.",
   "type": "module",
   "bin": {

package/scripts/board-sync.py

@@ -35,7 +35,7 @@ from typing import Optional
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 from board_config import (  # noqa: E402
     ConfigError, load_board_config, phase_field_id, program_type_label,
-    status_roles, STATUS_ROLE_KEYS,
+    status_roles, wave_title_prefix, STATUS_ROLE_KEYS,
 )
 # stamp-batch / field-value / promote-guards — pure logic, see module docstring.
 from board_fields import (  # noqa: E402
@@ -414,9 +414,14 @@ def promote_label_args(issue: int, strip: Optional[list[str]] = None) -> list[st
     return args
 
 
-# Existing `Welle <N> — ` prefix (any number, em-dash/en-dash/hyphen separator) —
-# replaced on re-promote so the wave number never doubles up.
-_WAVE_PREFIX_RE = re.compile(r"^\s*Welle\s+\d+\s*[—–-]\s*", re.IGNORECASE)
+# The wave-anchor title prefix word comes from the profile (`titles.wavePrefix`,
+# literal default "Welle" — see board_config.wave_title_prefix).
+WAVE_TITLE_PREFIX = wave_title_prefix(_CFG)
+# Existing `<prefix> <N> — ` prefix (any number, em-dash/en-dash/hyphen
+# separator) — replaced on re-promote so the wave number never doubles up.
+_WAVE_PREFIX_RE = re.compile(
+    rf"^\s*{re.escape(WAVE_TITLE_PREFIX)}\s+\d+\s*[—–-]\s*", re.IGNORECASE
+)
 # Leading conventional-commit token (`fix:`, `feat(ui):`, `chore!:`) — anchors
 # don't carry these, so strip it when present. Matches only a lowercase token,
 # so prose titles like "Supabase-Residuen entfernen: …" are left intact.
@@ -424,18 +429,18 @@ _CONVENTIONAL_PREFIX_RE = re.compile(r"^[a-z]+(\([^)]*\))?!?:\s*")
 
 
 def wave_title(current: str, wave: int) -> str:
-    """Title for a wave anchor: `Welle <N> — <Thema>`.
+    """Title for a wave anchor: `<prefix> <N> — <topic>`.
 
     Strips a leading conventional-commit prefix FIRST, then any existing
-    `Welle X — ` prefix underneath it (idempotent re-promote), then re-prefixes
-    with the given wave. Order matters: a title like `fix: Welle 7 — X` only
-    reveals its `Welle 7 — ` prefix once the conventional prefix is gone —
-    stripping Wave first leaves it intact and doubles up into
-    `Welle 29 — Welle 7 — X`.
+    `<prefix> X — ` prefix underneath it (idempotent re-promote), then
+    re-prefixes with the given wave. Order matters: a title like
+    `fix: <prefix> 7 — X` only reveals its wave prefix once the conventional
+    prefix is gone — stripping Wave first leaves it intact and doubles up into
+    `<prefix> 29 — <prefix> 7 — X`.
     """
     thema = _CONVENTIONAL_PREFIX_RE.sub("", current)
     thema = _WAVE_PREFIX_RE.sub("", thema).strip()
-    return f"Welle {wave} — {thema}"
+    return f"{WAVE_TITLE_PREFIX} {wave} — {thema}"
 
 
 def title_edit_args(issue: int, title: str) -> list[str]:
@@ -770,7 +775,7 @@ def cmd_promote(args) -> int:
     if args.dry_run:
         _print_dry(promote_label_args(args.issue))
         if rename:
-            print(f"[dry-run] gh issue edit {args.issue} --title 'Welle {args.wave} — <Thema>'")
+            print(f"[dry-run] gh issue edit {args.issue} --title '{WAVE_TITLE_PREFIX} {args.wave} — <topic>'")
         _add_and_stamp(url, args.wave, args.status, None, None, None, dry_run=True)
         return 0
     labels = _issue_type_labels(args.issue)
@@ -1158,7 +1163,7 @@ def build_parser() -> argparse.ArgumentParser:
                     help="explicit Wave (read `next-wave` first — no in-promote race)")
     _add_status_flags(pr)
     pr.add_argument("--no-rename", action="store_true",
-                    help="keep the title as-is (skip the `Welle <N> — ` prefix)")
+                    help="keep the title as-is (skip the wave title prefix)")
     pr.add_argument("--dry-run", action="store_true")
     pr.set_defaults(func=cmd_promote)
 

package/scripts/board_config.py

@@ -126,6 +126,13 @@ def program_type_label(cfg: dict) -> str:
     return cfg.get("labels", {}).get("programType", "type:program")
 
 
+def wave_title_prefix(cfg: dict) -> str:
+    """The `titles.wavePrefix` word that opens a wave anchor's title
+    (`<prefix> <N> — <topic>`), or the literal default `"Welle"` when the
+    profile hasn't set one — existing boards keep their titles unchanged."""
+    return cfg.get("titles", {}).get("wavePrefix", "Welle")
+
+
 # The semantic role keys of the workflow — schema, not
 # vocabulary; stable once shipped, extend additively, never rename. Single
 # home so CLI `choices`, docs, and future consumers reference one list.

package/scripts/release-parity.mjs

@@ -50,3 +50,37 @@ export function assertReleaseParity(identities) {
   }
   return identities.local;
 }
+
+// Consumer-side identity: an unpacked installation cannot be re-packed
+// byte-identically (npm normalizes at publish/unpack), so the installed copy
+// proves itself by content — never by a fresh tarball hash.
+const INSTALLED_FIELDS = ['name', 'version', 'manifestSha256'];
+
+export async function installedIdentityFromDir(kitRoot) {
+  const packageJson = JSON.parse(await readFile(`${kitRoot}/package.json`, 'utf8'));
+  const manifest = await readFile(`${kitRoot}/agent-workflow-kit.package.json`);
+  if (packageJson.version !== JSON.parse(manifest).kitVersion) {
+    throw new Error('installed package and manifest versions mismatch');
+  }
+  return {
+    name: packageJson.name,
+    version: packageJson.version,
+    manifestSha256: digest('sha256', manifest),
+  };
+}
+
+export function assertConsumerReleaseParity({ installed, npm, github }) {
+  validate('npm', npm);
+  validate('github', github);
+  for (const field of FIELDS) {
+    if (github[field] !== npm[field]) throw new Error(`github ${field} mismatch`);
+  }
+  if (!installed || typeof installed !== 'object') throw new Error('installed release identity missing');
+  for (const field of INSTALLED_FIELDS) {
+    if (typeof installed[field] !== 'string' || !installed[field]) {
+      throw new Error(`installed ${field} missing`);
+    }
+    if (installed[field] !== npm[field]) throw new Error(`installed ${field} mismatch`);
+  }
+  return npm;
+}

package/scripts/release-parity.test.mjs

@@ -51,3 +51,40 @@ test('a package tarball produces a deterministic content identity', async () =>
     assert.deepEqual(first, second);
   } finally { await rm(root, { recursive: true, force: true }); }
 });
+
+test('consumer parity proves npm↔github and matches the installed copy without re-packing', async () => {
+  const { assertConsumerReleaseParity } = await import('./release-parity.mjs');
+  const installed = { name: identity.name, version: identity.version, manifestSha256: identity.manifestSha256 };
+  assert.deepEqual(
+    assertConsumerReleaseParity({ installed, npm: { ...identity }, github: { ...identity } }),
+    identity,
+  );
+  assert.throws(() => assertConsumerReleaseParity({
+    installed, npm: { ...identity }, github: { ...identity, tarballIntegrity: 'different' },
+  }), /github tarballIntegrity mismatch/);
+  assert.throws(() => assertConsumerReleaseParity({
+    installed: { ...installed, manifestSha256: 'different' },
+    npm: { ...identity }, github: { ...identity },
+  }), /installed manifestSha256 mismatch/);
+  assert.throws(() => assertConsumerReleaseParity({
+    installed: { ...installed, version: '9.9.9' },
+    npm: { ...identity }, github: { ...identity },
+  }), /installed version mismatch/);
+});
+
+test('an installed kit directory yields a content identity without npm pack', async () => {
+  const { installedIdentityFromDir } = await import('./release-parity.mjs');
+  const root = await mkdtemp(join(tmpdir(), 'release-parity-installed-'));
+  try {
+    const manifest = JSON.stringify({ kitVersion: '1.2.3', files: [] });
+    await writeFile(join(root, 'package.json'), JSON.stringify({ name: identity.name, version: '1.2.3' }));
+    await writeFile(join(root, 'agent-workflow-kit.package.json'), manifest);
+    const installed = await installedIdentityFromDir(root);
+    assert.equal(installed.name, identity.name);
+    assert.equal(installed.version, '1.2.3');
+    assert.equal(typeof installed.manifestSha256, 'string');
+    assert.equal('tarballIntegrity' in installed, false);
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+});

package/scripts/test_board_sync_wave_title.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""Wave anchor titles take their prefix from the board profile, not a hardcoded
+German literal — an optional `titles.wavePrefix` key with the literal default
+`"Welle"` so every existing profile keeps working unchanged."""
+
+from __future__ import annotations
+
+import copy
+import importlib.util
+import json
+import os
+import tempfile
+import unittest
+from pathlib import Path
+
+
+BASE_PROFILE = {
+    "repo": "example/kit",
+    "project": {"number": 1, "owner": "example", "nodeId": "PVT_test"},
+    "fields": {
+        "status": {"id": "STATUS", "options": {}},
+        "wave": "WAVE",
+        "cluster": "CLUSTER",
+        "specPath": "SPEC",
+        "planPath": "PLAN",
+    },
+    "labels": {
+        "readyForAgent": "ready-for-agent",
+        "typePrefix": "type:",
+        "clusterType": "type:cluster",
+        "waveStub": "wave-stub",
+    },
+    "branchPrefixes": ["feat", "fix"],
+    "prMarkers": {"partOf": "Part of", "retroMarker": "Retro", "retroValues": []},
+    "headings": {"vorBau": "Clarify Before Build"},
+}
+
+
+def load_board_sync(profile_dict: dict, module_name: str):
+    with tempfile.NamedTemporaryFile("w", suffix=".md", delete=False) as profile:
+        profile.write("<!-- board-sync:profile -->\n```json\n")
+        json.dump(profile_dict, profile)
+        profile.write("\n```\n")
+        profile_path = profile.name
+    os.environ["BOARD_SYNC_PROFILE"] = profile_path
+    spec = importlib.util.spec_from_file_location(
+        module_name, Path(__file__).with_name("board-sync.py")
+    )
+    module = importlib.util.module_from_spec(spec)
+    assert spec.loader is not None
+    spec.loader.exec_module(module)
+    Path(profile_path).unlink()
+    return module
+
+
+class WaveTitleDefaultPrefix(unittest.TestCase):
+    """A profile without `titles.wavePrefix` keeps the historical `Welle` prefix."""
+
+    @classmethod
+    def setUpClass(cls):
+        cls.bs = load_board_sync(copy.deepcopy(BASE_PROFILE), "board_sync_wave_default")
+
+    def test_default_prefix_is_welle(self):
+        self.assertEqual(self.bs.wave_title("Auth hardening", 7), "Welle 7 — Auth hardening")
+
+    def test_repromote_is_idempotent(self):
+        self.assertEqual(
+            self.bs.wave_title("Welle 7 — Auth hardening", 9),
+            "Welle 9 — Auth hardening",
+        )
+
+    def test_conventional_prefix_stripped_before_wave(self):
+        self.assertEqual(
+            self.bs.wave_title("fix: Welle 7 — Auth hardening", 29),
+            "Welle 29 — Auth hardening",
+        )
+
+
+class WaveTitleProfilePrefix(unittest.TestCase):
+    """A profile with `titles.wavePrefix` drives the anchor title language."""
+
+    @classmethod
+    def setUpClass(cls):
+        profile = copy.deepcopy(BASE_PROFILE)
+        profile["titles"] = {"wavePrefix": "Wave"}
+        cls.bs = load_board_sync(profile, "board_sync_wave_custom")
+
+    def test_configured_prefix_is_used(self):
+        self.assertEqual(self.bs.wave_title("Auth hardening", 7), "Wave 7 — Auth hardening")
+
+    def test_repromote_is_idempotent_for_configured_prefix(self):
+        self.assertEqual(
+            self.bs.wave_title("Wave 7 — Auth hardening", 9),
+            "Wave 9 — Auth hardening",
+        )
+
+    def test_regex_metacharacters_in_prefix_are_literal(self):
+        profile = copy.deepcopy(BASE_PROFILE)
+        profile["titles"] = {"wavePrefix": "W+A"}
+        bs = load_board_sync(profile, "board_sync_wave_meta")
+        self.assertEqual(
+            bs.wave_title("W+A 3 — Auth hardening", 4),
+            "W+A 4 — Auth hardening",
+        )
+
+
+if __name__ == "__main__":
+    unittest.main()

package/scripts/test_skill_precommit_template.py

@@ -0,0 +1,30 @@
+#!/usr/bin/env python3
+"""The shipped pre-commit template must sanitize git's hook environment.
+
+Git exports GIT_DIR/GIT_INDEX_FILE to hooks; a consumer gate that runs a test
+suite whose child tests call git in their own temp repos would otherwise
+redirect those calls onto the host repo's index (PR #121's incident)."""
+
+from __future__ import annotations
+
+import unittest
+from pathlib import Path
+
+TEMPLATE = (
+    Path(__file__).resolve().parent.parent
+    / ".claude/skills/setup-pre-commit/scripts/pre-commit.template.sh"
+)
+
+
+class PreCommitTemplateSanitizesGitEnv(unittest.TestCase):
+    def test_template_unsets_git_env_before_gate(self):
+        text = TEMPLATE.read_text(encoding="utf-8")
+        unset_pos = text.find("unset GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE GIT_PREFIX")
+        gate_pos = text.find(">>> your gate commands here <<<")
+        self.assertGreater(unset_pos, -1, "template must unset git's exported hook env")
+        self.assertGreater(gate_pos, -1, "template must keep the gate marker")
+        self.assertLess(unset_pos, gate_pos, "sanitize must happen before the gate runs")
+
+
+if __name__ == "__main__":
+    unittest.main()

package/src/cli.mjs

@@ -7,6 +7,7 @@ import { update } from './commands/update.mjs';
 import { diff } from './commands/diff.mjs';
 import { uninstall } from './commands/uninstall.mjs';
 import { createCommandAdapter } from '../scripts/release-state.mjs';
+import { installedIdentityFromDir } from '../scripts/release-parity.mjs';
 
 const KIT_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 const consumerRoot = process.cwd();
@@ -87,8 +88,10 @@ async function readUpdateRelease() {
     env: { ...process.env, GH_REPO: 'iKon85/agent-workflow-kit' },
   });
   try {
-    const local = (await adapter.local()).identity;
-    return { local, npm: await adapter.npm(local), github: await adapter.github(local) };
+    // Re-packing an unpacked install is never byte-identical to the registry
+    // tarball — the installed copy proves itself by content identity instead.
+    const installed = await installedIdentityFromDir(KIT_ROOT);
+    return { installed, npm: await adapter.npm(installed), github: await adapter.github(installed) };
   } finally {
     await adapter.dispose();
   }

package/src/commands/update.mjs

@@ -1,6 +1,6 @@
 import { readFile, rm } from 'node:fs/promises';
 import { join } from 'node:path';
-import { assertReleaseParity } from '../../scripts/release-parity.mjs';
+import { assertConsumerReleaseParity } from '../../scripts/release-parity.mjs';
 import { activateCandidate, stageConsumer, verifyCandidate } from '../lib/updateCandidate.mjs';
 import { reconcile } from '../lib/updateReconcile.mjs';
 import {
@@ -86,7 +86,7 @@ async function applyTransaction(context) {
 }
 
 function verifyRelease(identities, kitVersion) {
-  const release = assertReleaseParity(identities);
+  const release = assertConsumerReleaseParity(identities);
   if (release.name !== RELEASE_NAME) throw new Error(`invalid release origin: ${release.name}`);
   if (release.version !== kitVersion) {
     throw new Error(`release version ${release.version} does not match kit ${kitVersion}`);

package/.agents/skills/zoom-out/SKILL.md

@@ -1,7 +0,0 @@
----
-name: zoom-out
-description: "Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture."
-disable-model-invocation: true
----
-
-I don't know this area of code well. Go up a layer of abstraction. Give me a map of all the relevant modules and callers, using the project's domain glossary vocabulary. (For a full refactor/deepening pass with an HTML report and grilling loop, use `improve-codebase-architecture` instead.)

package/.agents/skills/zoom-out/THIRD-PARTY-NOTICES.md

@@ -1,29 +0,0 @@
-# Third-Party Notices
-
-This skill is adapted from **Matt Pocock's skills**
-(https://github.com/mattpocock/skills), `skills/engineering/zoom-out` @ 2bf7005, Copyright (c) 2026 Matt Pocock,
-used under the MIT License. Locally adapted (fork-and-own); see PROVENANCE.md.
-
-```
-MIT License
-
-Copyright (c) 2026 Matt Pocock
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-```

package/.claude/skills/zoom-out/SKILL.md

@@ -1,7 +0,0 @@
----
-name: zoom-out
-description: Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
-disable-model-invocation: true
----
-
-I don't know this area of code well. Go up a layer of abstraction. Give me a map of all the relevant modules and callers, using the project's domain glossary vocabulary. (For a full refactor/deepening pass with an HTML report and grilling loop, use `improve-codebase-architecture` instead.)

package/.claude/skills/zoom-out/THIRD-PARTY-NOTICES.md

@@ -1,29 +0,0 @@
-# Third-Party Notices
-
-This skill is adapted from **Matt Pocock's skills**
-(https://github.com/mattpocock/skills), `skills/engineering/zoom-out` @ 2bf7005, Copyright (c) 2026 Matt Pocock,
-used under the MIT License. Locally adapted (fork-and-own); see PROVENANCE.md.
-
-```
-MIT License
-
-Copyright (c) 2026 Matt Pocock
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-```