Where are the decisions actually stored?

You can choose between Memory MCP for quick retrieval, your project's CLAUDE.md file for team visibility, or dedicated markdown files in a docs/adr/ folder for formal version control.

How does this skill help with onboarding?

By maintaining a Decision Logger, new developers can instantly understand the history and constraints of a project by asking Claude why certain patterns or tools were implemented.

When should I log a decision versus skipping it?

You should log choices involving library selections, architectural patterns, and trade-offs. You can skip obvious, easily reversible choices or standard patterns that follow existing conventions.

What is an ADR in the context of Decision Logger?

An Architecture Decision Record (ADR) is a formal document captured by the skill that includes the title, status, context, the decision itself, and the resulting consequences.

Decision Logger

Name: Decision Logger
Author: willsigmon

bywillsigmon

•

Productivity & Workflow

Captures and documents the reasoning behind architectural choices and technical decisions to ensure long-term project clarity.

Decision Logger is a specialized Claude Code skill designed to eliminate ambiguity in software development by formalizing the 'why' behind every major choice. Whether you are selecting a framework, designing an API, or making a trade-off, this skill helps you create quick logs or full Architecture Decision Records (ADRs). By storing context in memory, CLAUDE.md, or dedicated repository files, it ensures that you or your team never have to guess about past motivations, making it an essential tool for project maintenance, onboarding, and managing technical debt.

Key Features

01Structured review patterns to validate and revisit past decisions as project context evolves

02Automated Architecture Decision Record (ADR) generation and management

037 GitHub stars

04Flexible storage options including Memory MCP, CLAUDE.md, and local markdown files

05Intelligent context retrieval to answer historical 'why' questions

06Quick log capture for rapid decision tracking during active coding sessions

Use Cases

01Documenting the selection of specific libraries or frameworks over alternatives to prevent future second-guessing

02Recording the rationale for breaking from standard conventions or making specific architectural trade-offs

03Onboarding new team members by providing a searchable history of technical design choices and constraints

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add willsigmon/sigstack decision-logger

For use in Claude.ai and ChatGPT

Download Skill