Repository navigation
Description
Original Linear description
Implement the "document the decisions/alternatives you did NOT take, and why" idea (James Charlesworth, LinkedIn; brought by the maintainer 2026-06-22). the maintainer picked scope B via decision-card (decision-records-roads-not-taken).
Context: we already do ~80% of this. ~/brain/decisions/ entries already carry an "Options considered" section (chosen + rejected, with the why), and the record: decision card flag is meant to auto-write these on answer. So this closes a narrow gap, not a new build.
Scope B (chosen) = A + non-card capture
A-leg (template + auto-capture):
- Make "Options considered + a one-line why-not per rejected alternative" a REQUIRED section in the decision-record template.
- Make the
record: decisioncard-writeback always carry the non-chosen card options as the alternatives-explored. - Fix the emit gap (live finding): a hand-appended
record: decisioncard answered B in MC but the daemon emitted NO decision record (it only registers cards created through MC's compose flow). The emit must fire for any answeredrecord: decisioncard, however authored. See the decision record below.
B-leg (non-card capture):
- A lightweight capture path (likely a small
decisionCLI or inbox convention) so decisions made in conversation / inbox - not via a card - also land in~/brain/decisions/with their alternatives + why. This closes the "informal decisions evaporate" gap, which is where most of the forgetting happens.
C (deferred, possible fast-follow): re-evaluation surfacing - when a new decision touches a prior topic, surface the old record ("you rejected X before for Y") to stop relitigating. Not in this ticket.
Owner / sizing
maintainer drives (team-tooling lane). ~1-2 days.
References
- Decision record:
~/brain/decisions/2026-06-22-decision-records-roads-not-taken.md - Idea + transcript source:
~/brain/ideas/2026-06-22-decision-records-roads-not-taken.md - Builds on the daemon-side writeback:
~/brain/decisions/2026-06-17-record-decision-writeback-daemon-side.md - Source video (James Charlesworth): https://www.linkedin.com/feed/update/urn:li:activity:7474733039793868800/
Origin
Migrated from Linear: INK-531. The original wording is retained except the disclosed privacy and rendering edits below.
Current scope and qualifications
The description above is the original Linear account, including its historical findings and scope. It is not a fresh claim that every described defect still exists.
Current Linear state is Backlog. Prior source review recorded partial, with this remaining scope:
- Confirm or implement required template and all-authorship writeback; add non-card capture with alternatives and reasons.
Publication transfers the task; it does not authorise live recovery, deployment, spending or configuration changes.
Transfer edits
- Historical principal names are aliased in prose; artificial shell-filename web links are rendered as code where present.
- Historical fleet identities are aliased; code identifiers and permitted source paths remain references.
- Linear rich issue embeds are rendered as clickable Markdown links.
- Additional transfer edits: omit unrelated historical newsletter sequencing.
Activity