What do the /advocate and /detract commands do?

These are post-decision tools that help you either build a compelling case for the decision to stakeholders or stress-test the decision by generating thoughtful challenges and objections.

Where are the decisions stored?

All decisions are saved to a dedicated 'docs/decisions/' directory within your repository, ensuring they are version-controlled alongside your code.

What is a decision artifact?

A decision artifact is a standardized Markdown file (decision.md) that records the context, considered alternatives, risks, and the final rationale for a specific project choice.

How does this skill prevent decision amnesia?

By forcing the documentation of 'must-be-true' assumptions and 'exit triggers,' the skill ensures that future team members understand exactly why a choice was made and under what conditions it should be revisited.

Decision Capture & Documentation

Name: Decision Capture & Documentation
Author: wme3

bywme3

•

Productivity & Workflow

Formalizes the final stage of the decision-making process by documenting rationale, alternatives, and risks into a permanent project artifact.

The Decision Capture skill provides a structured framework for finalizing critical project choices, ensuring that the context and logic behind every move are preserved. It guides users through a rigorous 'Gate 7' process that includes summarizing alternatives, identifying 'must-be-true' assumptions, and capturing the specific rationale that clinched the choice. By generating standardized decision artifacts in markdown, it creates a searchable history that eliminates 'decision amnesia,' provides clear exit triggers for future reviews, and offers post-decision support via advocacy and detraction commands.

Key Features

01Structured Decision Summaries

02Automated Decision Artifact Generation

03Alternative and Risk Assessment

043 GitHub stars

05Post-Decision Advocacy and Detraction Analysis

06Configurable Depth (Light, Medium, Complete)

Use Cases

01Finalizing architectural choices in software development

02Establishing triggers for revisiting past decisions when conditions change

03Creating a permanent audit trail for team-based consensus

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add wme3/deliberatedecisions decision-capture

For use in Claude.ai and ChatGPT

Download Skill