chore(record): the ABCD sensemaking method, its principle, and itd-86/87 - #67
Merged
Conversation
abcd's principles were re-deriving a method that was never written down here: the cold reading (blind specification pass), the warm ledger, and the human disposition. itd-27/42, itd-55, and now itd-86/87 had all been accumulating as siblings with no stated parent, which is why the cold reading's prohibitions (propose no fixes, rank nothing) read as arbitrary in isolation - they only make sense if the disposition step downstream is known to exist. Record the method as the parent note, and mint exactly one principle from it: recurrence-is-signal. The cold/warm split is already stated by evaluator-outside-the-loop and verifier-selects-gates-decide, and one-canonical-primitive forbids a third near-copy; recurrence was the only element of the method with no counterpart in the record. itd-86 (cold-reading surface) and itd-87 (recurrence escalation in capture) land together because they are coupled, not merely related: a blind reading re-raises old tensions by design, so pointing it at a ledger that dedupes them yields a detector fighting its own store. Also corrects a stale pointer: the skills-evaluation note cited a skills/abcd-intent-grill/ directory that the Go rebuild left unbuilt; the grill is planned work (itd-27, adr-7, itd-42) and its harvest target is those. The ACKNOWLEDGEMENTS entry crediting the cold reading to abcd's co-author is deliberately held, not forgotten - it awaits confirmation of the credit line and must land before itd-86 ships. Assisted-by: Claude:claude-opus-4-8
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
abcd's principles have been re-deriving a method that was never written down in
this record: the cold reading (a blind specification pass), the warm
ledger, and the human disposition. The evidence that this was happening is
in the record itself —
verifier-selects-gates-decideturns out to be an exactindependent restatement of the method's disposition rule, and
evaluator-outside-the-loopis a weaker cut of its blindness rule (it isolatesthe evaluator from what it may edit; the method isolates it from what it may
know).
Meanwhile itd-27/itd-42 (grill), itd-55 (foundations auditor) and now itd-86/87
had been accumulating as siblings with no stated parent. That absence has a
cost: the cold reading's prohibitions — propose no fixes, rank nothing — read as
an unhelpfully passive reviewer unless you already know a disposition step exists
downstream to do that work.
This PR records the method, and derives from it exactly what the record was
actually missing.
What
research/notes/2026-07-13-abcd-sensemaking-method.md) —the parent, with a table mapping each element of the method onto where abcd
already states it, and what it does not.
recurrence-is-signal. A finding that reappears after itwas dispositioned is evidence about the disposition, not a duplicate of the
finding. A ledger that dedupes a recurrence converts "we were wrong to close
this" into "we already know about this".
abcd capture.skills/abcd-intent-grill/directory that the Go rebuild left unbuilt. Thegrill is planned work (itd-27, adr-7, itd-42) and that is where its harvest
target actually is.
Two deliberate restraints
Only one principle was minted, not one per method element. The cold/warm
split is already covered by the two principles named above, and
one-canonical-primitiveforbids a third near-copy. Aread-it-coldprinciplewas considered and rejected; recurrence was the only element of the method
with no counterpart anywhere in the record. Recorded in
DECISIONS.md.itd-86 and itd-87 are coupled, not merely related. A blind cold reading
re-raises previously surfaced tensions by design; pointed at a ledger that
dedupes them, it is a detector fighting its own store. itd-87 is the precondition
that makes itd-86's re-raising useful rather than noisy — hence one change.
Held, loudly
The
ACKNOWLEDGEMENTS.mdentry crediting the cold reading to abcd's co-author isdeferred, not forgotten: it awaits confirmation of how they wish to be
credited, and must land before itd-86 ships. Stated in the method note and in
DECISIONS.mdrather than left silent, perloud-staging. Do not guess thecredit line.
Verification
Record-only; no Go source touched.
abcd audit→ exit 0, 0 errors, 0 warningsabcd docs lint→ 0 findings, 0 blockersgofmt -l .→ emptyBoth gates were re-run after rebasing onto
mainat #66, since that PR changedthe audit code.
Note for the maintainer
itd-86/87 were allocated against
main. Givenfix/duplicate-intent-id-lintisrecent history, re-check the IDs if another intent was minted concurrently.
Adoption is unchanged and remains yours: these are drafts, and
abcd intent planis not run here.
Assisted-by: Claude:claude-opus-4-8