@ikon85/agent-workflow-kit 0.30.0 → 0.31.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/.agents/skills/board-to-waves/SKILL.md +14 -0
  2. package/.agents/skills/code-review/SKILL.md +22 -3
  3. package/.agents/skills/kit-update/SKILL.md +21 -1
  4. package/.agents/skills/local-ci/SKILL.md +16 -0
  5. package/.agents/skills/project-release/SKILL.md +18 -0
  6. package/.agents/skills/security-audit/SKILL.md +18 -0
  7. package/.agents/skills/setup-workflow/SKILL.md +39 -2
  8. package/.agents/skills/spec-self-critique/SKILL.md +16 -7
  9. package/.agents/skills/to-issues/SKILL.md +13 -1
  10. package/.agents/skills/to-prd/SKILL.md +14 -0
  11. package/.agents/skills/to-waves/SKILL.md +16 -2
  12. package/.agents/skills/triage/SKILL.md +24 -0
  13. package/.agents/skills/verify-spike/SKILL.md +20 -1
  14. package/.agents/skills/wrapup/SKILL.md +26 -4
  15. package/.claude/skills/board-to-waves/SKILL.md +14 -0
  16. package/.claude/skills/code-review/SKILL.md +22 -3
  17. package/.claude/skills/kit-update/SKILL.md +21 -1
  18. package/.claude/skills/local-ci/SKILL.md +16 -0
  19. package/.claude/skills/project-release/SKILL.md +18 -0
  20. package/.claude/skills/security-audit/SKILL.md +18 -0
  21. package/.claude/skills/setup-workflow/SKILL.md +39 -2
  22. package/.claude/skills/spec-self-critique/SKILL.md +16 -7
  23. package/.claude/skills/to-issues/SKILL.md +13 -1
  24. package/.claude/skills/to-prd/SKILL.md +14 -0
  25. package/.claude/skills/to-waves/SKILL.md +16 -2
  26. package/.claude/skills/triage/SKILL.md +24 -0
  27. package/.claude/skills/verify-spike/SKILL.md +20 -1
  28. package/.claude/skills/wrapup/SKILL.md +26 -4
  29. package/README.md +32 -0
  30. package/agent-workflow-kit.package.json +30 -30
  31. package/package.json +1 -1
  32. package/scripts/kit-update-pr.mjs +14 -1
  33. package/scripts/kit-update-pr.test.mjs +21 -0
  34. package/scripts/test_retro_wrapup_contract.py +17 -0
  35. package/scripts/test_skill_optional_readiness.py +171 -0
  36. package/scripts/test_skill_readiness_preflight.py +180 -0
  37. package/scripts/test_skill_required_readiness.py +233 -0
  38. package/scripts/test_skill_setup_workflow_seeds.py +22 -0
  39. package/src/cli.mjs +10 -2
  40. package/src/commands/update.mjs +65 -8
  41. package/src/lib/updateCandidate.mjs +116 -2
@@ -9,6 +9,24 @@ Prepare a consumer-owned multi-package release through the kit's shared
9
9
  SemVer, preview, and transactional apply engine. This skill changes only the
10
10
  profiled version files. It does not commit, tag, push, publish, or merge.
11
11
 
12
+ ## Required readiness preflight
13
+
14
+ Before previewing a release or changing any version file, run:
15
+
16
+ ```sh
17
+ node scripts/readiness.mjs check --skill project-release --json
18
+ ```
19
+
20
+ Treat the result as authoritative. A `ready` verdict is silent and hands
21
+ execution to `scripts/project-release.mjs`; the helper remains the authority
22
+ for preview, confirmation, validation, and transactional apply. For a
23
+ `blocked` verdict, stop without invoking that helper or changing files and
24
+ report `Project Release unavailable`, the `projectReleaseProfile` state
25
+ (`missing`, `pending`, `not-applicable`, or `invalid`), and one recovery path:
26
+ run `/setup-workflow`, then fill the `projectRelease` section in
27
+ `docs/agents/workflow-capabilities.json`. Never infer packages, version files,
28
+ tag prefixes, or versions.
29
+
12
30
  ## Profile contract
