Skip to content
Back to search

decision-ledger

A decision log for your AI. It records what you chose, what you rejected and why, and checks it before suggesting anything.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ninaneev--decision-ledger/badge.svg)](/listings/ninaneev--decision-ledger)

HTML

<a href="/listings/ninaneev--decision-ledger"><img src="/api/listings/ninaneev--decision-ledger/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

About 10 minutes. Run these from the folder where you downloaded this repo.

**1. Copy the skill**

macOS or Linux

mkdir -p ~/.claude/skills/decision-ledger && cp skills/decision-ledger/SKILL.md ~/.claude/skills/decision-ledger/

Windows (PowerShell)

New-Item -ItemType Directory -Force $HOME\.claude\skills\decision-ledger; Copy-Item skills\decision-ledger\SKILL.md $HOME\.claude\skills\decision-ledger\

> ✅ Check that the file is at `~/.claude/skills/decision-ledger/SKILL.md`. If it sits directly inside `skills/`, it will not load.

**2. Add an empty ledger to your project**

Copy the `ledger/` folder into your project folder.

> Want one ledger for all your projects? Put `ledger/` in your home folder and follow the full path note at the end of [`setup/CLAUDE-snippet.md`](setup/CLAUDE-snippet.md).

**3. Make the guard run every session**

Open the `CLAUDE.md` in your project folder (create an empty one if you have none) and paste the block from [`setup/CLAUDE-snippet.md`](setup/CLAUDE-snippet.md).

**4. Seed it**

Open a terminal in your project folder, start Claude Code there and type

/decision-ledger seed

