FFFF Decision records: capture the roads not taken (template + auto-capture + non-card capture) · Issue #39 · simon-inkie/inkie-the-brain · GitHub
[go: up one dir, main page]

Skip to content

Decision records: capture the roads not taken (template + auto-capture + non-card capture) #39

Open

Description

@simon-inkie

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: decision card-writeback always carry the non-chosen card options as the alternatives-explored.
  • Fix the emit gap (live finding): a hand-appended record: decision card 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 answered record: decision card, however authored. See the decision record below.

B-leg (non-card capture):

  • A lightweight capture path (likely a small decision CLI 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestminor-tweakA small improvement to existing behaviour

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      0