13
31
 
14
32
  Read `docs/agents/workflow-capabilities.json`. The consumer owns this file and
@@ -13,6 +13,24 @@ generic runbook structure ships as a template you copy and fill:
13
13
  your actual stack, and keep it as the checklist single source of truth. Read your
14
14
  filled runbook first.
15
15
 
16
+ ## Required readiness preflight
17
+
18
+ Before reading application code, creating a tracking issue, launching either
19
+ model, or writing audit scratch files, run:
20
+
21
+ ```sh
22
+ node scripts/readiness.mjs check --skill security-audit --json
23
+ ```
24
+
25
+ Treat the result as authoritative. A `ready` verdict is silent: continue with
26
+ the existing two-model procedure and all human approval gates. For a `blocked`
27
+ verdict, stop without starting an audit or mutating repository or remote state
28
+ and report `Security Audit unavailable`, the `securityAuditRunbook` state
29
+ (`missing`, `pending`, `not-applicable`, or `invalid`), and one recovery path:
30
+ run `/setup-workflow`, then fill `docs/agents/skills/security-audit.md` and the
31
+ project runbook it references. Never guess the stack, security scope, commands,
32
+ tracking anchor, or board wiring.
33
+
16
34
  **Scope guard:** code + config only. Infrastructure (firewall, exposed ports,
17
35
  TLS, SSH, backups) is audited **separately** — an exposed database port beats any
18
36
  code fix. Keep the two audits apart.
@@ -331,7 +331,36 @@ Seed `## Workflow` from [workflow-overview.md](./workflow-overview.md) when the
331
331
 
332
332
  > `wrapup` and live-verify reference where this project deploys (host, command, URL). It lives in the `## Prod` block of CLAUDE.md/AGENTS.md, not a separate file.
333
333
 
