decision-log-setup

Decision Log Setup Skill

Teams re-decide because decisions evaporate: made in a meeting, mentioned in a thread, remembered differently by everyone, and relitigated the moment someone new (or someone persistent) asks "wait, why do we…?" The decision log is the cheapest institutional memory there is — one line per decision (what, why, who, when, and the reopening rule) — but logs fail as shelf-ware unless capture is wired into existing moments (the meeting's last five minutes, the thread's landing) and retrieval becomes reflex ("checked the log?" as the first response to why-questions).

What This Skill Produces

• The format — the five-field line, with the two-sentence-why discipline and the option-we-rejected field that does the anti-relitigation work
• The capture wiring — the existing moments ([decision-meeting-format](../decision-meeting-format/SKILL.md) closes, [thread-to-decision](../thread-to-decision/SKILL.md) landings, 1:1 calls) that now end with a log line
• The reopening rule — what reopens a decision (new information) and what doesn't (new mood, new people)
• The retrieval habits — the log-first reflex, the onboarding tour, the link-not-relitigate response

Required Inputs

Ask for these if not provided:

• Where decisions currently happen — the meetings, threads, and hallways; capture wires into real venues, and unwired venues keep leaking
• The platform — a doc, a wiki page, a database/table; sortable-and-searchable beats beautiful, and the log lives where the team already looks
• The scope line — which decisions get logged (the test: would someone plausibly ask "why" in six months?) vs. the operational micro-calls that don't; over-logging kills the habit as surely as under-logging kills the value
• The relitigation history — the decisions that keep reopening; they get back-filled first, because they're the demonstration

Framework: The Log Rules

1. The line is five fields and stays a line: date · decision (one sentence, the what) · why (two sentences max, including the rejected alternative: "chose X over Y because Z") · decider · reopening trigger. The rejected-alternative clause is the anti-relitigation payload — "we considered that and here's why not" is the sentence that ends the third rehash.
2. Capture rides existing rituals: the decision meeting's on-screen close writes the line · the thread landing's record is the line · the weekly's "any decisions this week?" sweeps the strays. New ceremony fails; hitching to existing ceremony sticks. One person per venue owns the write (the facilitator, the thread-lander).
3. The reopening rule is stated per decision: default — "reopens on new information, not new preferences" — with specific triggers where known ("revisit if churn exceeds X"). This converts "can we talk about this again?" from a social negotiation into a rule lookup, which is the log's quiet superpower.
4. Retrieval is the ROI moment: the why-question response becomes a link ("logged here — short version: chose X over Y for Z"), the onboarding tour includes the log's greatest hits, and decisions cite prior decisions ("consistent with #47"). A log that's written but never linked is a diary; the link habit is what compounds.
5. Back-fill the greatest hits only: the 10–15 decisions people actually re-ask about get retro-logged (best-effort whys, marked as reconstructed) — full historical back-fill is archaeology that delays the living log. Forward capture from today; history only where it's actively bleeding.

Output Format

Decision Log: [team] — lives at [location]

The Format

| Date | Decision | Why (incl. rejected alt.) | Decider | Reopens if |

|---|---|---|---|---|

Capture Wiring

[Venue → moment → who writes the line · the weekly sweep as the catch-all]

The Reopening Rule

[The default · how specific triggers get set · the link-instead-of-debate response]

Retrieval Habits

[The why-question → link reflex · onboarding's greatest-hits tour · the back-fill list (10–15, marked reconstructed)]

Quality Checks

• [ ] Every field fits the one-line discipline; whys include the rejected alternative
• [ ] Capture is attached to named existing moments with named writers
• [ ] The reopening default is stated and per-decision triggers are possible
• [ ] The link-first response habit has been demonstrated on a real why-question
• [ ] Back-fill stopped at the greatest hits

Anti-Patterns

• [ ] Do not log without the rejected alternative — "we chose X" without "over Y because Z" relitigates fine
• [ ] Do not build capture as new ceremony — hitch to rituals that already happen
• [ ] Do not log everything — the six-month-why test keeps the log readable and the habit light
• [ ] Do not let new-people-energy reopen settled calls — the rule distinguishes information from mood
• [ ] Do not write and never link — retrieval is where the log earns; capture alone is journaling