It interviews you about your last 5 real decisions. An empty ledger protects nothing, so this is the step that makes it pay off.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 255 lines
  1. <div align="center">
  2. # 📒 Decision Ledger
  3. ### Your AI remembers what you said. It forgets what you said no to.
  4. A free skill that gives Claude and ChatGPT a memory of your **decisions**, including the ideas you already rejected, why you rejected them, and what would make you look again.
  5. [![License: MIT](https://img.shields.io/badge/license-MIT-9C83F7.svg)](LICENSE)
  6. [![Claude Code](https://img.shields.io/badge/Claude%20Code-skill-9C83F7.svg)](#install-in-claude-code)
  7. [![Claude.ai and ChatGPT](https://img.shields.io/badge/Claude.ai%20%26%20ChatGPT-projects-9C83F7.svg)](#use-it-in-claudeai-or-chatgpt)
  8. [![Plain markdown](https://img.shields.io/badge/your%20data-plain%20markdown-9C83F7.svg)](#your-data)
  9. **[Install in 10 minutes](#install-in-claude-code)** · **[See a real record](examples/2026-03-02-pricing-model.md)** · **[How it works](#how-it-works)**
  10. </div>
  11. ---
  12. ## The problem
  13. You decided against a free tier in March. You had good reasons.
  14. In May your AI suggests a free tier. You explain again. In July it suggests it again, phrased a little differently. Every few weeks you argue with your own past self, and the AI takes the side of whoever spoke last.
  15. AI memory keeps what you said. It rarely keeps what you **ruled out**, and it never keeps the condition under which you would change your mind. That missing half is where the loop comes from.
  16. ## The fix
  17. ```
  18. You: We get 11 paid signups a month. How should I grow this?
  19. Claude: I'd usually suggest a free tier, but you discarded that on 2026-03-02.
  20. Free users never upgraded in your last product. You said you'd only
  21. reopen it if paid signups stall below 5 a month for 2 months.
  22. At 11 a month that hasn't happened, so here's what I'd do instead...
  23. ```
  24. Decision Ledger keeps a short record of every decision and every option that lost, with the reason and a **"reopen only if"** condition. Your AI reads it before it recommends anything.
  25. ---
  26. ## How it works
  27. ```mermaid
  28. flowchart LR
  29. A[You decide<br/>'go with B, drop A'] --> B[Log<br/>record + index row]
  30. B --> C[(ledger/<br/>DECISIONS.md)]
  31. D[AI is about to<br/>suggest something] --> E{Guard<br/>already discarded?}
  32. C --> E
  33. E -- yes --> F[Tells you when, why,<br/>and the reopen condition]
  34. E -- no --> G[Suggests it]
  35. H[You change your mind] --> I[Old record marked superseded<br/>new record links to it]
  36. I --> C
  37. ```
  38. It does five things.
  39. | | What it does | You say | It does |
  40. |---|---|---|---|
  41. | 🌱 | **Seed** | `/decision-ledger seed` | Interviews you for 10 minutes, one question at a time, about your last 5 real decisions, so the ledger protects you from day one |
  42. | ✍️ | **Log** | "let's go with B", "drop that", "park it" | Confirms in one line, asks for any missing reason (never invents one), writes the record, adds a row to the index |
  43. | 🛡️ | **Guard** | nothing, it runs on its own | Before recommending a price, tool, channel, name or plan, checks what you discarded and tells you instead of re-pitching it |
  44. | 🔎 | **Recall** | "why did we pick €39?", "did we already try Instagram?" | Answers with the date and the reason in your own words. If nothing is logged, it says so and does not guess |
  45. | 🔁 | **Revisit** | "what's due for a revisit?" | Flags decisions whose revisit date has passed. When you change your mind, the old decision stays, marked superseded, so you can see how your thinking moved |
  46. ### Why it actually works
  47. An instruction like "check my decisions first" gets skipped the moment a question looks simple. So the ledger does not rely on the AI remembering to look.
  48. One line in your `CLAUDE.md` loads the decision index into **every** session. The check costs nothing and cannot be skipped. That is also why the index stays short, one row per decision, short names in the Discarded column.
  49. ---
  50. ## What a record looks like
  51. Each decision is one small markdown file. This is the heart of it.
  52. ```markdown
  53. # Charge a flat €29 a month, no free tier
  54. Date: 2026-03-02
  55. Status: superseded
  56. Area: pricing
  57. Revisit: 2026-06-01 or when we pass 50 customers
  58. ## Decision
  59. One plan, €29 a month, cancel any time. No free tier.
  60. ## Why
  61. Our buyers are solo coaches. In 6 sales calls, 4 asked "how much is it
  62. for just me". Per seat pricing made them do maths before they saw the product.
  63. ## Discarded
  64. - Per seat pricing: scared off solo buyers in calls.
  65. Reopen only if: a team of 5 or more asks for it.
  66. - Free tier: support load with no revenue, free users never upgraded.
  67. Reopen only if: paid signups stall below 5 a month for 2 months.
  68. - Lifetime deal: cash now, support forever.
  69. Reopen only if: we need runway in under 30 days.
  70. Superseded by: 2026-04-20-price-39.md
  71. ```
  72. And the index your AI reads every session:
  73. | Date | Decision | Discarded | Status | Revisit | Record |
  74. |---|---|---|---|---|---|
  75. | 2026-05-12 | Instagram paused, TikTok only | Instagram Reels, YouTube Shorts | active | 2026-08-12 | [record](examples/2026-05-12-one-channel.md) |
  76. | 2026-04-20 | Flat €39/month, annual €390 | €29/month, per seat | active | 2026-07-20 | [record](examples/2026-04-20-price-39.md) |
  77. | 2026-03-02 | Flat €29/month | per seat, free tier, lifetime deal | superseded | 2026-06-01 | [record](examples/2026-03-02-pricing-model.md) |
  78. The three examples follow a made up coaching app that set a price, raised it seven weeks later and paused Instagram. Read them in order to see how a decision changes without losing its history.
  79. **Statuses** `open` still deciding · `active` in force · `superseded` replaced by a newer decision · `reversed` undone
  80. ---
  81. ## Install in Claude Code
  82. About 10 minutes. Run these from the folder where you downloaded this repo.
  83. **1. Copy the skill**
  84. macOS or Linux
  85. ```bash
  86. mkdir -p ~/.claude/skills/decision-ledger && cp skills/decision-ledger/SKILL.md ~/.claude/skills/decision-ledger/
  87. ```
  88. Windows (PowerShell)
  89. ```powershell
  90. New-Item -ItemType Directory -Force $HOME\.claude\skills\decision-ledger; Copy-Item skills\decision-ledger\SKILL.md $HOME\.claude\skills\decision-ledger\
  91. ```
  92. > ✅ Check that the file is at `~/.claude/skills/decision-ledger/SKILL.md`. If it sits directly inside `skills/`, it will not load.
  93. **2. Add an empty ledger to your project**
  94. Copy the `ledger/` folder into your project folder.
  95. > Want one ledger for all your projects? Put `ledger/` in your home folder and follow the full path note at the end of [`setup/CLAUDE-snippet.md`](setup/CLAUDE-snippet.md).
  96. **3. Make the guard run every session**
  97. Open the `CLAUDE.md` in your project folder (create an empty one if you have none) and paste the block from [`setup/CLAUDE-snippet.md`](setup/CLAUDE-snippet.md).
  98. **4. Seed it**
  99. Open a terminal in your project folder, start Claude Code there and type
  100. ```
  101. /decision-ledger seed
  102. ```
  103. It interviews you about your last 5 real decisions. An empty ledger protects nothing, so this is the step that makes it pay off.
  104. ---
  105. ## Use it in Claude.ai or ChatGPT
  106. No terminal needed. You keep one file and the AI reads it in every chat.
  107. 1. Create a **Project** in Claude.ai or ChatGPT.
  108. 2. Upload `ledger/DECISIONS.md` as project knowledge.
  109. 3. Paste the instructions from [`setup/claude-ai-and-chatgpt.md`](setup/claude-ai-and-chatgpt.md).
  110. 4. Paste the seed prompt from the same file to fill it with your last 5 decisions.
  111. The AI cannot write files here, so when it logs a decision it hands you a ready row and a ready record to paste in. Once a week is enough if you batch them.
  112. ---
  113. ## Everyday use
  114. Just talk the way you already do. A few things worth knowing:
  115. - **Ideas are not decisions.** It only logs what you commit to ("let's do it", "approved", "kill it", "park that"). Brainstorming stays out of the ledger.
  116. - **Discarding counts.** "Drop the podcast idea" is a decision, and the most valuable kind to keep.
  117. - **No reason, no invention.** If you do not say why, it asks once. If you still do not say, it writes `reason not given` rather than making one up.
  118. - **Absolute dates only.** "Last week" means nothing in two months.
  119. - **Disagreeing is allowed.** If the AI thinks an active decision is wrong, it must name the decision first and then make its case. It never works around it quietly.
  120. Good questions to ask
  121. ```
  122. Why did we pick €39?
  123. Did we already try Instagram?
  124. What did we discard about pricing?
  125. What's due for a revisit?
  126. Has the reopen condition for the free tier been met?
  127. ```
  128. ---
  129. ## Your data
  130. Your ledger is plain markdown in your own folder. There is no account, no server and no database (unless you choose Notion mode, then it lives in your own Notion workspace). Nothing leaves your computer beyond what your AI tool already sees in a normal session. You can read it, edit it, put it in git or delete it at any time.
  131. ---
  132. ## FAQ
  133. **Doesn't Claude or ChatGPT memory already do this?**
  134. Built in memory keeps facts about you. It does not keep which options you rejected, why, or under what condition you would reconsider, and it does not stop the AI from suggesting them. The ledger does exactly that one thing.
  135. **Will it slow my sessions down?**
  136. The index is one short table. Your AI reads it in a moment, and opens a full record only when it needs the reason.
  137. **Can I use one ledger across several projects?**
  138. Yes. Put the folder in your home directory and use the full path in your `CLAUDE.md`. See [`setup/CLAUDE-snippet.md`](setup/CLAUDE-snippet.md).
  139. **What happens when I change my mind?**
  140. The old decision is marked `superseded` and linked to the new one. Nothing is deleted or rewritten to look like it was always right. The trail is the point.
  141. **Does it work for a team?**
  142. Put the `ledger/` folder in your shared repo. Everyone's AI then reads the same decisions, which is also a quick way to onboard someone new.
  143. **Does it work with Notion?**
  144. Yes. Create one database, paste a block into your `CLAUDE.md`, and the skill reads and writes rows through the Notion MCP tools instead of files. See [`setup/notion.md`](setup/notion.md).
  145. ---
  146. ## Roadmap
  147. - [x] Claude Code skill with seed, log, guard, recall and revisit
  148. - [x] Claude.ai and ChatGPT Projects version
  149. - [x] Notion database version
  150. - [ ] Weekly review prompt that lists decisions due for a revisit
  151. - [ ] More example ledgers (agency, solo consultant, product team)
  152. Ideas and bug reports are welcome in [Issues](../../issues).
  153. ---
  154. ## Files
  155. | Path | What it is |
  156. |---|---|
  157. | [`skills/decision-ledger/SKILL.md`](skills/decision-ledger/SKILL.md) | The skill Claude Code follows |
  158. | [`ledger/DECISIONS.md`](ledger/DECISIONS.md) | Your empty ledger index |
  159. | [`setup/CLAUDE-snippet.md`](setup/CLAUDE-snippet.md) | Paste into CLAUDE.md so the guard always runs |
  160. | [`setup/claude-ai-and-chatgpt.md`](setup/claude-ai-and-chatgpt.md) | Version for Claude.ai and ChatGPT Projects |
  161. | [`setup/notion.md`](setup/notion.md) | Keep the ledger in a Notion database |
  162. | [`examples/`](examples/) | Three filled records and their index |
  163. ---
  164. <div align="center">
  165. If it saves you one repeated argument, a ⭐ helps other people find it.
  166. Made by **Nina Niamh Cressoni** · [ninaneev.github.io](https://ninaneev.github.io) · [TikTok](https://www.tiktok.com/@nina.neev)
  167. MIT licensed. Use it, change it, share it.
  168. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.