← ClaudeAtlas

decision-loglisted

Composable operations on docs/project/decisions.md — the project-wide decision ledger. Called by ideate, spec, correct-course, and retrospective when a direction-setting decision is made, reversed, or parked. Directly invocable as /decision-log to view the current log and open questions.
rterakedis/leanwheel-skills · ★ 2 · DevOps & Infrastructure · score 65
Install: claude install-skill rterakedis/leanwheel-skills
# Decision Log (Composable) Owns `docs/project/decisions.md` — the single ledger of *why the project is going the way it's going*. Planning progress is measured in decisions recorded here, not in document completeness; the spec docs (`docs/prd.md`, `docs/ux/*`, `docs/architecture.md`) are renderings that cite this log, never a second copy of it. Directly invocable: `/decision-log` — show the log, grouped as settled / open / out of scope, with a one-line "what's sharpest to resolve next" suggestion. Read-only in that mode. ## `docs/project/decisions.md` — format ```markdown # Decision Log ## Destination <one or two lines: what this planning effort is finding its way to — a spec, a decision, a change> ## Decisions - {date} — {decision, one line} — why: {reason} — source: {/skill} ## Rejected - {date} — {what was considered and dropped} — why — source: {/skill} ## Not yet specified <open questions, one per line — sharp enough to state, not yet answered. The frontier.> ## Out of scope - {date} — {what was ruled out} — why — source: {/skill} ``` `Decisions` and `Rejected` are append-only one-liners. `Destination`, `Not yet specified`, and `Out of scope` are living text. Entries carry a `source:` naming the skill that wrote them. ## One home per fact This log holds *direction* only. Work owed lives in `docs/deferred-items.md` (via `deferred`); working conventions live in CLAUDE.md; what's being built lives in the spec docs. A fact is recorded in exactly one of these — w