From c814bf2e0f182580a48b44f93c2b2f18e92e9723 Mon Sep 17 00:00:00 2001 From: jochen Date: Tue, 10 Nov 2026 10:57:23 +0100 Subject: [PATCH] Close a research effort with the close verb, so only the closing is judged Proposing a graduated effort again whole had the knowledge base re-judge its approved reasoning against the decisions that replace it (issue 1966). Claude-Session: https://claude.ai/code/session_01JG73KK8HD1gufnqyFxMFdW --- .claude/skills/hq-graduate/SKILL.md | 5 +++-- 00-META/process/02-graduation.md | 10 +++++++--- 2 files changed, 10 insertions(+), 5 deletions(-) diff --git a/.claude/skills/hq-graduate/SKILL.md b/.claude/skills/hq-graduate/SKILL.md index 52ce9bb4..c60b57a0 100644 --- a/.claude/skills/hq-graduate/SKILL.md +++ b/.claude/skills/hq-graduate/SKILL.md @@ -27,8 +27,9 @@ written into this repository. status, reviews and the operator's ask. 4. **Write the design** under `03-DESIGN/01-to-be/` with `layer: to-be`, `status: designed`, empty `code:`, today's `updated:`, and `decisions:` listing `"ADR NNNN"`. -5. **Close the effort** — `knowledge-base.propose` the effort again, whole, with `status: graduated` and - `became` links to the record (`"NNNN"`) and the design (its path). +5. **Close the effort** — `knowledge-base.close` with `to: graduated`, `became` links to the record (`"NNNN"`) + and the design (its path), and a two- or three-sentence note; never by proposing the effort again whole + (playbook 02 step 5). ## Amending an existing design diff --git a/00-META/process/02-graduation.md b/00-META/process/02-graduation.md index 2d1b6231..2ce86170 100644 --- a/00-META/process/02-graduation.md +++ b/00-META/process/02-graduation.md @@ -69,9 +69,13 @@ about an hour, and said to the operator if it runs past. 4. **Hand it to the work breakdown.** The design goes on through playbook [04](04-build-handoff.md): milestones, issues, and each milestone built as one feature step (playbook [07](07-feature-branches.md)). -5. **Close the effort.** `knowledge-base.propose` the effort again, whole, with `status: graduated` and a - `became` link to the decision record (`"NNNN"`) and to the design document (its path). An effort that - stops without a decision is proposed with `status: abandoned` and a `cites` link to what replaced it: the +5. **Close the effort.** `knowledge-base.close` the effort with `to: graduated`, a `became` link to each + decision record (`"NNNN"`) and the design document (its path), and a note of two or three sentences (what it + became, what carries it). The verb keeps the served text unchanged and adds a section *Graduated* with the note; + the knowledge base's review judges only the closing. Never close by proposing the effort again whole: + that is judged as a fresh proposal, so the approved reasoning is re-judged against the decisions that replace it + (on 2026-11-10 an effort closed that way met 5, then 11 findings on unchanged text; `close` was approved at once). + An effort that stops without a decision is closed `to: abandoned` with a `cites` link to what replaced it: the knowledge base refuses `became` from a research effort to another research effort (its link-fits rule, design 55 § 2), so a replacing effort is cited, and `became` stays for the decision and the design an effort turned into.