Captures a decision with context, alternatives considered, and rationale, then links it to the relevant project doc in the vault. Creates a searchable decision record. Use when the user says "decision log", "log this decision", "record this choice", "document why we chose", "decision record", "ADR", or has just made an important decision.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Decision Log
Capture decisions so future-you knows why.
## Workflow
1. **Capture the decision** — Get from the user:
- **What was decided** — the actual choice made
- **Context** — what prompted this decision? What problem does it solve?
- **Alternatives considered** — what other options were evaluated?
- If the user doesn't provide alternatives, ask: "What other options did you consider?"
2. **Document rationale** — For the chosen option:
- Why was this chosen over alternatives?
- What trade-offs were accepted?
- What constraints influenced the decision?
3. **Assess each alternative** — For each option considered:
- Pros and cons
- Why it was rejected
- Under what conditions it might be reconsidered
4. **Identify consequences** — What follows from this decision:
- Immediate next actions
- Long-term implications
- Reversibility: Is this a one-way door or two-way door?
- Review trigger: When should this decision be revisited?
5. **Link to project** — Connect the decision to:
- Relevant project docs in the vault (`[[Project Name]]`)
- Related prior decisions
- People involved in the decision
## Output Format
```markdown
…
The line at the top of this page pins the label git:20260628.9edbf07, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
A 17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (3028 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag
Source
GitHub
broomva/skills · 5 stars · license MIT · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ret47x6moabb6cbv
GET https://markdownregistry.com/api/v1/resolve?ref=broomva/skills/decision-log
GET https://markdownregistry.com/api/v1/blob/22148316a47614a6db26c64e7acd4651ae2c75abdcca80d6f18661bd326e4391
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
broomva/skills · skills-showcase/SKILL.md · Generate a polished Remotion video and X thread showcasing the full agent skills inventory. Use when creating social…
broomva/skills · skills/aerospace/sdr-satellite/SKILL.md · Software-defined radio (SDR) and satellite reception toolkit — what to install, what you can hear from space, and how…
broomva/skills · skills/audio/omnivoice/SKILL.md · Local TTS, voice cloning, voice design, and video dubbing via the OmniVoice Studio MCP server (open-source ElevenLabs…
broomva/skills · skills/audio/talkback/SKILL.md · Speak an explanation out loud while working in any project — tiered text-to-speech with a pluggable backend (ElevenLabs…
broomva/skills · skills/cadence/drift-check/SKILL.md · Compares stated priorities against where time and effort actually went, and produces a strategy drift report. Uses git…
broomva/skills · skills/cadence/morning-briefing/SKILL.md · Reads open action items, this week's priorities, and recent vault updates, then produces a focused "start your day"…
broomva/skills · skills/cadence/stakeholder-update/SKILL.md · Takes one set of project facts and generates three versions: technical for engineering, business-impact for leadership…
broomva/skills · skills/cadence/weekly-review/SKILL.md · Scans the vault for updates from the past week, surfaces what changed, and flags what needs attention. Produces a…
broomva/skills · skills/commerce/d1-cli/SKILL.md · Shop Tiendas D1 (Colombia, d1.com.co) from the command line — search the catalogue, resolve your nearest physical…
moonlight-lupin/agent-skills · productivity/decision-log/SKILL.md · Use when an architecture/product decision should be recorded or past decisions need re-checking — an ADR-style decision…
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/decision-log/SKILL.md · WHAT - Capture lightweight project, product, or operational decisions that do not require
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.opencode/skills/decision-log/SKILL.md · WHAT - Capture lightweight project, product, or operational decisions that do not require
khaledsaeed18/dotclaude · skills/productivity/decision-log/SKILL.md · Keep a lightweight decision log for a project or a person: one dated line per decision with the choice, the reason, the…
khaledsaeed18/dotclaude · .claude-plugin/plugins/productivity/skills/decision-log/SKILL.md · Keep a lightweight decision log for a project or a person: one dated line per decision with the choice, the reason, the…
