skills.rest
JaimeJunr
JaimeJunrCOMMUNITY
Explore all skills by this author →
GitHub

decision-debate

Guide structured architectural debates evaluating alternatives and documenting criteria, risks, and consensus.

2|Updated Apr 11, 2026
Search Tags:#architecture#documentation#debate#decision-making#stakeholders#risk-analysis
One-click install
npx skills add https://github.com/JaimeJunr/context-mode --skill decision-debate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: decision-debate
Source: https://github.com/JaimeJunr/context-mode/tree/main/.claude/skills/decision-debate
Command: npx skills add https://github.com/JaimeJunr/context-mode --skill decision-debate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides teams through structured and auditable debates to reach robust architectural and technical decisions, reducing ambiguity and rework.

Core Features & Use Cases

  • Structured decision framework: identify the decision, contextualize scope, and define success criteria.
  • Alternatives exploration: generate multiple viable options and compare trade-offs with objective criteria.
  • Documentation and consensus: capture rationale, risks, decisions, and actions for traceability.

Quick Start

Initiate a structured decision debate by outlining the decision, listing alternatives, and recording the final rationale.

Frequently Asked Questions about decision-debate

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

FAQPage Schema
How do I structure an architectural decision debate to evaluate technical trade-offs?▼

To structure an architectural decision debate, identify the decision scope, evaluate at least three alternatives, and document objective criteria, risks, and trade-offs across technical and business dimensions to reach consensus.

What is the best way to document technical decisions for stakeholders and audits?▼

Documenting technical decisions requires capturing the decision context, evaluating evidence, and recording the final rationale and consensus. This process creates auditable records that justify architectural changes to stakeholders.

Can I use structured decision-making for software architecture risk analysis?▼

Yes, structured decision-making facilitates software architecture risk analysis by enforcing a repeatable process to compare viable alternatives, evaluate objective criteria, and document risks and trade-offs across technical and business dimensions.

How do I justify architectural changes and reduce ambiguity for my engineering team?▼

Justify architectural changes by guiding your team through a structured debate that explores multiple alternatives, captures decision context, and documents final consensus, thereby reducing ambiguity and rework.

Does this decision-making framework require specific dependencies to evaluate alternatives?▼

No specific dependencies are required to evaluate alternatives. The framework operates independently to guide teams through defining success criteria, comparing trade-offs, and capturing rationale for technical decisions.

Related Skills

Explore More Software Engineering Skills→
TNHoang2708TNHoang2708
1

ck:predict

Evaluates proposed changes for architecture, security, performance and UX risks via expert personas and debate protocol.

Community
Advanced
jordanhubbardjordanhubbard
105

decision-maker

Produce clear, actionable decisions with rationale for multi-stakeholder discussions.

Community
Advanced
AcidicSoilAcidicSoil
1

compare-architectures

Generate and compare minimal, moderate, and full architecture options with trade-offs.

Community
Advanced
dralgorhythmdralgorhythm
111

writing-adrs

Document architectural decisions using ADR format with Title, Status, Context, Decision, Rationale, and Consequences.

Community
Advanced