Can I customize the evaluation criteria?

Yes, while the skill provides default criteria for common scenarios like library selection or database design, you can define custom factors and weights specific to your organization's needs.

How does the weighted scoring system work?

The skill assigns weights to different criteria (like performance or cost) based on your priorities. It then scores each technical option against those criteria to provide an objective, data-backed recommendation.

Where are the decision documents stored?

Decision matrices and ADRs are typically stored within your project repository in the .aiwg/decisions/ and .aiwg/architecture/ directories, ensuring they are version-controlled alongside your code.

What is an ADR in the context of this skill?

An Architecture Decision Record (ADR) is a short text file that captures an important architectural decision made along with its context and consequences. This skill automates their generation to help teams maintain a clear project history.

Decision Support & ADRs

Name: Decision Support & ADRs
Author: jmagly

byjmagly

•

Productivity & Workflow

Facilitates data-driven technical decisions through weighted matrices, trade-off analysis, and automated Architecture Decision Records.

The Decision Support skill empowers developers and architects to make rigorous, transparent technical choices within the Claude Code environment. By automating the creation of weighted decision matrices and risk assessments, it transforms subjective debates into structured analyses across architectural, technical, and process-oriented domains. Whether you are selecting a database or evaluating a new framework, this skill ensures every choice is documented with full rationale, consequences, and alternative evaluations, generating standard-compliant ADRs to maintain project history and team alignment.

Key Features

01Trade-off Analysis: Detailed comparison of competing alternatives to highlight long-term implications and risks.

02Weighted Decision Matrices: Compare options across custom dimensions like scalability, cost, and team expertise.

0367 GitHub stars

04Domain-Specific Templates: Pre-configured criteria sets for architectural, technical, and process decisions.

05Automated ADR Generation: Produce professional Architecture Decision Records to document finalized choices.

06Multi-Agent Research: Leverages specialized agents to research alternatives and security implications.

Use Cases

01Selecting the optimal database or cloud infrastructure for a new service based on scale requirements.

02Standardizing team processes such as branching strategies or CI/CD tooling through structured evaluation.

03Evaluating third-party libraries or frameworks by comparing community support, performance, and security.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jmagly/ai-writing-guide decision-support

For use in Claude.ai and ChatGPT

Download Skill