decision-helper

Frame and score architectural decisions with a weighted decision matrix.

415|44|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/notque/claude-code-toolkit --skill decision-helper-notque
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: decision-helper
Source: https://github.com/notque/claude-code-toolkit/tree/main/skills/decision-helper
Command: npx skills add https://github.com/notque/claude-code-toolkit --skill decision-helper-notque

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Weighted, transparent decision-making for architectural and technology choices, turning gut feel into measurable recommendations.

Core Features & Use Cases

  • Frames decisions with 2-4 options and applies a weighted criteria matrix to rank them.
  • Detects close calls and surfaces where differences are marginal to prompt further analysis.
  • Persists decisions to ADR or task plans for auditability and future reference.
  • Enforces guardrails like a maximum of four options and mandatory alignment with CLAUDE.md guidelines.

Quick Start

Frame a decision with 2-4 options, define the criteria, score the options, and review the weighted results to select a winner.

Frequently Asked Questions about decision-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make architectural decisions using a weighted scoring matrix?▼

A weighted decision matrix evaluates 2-4 options against weighted criteria to produce a ranked recommendation. It transforms gut feel into measurable scores, detecting close calls where differences are marginal to prompt further analysis.

When should I use a weighted decision matrix for technology selection?▼

Use a weighted decision matrix for technology vendor selection and design trade-offs when comparing 2-4 options. It enforces option limits and alignment constraints, ensuring structured, transparent evaluation instead of subjective preference.

How do I document trade-off analysis results for future reference?▼

Document trade-off analysis by persisting weighted scoring outcomes to ADR or task plans. This ensures auditability and creates a historical record explaining why specific architectural or technology choices were selected.

Can I evaluate more than four options in a single decision matrix?▼

No, the decision matrix enforces a maximum of four options per evaluation. This constraint maintains analytical focus and prevents scoring dilution when performing architectural trade-off analysis.

What happens if the weighted scores for two options are very close?▼

When weighted scores are close, the matrix detects the close call and surfaces marginal differences. This prompts further analysis rather than blindly accepting a winner, ensuring narrow scoring gaps receive appropriate scrutiny.