docs: workaround-records-the-defect principle + dogfooding captures (iss-73/74/75) - #40
Merged
Merged
Conversation
Recorded while dogfooding abcd as a plugin: iss-73 memory-lint writes to the retired .abcd/logbook/ (the fix behind iss-56's adjudication — runtime artefacts belong in .abcd/.work.local/logs/); iss-74 a duplicate iss-56 id (ledger-integrity bug); iss-75 no dev/always-latest install mode (worked around with a build-on-each-call wrapper). Per the golden rule: a manual workaround is recorded, never silently bypassed. Assisted-by: Claude:claude-opus-4-8
Codify the golden rule as a first-class principle: when abcd breaks and a manual workaround is taken to move forward, the underlying defect must be recorded as a ledger issue; a silent workaround erases the only trace of the defect. Bounds it to abcd defects (not host-harness quirks or operator mistakes) so the ledger stays signal. Three-rung ladder: principle now, abcd capture is the enabling convention, a workaround-emitted-a-capture check is the absent tool rung. 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
1 participant
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.
What
Two commits from the abcd plugin-dogfooding session:
chore:capture three abcd defects surfaced while dogfooding — iss-73(memory-lint writes to the retired
.abcd/logbook/; the fix behind iss-56'sadjudication), iss-74 (duplicate
iss-56id — ledger integrity), iss-75(no dev/always-latest install mode, worked around with a build-on-each-call wrapper).
docs:add the principle workaround-records-the-defect — codifying thegolden rule that a manual workaround must record its underlying defect as a ledger
issue; a silent workaround erases the only trace the defect ever showed. Bounded to
abcd defects (not host-harness quirks or operator mistakes) so the ledger stays
signal; three-rung ladder declared.
Why
Dogfooding only improves abcd if the friction it surfaces is recorded. The principle
makes "record every worked-around defect" a first-class build discipline alongside
fix-the-detectorandguards-prove-themselves; the three captures are its firstevidence. Docs/records + ledger only — no code, no new dependency.
Assisted-by: Claude:claude-opus-4-8