Close a research effort with the close verb, so only the closing is judged
mesh/delivery merged: source.main moved to novox/hq@d0d71b554876
mesh/check checking c814bf2e0f18 on d0d71b554876
mesh/delivery merged: source.main moved to novox/hq@d0d71b554876
mesh/check checking c814bf2e0f18 on d0d71b554876
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
This commit is contained in:
@@ -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
|
||||
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user