decision-principles

Apply 14 ranked decision-making principles to resolve research, plan, and code questions.

1|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/JonnyCBB/claude-code-config --skill decision-principles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-principles
Source: https://github.com/JonnyCBB/claude-code-config/tree/main/plugins/jbb-feature-dev/skills/decision-principles
Command: npx skills add https://github.com/JonnyCBB/claude-code-config --skill decision-principles

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Decision-making principles for agent teams reviewing research, plans, and code. Use to resolve open questions, choose between approaches, make design decisions, gather requirements, and review technical documents. Provides 14 ranked principles with defaults, override conditions, and priority ordering for conflict resolution.

Core Features & Use Cases

  • 14 ranked principles with guardrails and a clear priority ordering to resolve conflicts
  • Documentation of rejected approaches with rationale to improve traceability
  • Domain-adaptive questioning to tailor guidance to API, data, or infrastructure contexts
  • Safety-first and evidence-based decision support to improve reliability and auditability

Quick Start

Apply the 14 decision-making principles to your current research or design question

Frequently Asked Questions about decision-principles

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

FAQPage Schema
How do I apply structured decision-making principles to resolve architecture decisions and design reviews?

Apply 14 ranked decision-making principles with defined priority ordering to resolve architecture decisions and design reviews. This provides clear guardrails, override conditions, and defaults to ensure transparent, reproducible outcomes for agent teams.

What is the best way to document rejected technical approaches and rationale in an RFC?

The best way to document rejected approaches in an RFC is to apply ranked decision-making principles that trace rationale and override conditions. This improves traceability by recording why specific design choices were discarded during the review process.

Can I use domain-adaptive questioning for infrastructure and API design decisions?

Yes, you can use domain-adaptive questioning to tailor decision-making guidance for API, data, or infrastructure contexts. This ensures the 14 principles are applied appropriately to the specific technical domain during implementation planning.

How do I resolve conflicts between safety-first requirements and evidence-based design decisions?

Resolve conflicts between safety-first and evidence-based design decisions using the provided priority ordering for the 14 principles. This structured ranking defines guardrails and override conditions to determine which requirement takes precedence.

When do I need principled decision-making for implementation planning?

You need principled decision-making for implementation planning when resolving open questions, choosing between approaches, or gathering requirements. It enforces specification completeness, evidence validation, and safety-first guardrails for reliable technical documentation.