---
name: mohitagw15856/decision-log-setup
source: https://app.decimal.ai/s/mohitagw15856-decision-log-setup@1/SKILL.md
source_sha256: 23f0d744f65f
---

# 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