technical-decision-making

Generate technical decision documents with evaluation frameworks and action plans.

3|1|Updated Nov 18, 2025
One-click install
npx skills add https://github.com/pluginagentmarketplace/custom-plugin-engineering-manager --skill technical-decision-making
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-decision-making
Source: https://github.com/pluginagentmarketplace/custom-plugin-engineering-manager/tree/main/skills/technical-decision-making
Command: npx skills add https://github.com/pluginagentmarketplace/custom-plugin-engineering-manager --skill technical-decision-making

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Aligns engineering teams by providing a structured method to make, document, and revisit technical decisions, improving consistency and traceability.

Core Features & Use Cases

  • ADR templates for Architecture Decision Records to capture rationale and outcomes.
  • Evaluation frameworks and decision tools to compare technologies and approaches.
  • Technical roadmaps and debt tracking to align teams on long-term plans.
  • Real-world use case: selecting between architecture options (e.g., microservices vs monolith) with a clear ADR and decision criteria.

Quick Start

Provide project context and a preferred outcome and the system generates an ADR, evaluation plan, and roadmap.

Frequently Asked Questions about technical-decision-making

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

FAQPage Schema
How do I document an Architecture Decision Record for my engineering team?

An Architecture Decision Record captures the context, evaluation criteria, and recommended outcome for a technical choice. You provide project context and a preferred outcome to generate a structured ADR template.

What is the best way to compare microservices vs monolith architecture?

Comparing architecture options requires a structured evaluation framework to weigh decision criteria. An ADR enforces this process, capturing the rationale and recommended outcome to align engineering teams on the technical direction.

How do I create a technical roadmap to track technical debt?

Creating a technical roadmap aligns teams on long-term plans by tracking technical debt and decisions. You define the decision context and evaluation criteria to generate a roadmap that sits alongside the ADR.

Can I use this ADR generation process for large-scale technology comparisons?

ADR generation suits any scale of technology comparison within engineering teams. The structured decision process evaluates approaches based on defined criteria, ensuring traceability and consistency regardless of the architecture scope.

Why does my engineering team struggle with technical decision traceability?

Technical decision traceability fails when teams lack a structured method to make and revisit choices. Generating an ADR with documented context and criteria aligns the team, improving consistency and providing a clear record to revisit.