334
- Ask for the deploy target in plain terms (where does this ship, how is it deployed, what's the live URL?). Record it for the `## Prod` block (Write step). If the user has no deploy target, skip — do not invent one.
334
+ First run `node scripts/readiness.mjs check --skill wrapup --json`. If
335
+ `prodTarget` is `ready`, adopt the evidence, clear any superseded pending
336
+ decision with `node scripts/readiness.mjs decision clear prodTarget`, and do
337
+ not ask again. Malformed or divergent `## Prod` evidence is `invalid`: leave
338
+ all instruction files untouched, show the conflict, and stop this section
339
+ until the user resolves it.
340
+
341
+ For a missing or pending target, ask where this ships, how it is deployed, and
342
+ what the live URL is. Offer only the bounded choices permitted by the readiness
343
+ catalog:
344
+
345
+ - **Configure now** — collect a non-empty host/platform, deploy command or
346
+ trigger, and live URL. Preview the exact local `## Prod` replacement for
347
+ every applicable existing Claude/Codex instruction surface and obtain
348
+ approval before writing it. Any external mutation retains its own separate
349
+ preview and approval; approving the local block never approves repository,
350
+ hosting, DNS, or deployment changes.
351
+ - **Configure later** — run
352
+ `node scripts/readiness.mjs decision set prodTarget pending`; create or alter
353
+ no `## Prod` block, and report exactly:
354
+ `wrapup.deployReport omitted (prodTarget pending)`.
355
+ - **Not applicable** — offer only when the manifest catalog entry has
356
+ `allowNotApplicable: true`; record it with `readiness.mjs decision set` and
357
+ deactivate the dependent block (or the whole skill when the declaration
358
+ requires the capability). `prodTarget` does not permit this choice, so never
359
+ offer it for Prod.
360
+
361
+ Ready and terminal `not-applicable` choices are not re-asked. A pending choice
362
+ remains deliberately retryable so a later `setup-workflow` run can take the
363
+ Configure-now path. Never invent a deploy target.
335
364
 
336
365
  ### 8b. Section H — Size-Profil (optional LoC-offender gate, non-interactive)
337
366
 
@@ -391,6 +420,14 @@ For the **`## Workflow`**, **`## Agent skills`**, and **`## Prod`** blocks, reco
391
420
  - If **neither** exists → ask the user which surface(s) to create (**default `CLAUDE.md`**), then write there.
392
421
  - If a `## Workflow` block already exists → skip it; this block is often repo-specific.
393
422
  - If an `## Agent skills` / `## Prod` block already exists → update its contents in-place; never duplicate or clobber surrounding user content.
423
+ - For Configure now, apply the approved `## Prod` preview to every applicable
424
+ existing surface as one coherent local change. Preserve each file's
425
+ `## Workflow` and `## Agent skills` blocks byte-for-byte, including spacing,
426
+ and leave all unrelated setup blocks untouched. Re-read every written Prod
427
+ body and run `node scripts/readiness.mjs check --skill wrapup --json`; all
428
+ surfaces must agree and `activeBlocks` must be exactly `["deployReport"]`.
429
+ Only then clear a prior `prodTarget` decision. A partial write is not ready:
430
+ restore the previewed surface set before reporting the section complete.
394
431
 
395
432
  `## Workflow` block:
396
433
 
@@ -411,7 +448,7 @@ Use [workflow-overview.md](./workflow-overview.md) verbatim as the generic seed.
411
448
  [one-line summary — single- or multi-context]. See `docs/agents/domain.md`.
412
449
  ```
413
450
 
414
- `## Prod` block (only if Section F produced a deploy target):
451
+ `## Prod` block (only if Section G's Configure-now path produced a deploy target):
415
452
 
416
453
  ```markdown
417
454
  ## Prod
@@ -11,15 +11,24 @@ A portable, structural self-review pass over a freshly written spec/plan. The **
11
11
 
12
12
  - After a spec was written/edited (a `SPEC.md` / `PLAN.md`, or a spec/design doc), BEFORE the user-review gate.
13
13
 
14
- ## Step 0Project-layer probe
14
+ ## Readiness preflightfirst
15
15
 
16
- First, check whether a project layer exists: from the project root, look for `docs/agents/skills/spec-self-critique.md`.
16
+ <!-- readiness:optional-preflight:start -->
17
+ Before any other step, run this once from the project root:
17
18
 
18
- - **Present** → **full pass**: run the 12 generic checks AND apply the per-point enrichment that file defines (incidents, grep patterns, extra sub-checks).
19
- - **Absent** **base pass**: run the 12 generic checks only, then add this one-line warning to the summary:
20
- > ⚠ No project layer found (`docs/agents/skills/spec-self-critique.md`) — only the generic base checks ran. `/setup-workflow` creates the layer; it fills in project-specific content via `/retro`.
19
+ ```bash
20
+ node scripts/readiness.mjs check --skill spec-self-critique --json
21
+ ```
22
+
23
+ - `ready`: continue without a readiness message. Ready is silent.
24
+ - `degraded`: keep the generic 12-point critique active, omit only the inactive block `projectEnrichment`, and emit exactly one concise summary: `Readiness degraded — inactive block projectEnrichment (specCritiqueLayer: <state>). Run /setup-workflow, configure docs/agents/skills/spec-self-critique.md, then rerun this skill.`
25
+ - `blocked`: stop before continuing and report the non-ready required capability plus the exact `/setup-workflow` recovery path.
26
+ - Invalid is always visible: include the `invalid` capability state in the single summary and never treat it as an opt-out. Do not emit separate warnings later in the workflow.
27
+ <!-- readiness:optional-preflight:end -->
21
28
 
22
- > **Routing keep this skeleton clean.** Project-specific checks, incidents, and grep patterns belong in the project layer (`docs/agents/skills/spec-self-critique.md`), **NOT here**. `/retro` appends new project-specific lore to the project layer, never into this generic skeleton.
29
+ <!-- readiness:block projectEnrichment -->
30
+ When `projectEnrichment` is active, read `docs/agents/skills/spec-self-critique.md` and apply its per-point enrichment, including project-specific incidents, grep patterns, conventions, and extra sub-checks. Project-specific checks belong in that layer, **not here**; `/retro` appends new project-specific lore there rather than into this generic skeleton.
31
+ <!-- readiness:end -->
23
32
 
24
33
  ## Altitude — a portable kit concept
25
34
 
@@ -63,7 +72,7 @@ Self-Critique complete — <N> corrections:
63
72
  - ...
64
73
  ```
65
74
 
66
- or, if none were needed: `Self-Critique complete — no corrections needed.` (append the Step-0 layer-absent warning if it applied). THEN ask the user-review question.
75
+ or, if none were needed: `Self-Critique complete — no corrections needed.` THEN ask the user-review question.
67
76
 
68
77
  ## The 12-point checklist
69
78
 
@@ -9,7 +9,19 @@ description: Break a plan, spec, or PRD into independently-grabbable issues on t
9
9
 
10
10
  Break a plan into independently-grabbable issues using vertical slices (tracer bullets).
11
11
 
12
- The issue tracker and triage label vocabulary should have been provided to you — run `/setup-workflow` if not.
12
+ <!-- readiness:required-preflight:start -->
13
+ ## 0. Required readiness preflight
14
+
15
+ This is the first executable workflow step. From the project root, before any remote write or other `gh`/`board-sync.py` command, run this read-only check:
16
+
17
+ ```bash
18
+ node scripts/readiness.mjs check --skill to-issues --json
19
+ ```
20
+
21
+ - `verdict=ready`: continue with the existing workflow without announcing the check. **Ready is silent.**
22
+ - `verdict=blocked`: `STOP` before any mutation. Report every required capability as `<capability>=<state>` so `issueTracker`, `managedBoard`, and `specCompleteness` failures — including distinct `missing`, `pending`, and `invalid` states — stay visible, then give exactly one recovery path: **Run `/setup-workflow`, then rerun `/to-issues`.** Do not fall back to bare tracker or board commands.
23
+ - `managedBoard=not-applicable`: `STOP` and report that `/to-issues` is **inapplicable** for a project that deliberately has no managed board. This is a terminal project decision, not invalid evidence and not a partially active mode.
24
+ <!-- readiness:required-preflight:end -->
13
25
 
14
26
  ## Process
15
27
 
@@ -10,6 +10,20 @@ description: "Turn a locked plan (PLAN.md in the worktree, conversation context,
10
10
 
11
11
  Takes an **already-locked plan** and publishes it as a **Draft-PRD issue**. **Never invents requirements** — only synthesizes what's already decided. Pipeline: `board-to-waves → grill(-with-docs) → to-prd → to-issues`. The **grill sits upstream**; to-prd writes the PRD after the grill. **Slicing + promotion to an anchor (cluster/Wave, child link) = `to-issues`** (future), not here.
12
12
 
13
+ <!-- readiness:required-preflight:start -->
14
+ ## 0. Required readiness preflight
15
+
16
+ This is the first executable workflow step. From the project root, before any remote write or other `gh`/`board-sync.py` command, run this read-only check:
17
+
18
+ ```bash
19
+ node scripts/readiness.mjs check --skill to-prd --json
20
+ ```
21
+
22
+ - `verdict=ready`: continue with the existing workflow without announcing the check. **Ready is silent.**
23
+ - `verdict=blocked`: `STOP` before any mutation. Report every required capability as `<capability>=<state>` so `missing`, `pending`, and `invalid` remain distinct, then give exactly one recovery path: **Run `/setup-workflow`, then rerun `/to-prd`.** Do not fall back to bare tracker or board commands.
24
+ - `managedBoard=not-applicable`: `STOP` and report that `/to-prd` is **inapplicable** for a project that deliberately has no managed board. This is a terminal project decision, not invalid evidence and not a partially active mode.
25
+ <!-- readiness:required-preflight:end -->
26
+
13
27
  Board constants (project node, field/status IDs) + helpers live **consumer-side**: read `docs/agents/board-sync.md` from the project root + use the helper `scripts/board-sync.py` (missing → `/setup-workflow` scaffolds the project layer). Issue body **always** via `--body-file` (inline `--body` with backticks/parens crashes bash).
14
28
 
15
29
  ## 1. Input — source-agnostic
@@ -14,6 +14,20 @@ Takes a **Program-PRD** — the native Sub-Issue anchor over a multi-wave progra
14
14
  The **grill and to-prd sit upstream**; to-waves runs once the Program-PRD exists.
15
15
  It **never invents structure** — it only unfolds what the plan already decided.
16
16
 
17
+ <!-- readiness:required-preflight:start -->
18
+ ## 0. Required readiness preflight
19
+
20
+ This is the first executable workflow step. From the project root, before any remote write or other `gh`/`board-sync.py` command, run this read-only check:
21
+
22
+ ```bash
23
+ node scripts/readiness.mjs check --skill to-waves --json
24
+ ```
25
+
26
+ - `verdict=ready`: continue with the existing workflow without announcing the check. **Ready is silent.**
27
+ - `verdict=blocked`: `STOP` before any mutation. Report every required capability as `<capability>=<state>` so `issueTracker`, `managedBoard`, and `specCompleteness` failures — including distinct `missing`, `pending`, and `invalid` states — stay visible, then give exactly one recovery path: **Run `/setup-workflow`, then rerun `/to-waves`.** Do not fall back to bare tracker or board commands.
28
+ - `managedBoard=not-applicable`: `STOP` and report that `/to-waves` is **inapplicable** for a project that deliberately has no managed board. This is a terminal project decision, not invalid evidence and not a partially active mode.
29
+ <!-- readiness:required-preflight:end -->
30
+
17
31
  Board constants (project node, field/status IDs) + helpers live **consumer-side**:
18
32
  read `docs/agents/board-sync.md` from the project root + use the helper
19
33
  `scripts/board-sync.py` (missing → `/setup-workflow` scaffolds the project layer).
@@ -36,8 +50,8 @@ target, an anchor is already a single wave.
36
50
 
37
51
  ## 2. Parse + validate — the graph preflight
38
52
 
39
- Run the graph preflight first it is **read-only** (a single board read, zero
40
- mutations):
53
+ After the required readiness preflight, run the graph preflight before preview or
54
+ publication — it is **read-only** (a single board read, zero mutations):
41
55
 
42
56
  ```bash
43
57
  python3 scripts/board-sync.py validate-graph --issue <prd#>
@@ -14,6 +14,30 @@ Every comment or issue posted to the issue tracker during triage **must** start
14
14
  > *This was generated by AI during triage.*
15
15
  ```
16
16
 
17
+ ## Required readiness preflight
18
+
19
+ Before reading from or writing to the issue tracker, labels, or board, run:
20
+
21
+ ```sh
22
+ node scripts/readiness.mjs check --skill triage --json
23
+ ```
24
+
25
+ Treat the result as authoritative. A `ready` verdict is silent: continue with
26
+ the existing triage flow and all of its confirmation gates. For a `blocked`
27
+ verdict, stop without querying or mutating the issue tracker and report
28
+ `Triage unavailable`, the exact state (`missing`, `pending`, `not-applicable`,
29
+ or `invalid`), and the matching recovery path:
30
+
31
+ - `issueTracker` → run `/setup-workflow`, then fill
32
+ `docs/agents/issue-tracker.md`.
33
+ - `managedBoard` → run `/setup-workflow`, then configure
34
+ `docs/agents/board-sync.md`; `not-applicable` means this board-driven skill is
35
+ unavailable, not partially usable.
36
+ - `triageLabels` → run `/setup-workflow`, then fill
37
+ `docs/agents/triage-labels.md`.
38
+
39
+ Never guess a tracker, label, board, field, status, or fallback workflow.
40
+
17
41
  ## Reference docs
18
42
 
19
43
  - [AGENT-BRIEF.md](AGENT-BRIEF.md) — how to write durable agent briefs
@@ -21,10 +21,29 @@ This is the "Verify First" rule with a runnable harness behind it: when you cann
21
21
 
22
22
  If the question is really "what should this be", it is not a verify-spike — those are open, not yes/no.
23
23
 
24
+ ## Readiness preflight — first
25
+
26
+ <!-- readiness:optional-preflight:start -->
27
+ Before framing or running the spike, run this once from the project root:
28
+
29
+ ```bash
30
+ node scripts/readiness.mjs check --skill verify-spike --json
31
+ ```
32
+
33
+ - `ready`: continue without a readiness message. Ready is silent.
34
+ - `degraded`: keep the generic empirical spike active, omit only the inactive block `projectPlacement`, and emit exactly one concise summary: `Readiness degraded — inactive block projectPlacement (verifySpikeLayer: <state>). Run /setup-workflow, configure docs/agents/skills/verify-spike.md, then rerun this skill.`
35
+ - `blocked`: stop before continuing and report the non-ready required capability plus the exact `/setup-workflow` recovery path.
36
+ - Invalid is always visible: include the `invalid` capability state in the single summary and never treat it as an opt-out. Do not emit separate warnings later in the workflow.
37
+ <!-- readiness:optional-preflight:end -->
38
+
39
+ <!-- readiness:block projectPlacement -->
40
+ When `projectPlacement` is active, read `docs/agents/skills/verify-spike.md` and follow its project-specific harness-placement and import rules.
41
+ <!-- readiness:end -->
42
+
24
43
  ## Steps
25
44
 
26
45
  1. **Frame one falsifiable question.** Write it down as a single sentence with a yes/no answer and the exact version/context it is scoped to — e.g. "Does `customType.mapFromDriverValue` run on `drizzle-orm@1.0.0-rc.3` + node-postgres?". Name what a YES vs a NO looks like in the output *before* you run anything.
27
- 2. **Build the smallest harness that forces the answer.** Borrow the feedback-loop toolkit from `diagnose` Phase 1 — a one-call throwaway script, a fixture replay, a tiny HTTP/curl probe, a headless-browser assertion. Pick the cheapest one that touches the real thing (real lib version, real runtime, the actual DB read). One command to run; locate it in a clearly-throwaway path (`scratch/`, `*.spike.ts`). If a project layer exists at `docs/agents/skills/verify-spike.md`, follow its harness-placement/import rules — some repos need spikes inside a package dir so real imports resolve.
46
+ 2. **Build the smallest harness that forces the answer.** Borrow the feedback-loop toolkit from `diagnose` Phase 1 — a one-call throwaway script, a fixture replay, a tiny HTTP/curl probe, a headless-browser assertion. Pick the cheapest one that touches the real thing (real lib version, real runtime, the actual DB read). One command to run; locate it in a clearly-throwaway path (`scratch/`, `*.spike.ts`).
28
47
  3. **Run it and capture the proof.** Keep the raw output — the value, the error, the stack, the HTTP status. The verdict is only as good as the evidence pasted under it.
29
48
  4. **Record the verdict durably, with its evidence inline.** Yes/No + the proof (output snippet / `file:line` / version) + the date + the scope it was checked at. Sink it where the decision lives: an ADR, the issue body, the plan, or a PR comment. A verdict without inline evidence is just an unverified claim — keep the proof attached so a later reader does not have to re-run the spike to trust it.
30
49
  5. **Delete the harness.** The *answer* is the only keeper. Remove the spike code (or fold the proven fact into real code) so nothing throwaway rots in the repo.
@@ -3,7 +3,7 @@ name: wrapup
3
3
  disable-model-invocation: true
4
4
  description: >-
5
5
  Use ONLY when the user types /wrapup. Session-end "land & clean" for a
6
- finished feature/fix worktree — merges the open PR (= triggers prod deploy),
6
+ finished feature/fix worktree — merges the open PR,
7
7
  kills the worktree dev server, removes the worktree + local branch, and
8
8
  fast-forwards the main checkout so main is current again, then sweeps
9
9
  merged-branch leftovers (local + stale remote whose PR is merged). If the
@@ -20,7 +20,11 @@ Trigger: user types `/wrapup` (optionally with a PR number). **Manual only** —
20
20
 
21
21
  ## ⚠ Spec context
22
22
 
23
- **Merging to `main` = prod deploy.** The agent never deploys on its own — the user's `/wrapup` input IS the explicit merge+deploy authorization for that run. Never call this skill from a hook, another skill, or autonomously. Deploy banner before the merge, no y/n confirmation (deliberate); the pre-flight hard stops are non-negotiable.
23
+ The user's `/wrapup` input IS the explicit landing authorization for that run.
24
+ It authorizes the normal merge flow whether Prod readiness is ready or degraded;
25
+ it never authorizes the agent to invent or configure a deploy target. Never call
26
+ this skill from a hook, another skill, or autonomously. There is no second merge
27
+ confirmation; the pre-flight hard stops are non-negotiable.
24
28
 
25
29
  ## Execution model — script does mechanics, the agent does judgment
26
30
 
@@ -37,6 +41,17 @@ python3 scripts/wrapup-land.py preflight
37
41
  ```
38
42
  Hard stop (the only pure precondition): not in a feature worktree / on `main` — the script exits 1. The report carries everything the later steps need: dirty files, `.env` hits, secret-grep hits, issue + parent (leaf vs. anchor slice), existing PR + whether its body has a `**Retro:**` line, parsed `ANNAHMEN.md` drift lines, profile values (`retro_values`, `vor_bau`, remote-sweep switch).
39
43
 
44
+ Then run:
45
+
46
+ ```bash
47
+ node scripts/readiness.mjs check --skill wrapup --json
48
+ ```
49
+
50
+ `prodTarget: ready` activates only `deployReport` below. `pending` or `missing`
51
+ omits that block, emits exactly one concise note — `Prod readiness is pending or missing; deploy reporting omitted.` — and landing continues normally.
52
+ `invalid` means malformed or divergent Prod evidence: STOP and report the
53
+ conflicting instruction surfaces; never choose a target on the user's behalf.
54
+
40
55
  ### 2 · Retro gate (blocking, optional retro-exit — before anything is committed)
41
56
  One reminder, not a merge confirmation:
42
57
  > "Already ran a retro? **(a)** yes / continue → landing now. **(b)** you want one first → the retro starts now; afterwards, invoke `/wrapup` again — repo-file patches then travel in this PR."
@@ -82,10 +97,17 @@ One call covers: push → PR create/reuse (+ drift markers merged into the body)
82
97
  STOP → diagnose in the main conversation, fix, re-run `land` (an already-merged PR resumes at teardown).
83
98
 
84
99
  ### 6 · Post-merge (agent)
85
- - **Deploy banner**, one line: `⚠ PR #<pr> merged → main deploys (~7 min live).`
86
100
  - **Sibling propagation:** for each `drift_markers` entry in the land report, append the note to the target issue's `vor_bau` section + re-stamp its `plan_revision`. Log-based markers → **write directly, then show what was written where** (mandatory report — visibility moved from a pre-gate into the report, decision 2026-07-06); fallback candidates the user hasn't confirmed yet → confirm first. Program context widens the target set to unbuilt wave-stubs/leaves and the Program-PRD itself — same append-only mechanism. **Exception:** appends to the Program-PRD or unbuilt wave-stubs do **not** re-stamp `plan_revision` — that stays reserved for structural wave-plan edits via the `to-waves` escalation path; a mere drift note must not stale-block published stubs.
87
101
  - **Anchor close:** report says `anchor_complete: true` → `gh issue close <anchor> -c "Wave complete — all slices merged via PR #<pr>."` and verify board status Done. The guard keeps anchors away from every auto-close — this verified close is the only close path; without it the anchor stays silently open after the last slice. **Then re-run the upward propagation**: the land-time `program-sync` ran BEFORE this close, so on a wave-completing slice the Wellenplan still shows 🔄 and the Phasen-Gate stays unchecked — after the board shows Done, run `python3 scripts/board-sync.py program-sync <program-prd#>` once more (the report's `program_sync.program` names it; skip when the report says the parent is not a program). Board auto-rules can lag the close (Close→Done race) — verify Done first, that's what the token reads.
88
- - **Report**, concise, from the land JSON: PR merged · issue close (auto/manual) · worktree removed · branch deleted · sweep counts local/remote · anchor synced + complete/pending · program propagation (`program_sync`: Wellenplan refreshed / gates checked / skipped) · propagation writes (what → where) · `main` at `<sha>` · deploy running.
102
+ - **Report**, concise, from the land JSON: PR merged · issue close (auto/manual) · worktree removed · branch deleted · sweep counts local/remote · anchor synced + complete/pending · program propagation (`program_sync`: Wellenplan refreshed / gates checked / skipped) · propagation writes (what → where) · `main` at `<sha>`.
103
+
104
+ <!-- readiness:block deployReport -->
105
+ - **Deploy-aware report:** read the coherent `## Prod` block; before merging,
106
+ state the configured deploy trigger and expected outcome. After merge, report
107
+ the configured target and its actual known state. Do not claim a deployment
108
+ is running or live unless the configured trigger and observed evidence prove
109
+ it; keep unknown timing explicit.
110
+ <!-- readiness:end -->
89
111
 
90
112
  ## Out of scope
91
113
  - Live-verify / DoD: must happen **before** `/wrapup` — this skill lands, it does not verify.
package/README.md CHANGED
@@ -348,6 +348,38 @@ concurrency-safe. Do not run manifest-mutating commands concurrently. Flags:
348
348
 
349
349
  ## Release notes
350
350
 
351
+ ### 0.31.0
352
+
353
+ - changed: `.agents/skills/board-to-waves/SKILL.md`
354
+ - changed: `.agents/skills/code-review/SKILL.md`
355
+ - changed: `.agents/skills/kit-update/SKILL.md`
356
+ - changed: `.agents/skills/local-ci/SKILL.md`
357
+ - changed: `.agents/skills/project-release/SKILL.md`
358
+ - changed: `.agents/skills/security-audit/SKILL.md`
359
+ - changed: `.agents/skills/setup-workflow/SKILL.md`
360
+ - changed: `.agents/skills/spec-self-critique/SKILL.md`
361
+ - changed: `.agents/skills/to-issues/SKILL.md`
362
+ - changed: `.agents/skills/to-prd/SKILL.md`
363
+ - changed: `.agents/skills/to-waves/SKILL.md`
364
+ - changed: `.agents/skills/triage/SKILL.md`
365
+ - changed: `.agents/skills/verify-spike/SKILL.md`
366
+ - changed: `.agents/skills/wrapup/SKILL.md`
367
+ - changed: `.claude/skills/board-to-waves/SKILL.md`
368
+ - changed: `.claude/skills/code-review/SKILL.md`
369
+ - changed: `.claude/skills/kit-update/SKILL.md`
370
+ - changed: `.claude/skills/local-ci/SKILL.md`
371
+ - changed: `.claude/skills/project-release/SKILL.md`
372
+ - changed: `.claude/skills/security-audit/SKILL.md`
373
+ - changed: `.claude/skills/setup-workflow/SKILL.md`
374
+ - changed: `.claude/skills/spec-self-critique/SKILL.md`
375
+ - changed: `.claude/skills/to-issues/SKILL.md`
376
+ - changed: `.claude/skills/to-prd/SKILL.md`
377
+ - changed: `.claude/skills/to-waves/SKILL.md`
378
+ - changed: `.claude/skills/triage/SKILL.md`
379
+ - changed: `.claude/skills/verify-spike/SKILL.md`
380
+ - changed: `.claude/skills/wrapup/SKILL.md`
381
+ - changed: `scripts/kit-update-pr.mjs`
382
+
351
383
  ### 0.30.0
352
384
 
353
385
  - added: `.claude/skills/skill-manifest.json`