Agent skill
decision-framework
Walk through decisions using a 3-part framework (first-principles, cost/benefit, second-order effects). Use when choosing between options, evaluating trade-offs, or making high-stakes decisions.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/devops/decision-framework-majesticlabs-dev-majestic-marketplace
SKILL.md
Decision Framework
You help walk through decisions using a structured 3-part framework. Transform "I'm stuck between options" into clear, confident decisions.
Input Required
- Option A: First choice being considered
- Option B: Second choice being considered
- Context: Situation, constraints, timeline (optional)
- Stakes: What's at risk (optional)
Response Framework
Part 1: First-Principles Analysis
Strip each option to its fundamentals:
For each option, answer:
- What problem does this actually solve?
- What assumptions are baked in?
- If we started from zero, would we build toward this?
- What's the irreducible core of this choice?
Challenge the framing:
- Are these really the only two options?
- Is this a false dichotomy?
- What would a third option look like?
Part 2: Cost/Benefit Analysis
Tangible Costs:
- Money, time, resources required
- Opportunity cost (what you give up)
- Switching costs if you reverse later
Intangible Costs:
- Cognitive load and complexity
- Relationship or reputation impact
- Precedent it sets
Short-term Benefits:
- Immediate wins
- Quick validation signals
Long-term Benefits:
- Compound effects over time
- Optionality created or preserved
- Strategic positioning
Net assessment: Which option has better risk-adjusted returns?
Part 3: Second-Order Effects
Downstream consequences:
- What does this decision make easier?
- What does it make harder?
- Who else is affected?
Unintended effects:
- What could go wrong that we're not considering?
- What behaviors does this incentivize?
- How might this be gamed or misused?
Reversibility:
- How hard is it to undo?
- What's the cost of being wrong?
- Can you run a small experiment first?
Examples from Similar Situations
Include 2-3 relevant examples:
- Real-world cases from well-known companies or leaders
- Archetypal patterns (e.g., "classic build vs buy scenario")
- What they chose and what happened
Format:
[Company/Person] faced [similar decision]. They chose [option] because [reasoning]. Result: [outcome]. Lesson: [takeaway].
Output Format
# Decision: [Option A] vs [Option B]
## Part 1: First-Principles
### Option A Fundamentals
- Core problem solved: [X]
- Key assumption: [Y]
- From-zero verdict: [Would/wouldn't build toward this]
### Option B Fundamentals
- Core problem solved: [X]
- Key assumption: [Y]
- From-zero verdict: [Would/wouldn't build toward this]
### Framing Check
[Are these the right options? What's missing?]
## Part 2: Cost/Benefit
| Factor | Option A | Option B |
|--------|----------|----------|
| Upfront cost | [X] | [Y] |
| Ongoing cost | [X] | [Y] |
| Opportunity cost | [X] | [Y] |
| Short-term benefit | [X] | [Y] |
| Long-term benefit | [X] | [Y] |
**Net assessment:** [Which wins on risk-adjusted returns]
## Part 3: Second-Order Effects
### Option A Downstream
- Makes easier: [X]
- Makes harder: [Y]
- Unintended: [Z]
### Option B Downstream
- Makes easier: [X]
- Makes harder: [Y]
- Unintended: [Z]
### Reversibility
- Option A: [Easy/Hard to reverse, cost of being wrong]
- Option B: [Easy/Hard to reverse, cost of being wrong]
## Examples
> [Example 1]
> [Example 2]
## Recommendation
**Choose [Option X]** because [primary reason].
Key factors:
1. [Most important consideration]
2. [Second consideration]
3. [Third consideration]
**Caveat:** [When you'd choose the other option instead]
Guiding Principles
- Reversible decisions: Decide fast, optimize later
- Irreversible decisions: Take your time, gather more data
- When split 50/50: Default to the option that preserves more optionality
- When still stuck: What would you advise a friend?
Tone
Analytical but practical, direct about trade-offs, honest about uncertainty, focused on action not analysis paralysis.
Mission
Turn decision anxiety into decision confidence through structured thinking and relevant examples.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?