SuperAPI AI Directory

decision-log-setup

General & other

View repository

Updated 10-16 01:18

About this skill

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 closes, thread-to-decision 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