Can I use this for non-technical project decisions?

While optimized for AI-augmented development, the framework works for any domain requiring documented logic, alternative analysis, and risk tracking.

What file formats does the Decision Ledger use?

It generates and updates standardized DECISIONS.yaml and RISKS.yaml files, making them easy to version control and review via Git.

Does this skill help with risk management?

Yes, every decision made triggers a risk identification step where potential downsides are documented along with triggers and mitigation plans.

How does it handle evidence for decisions?

The skill requires every decision to cite at least two evidence IDs from previous synthesis phases, ensuring choices are data-driven rather than speculative.

What is the primary purpose of the Decision Ledger skill?

It provides a structured workflow for transforming research synthesis into explicit, documented decisions with associated trade-offs and risks.

Decision Ledger

Name: Decision Ledger
Author: synaptiai

bysynaptiai

0•

Productivity & Workflow

Facilitates structured decision-making by documenting trade-offs, risks, and evidence-backed choices within development workflows.

The Decision Ledger skill automates the transition from raw research synthesis to actionable strategy by guiding users through a rigorous, interactive decision-making framework. It identifies decision candidates from previous analysis, facilitates comparative trade-off discussions, and generates machine-readable YAML files (DECISIONS.yaml and RISKS.yaml) to maintain a transparent project history. By enforcing quality gates such as mandatory evidence citations and risk mitigation plans, this skill ensures that architectural pivots and business choices are always justified, documented, and linked to their long-term implications.

Key Features

01Evidence-based decision tracking with confidence level scoring

02Interactive trade-off analysis with guided user prompts

03Semantic ID management for cross-referencing choices and risks

040 GitHub stars

05Strict quality gate validation for evidence and mitigation strategies

06Automated generation of DECISIONS.yaml and RISKS.yaml files

Use Cases

01Translating complex research synthesis into a prioritized roadmap of accepted decisions

02Managing project risks by linking major decisions to potential pitfalls and mitigations

03Documenting architectural choices and technology stack selections with clear rationales

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add synaptiai/synapti-marketplace making-decisions

For use in Claude.ai and ChatGPT

Download Skill