What is an ADR in this context?

An Architecture Decision Record (ADR) is a document that captures an important architectural decision made, along with its context, rationale, and consequences. This skill automates their generation and storage.

Where are the decision logs stored?

All generated decision matrices and ADRs are stored locally within your project in the .aiwg/ directory, allowing them to be versioned alongside your code.

Can I customize the evaluation criteria?

Yes, while the skill provides default sets for architectural and library decisions, you can define custom factors and weights to suit your unique business or technical requirements.

How does the decision matrix work?

The skill identifies evaluation criteria (like scalability or cost), assigns weights to them, and scores various options to provide a mathematical recommendation based on your specific project constraints.

Does this skill help with team alignment?

Absolutely. By documenting trade-offs and 'dissenting views,' it provides a transparent record that helps teams understand why a specific path was chosen over others.

Technical Decision Support & ADRs

Name: Technical Decision Support & ADRs
Author: jmagly

byjmagly

•

生产力与工作流

Empowers engineering teams to make data-driven technical choices through weighted decision matrices and automated Architecture Decision Record (ADR) generation.

This skill streamlines the complex process of technical and architectural decision-making by providing a structured framework for evaluating alternatives. It leverages multi-agent orchestration to research candidates, define weighted criteria, and visualize trade-offs through embedded decision matrices. By automating the creation of ADRs and tracking decision rationale, it ensures long-term project clarity and prevents 'architecture by accident' in fast-moving development environments.

主要功能

01Automated Architecture Decision Record (ADR) creation and management

02Weighted decision matrix generation with customizable scoring rubrics

0367 GitHub stars

04Multi-dimensional trade-off analysis across technical and process domains

05Standardized templates for architectural, technical, and process decisions

06Multi-agent orchestration for objective research and risk assessment

使用场景

01Documenting critical architectural shifts to maintain a historical record of technical rationale

02Selecting third-party libraries or frameworks by evaluating community support and performance

03Comparing database technologies based on specific project constraints and team expertise

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