tech-decision

Generate conclusion-first technical decision reports comparing A/B/C options with weighted criteria.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/sr-ai-dev/sr-harness --skill tech-decision-sr-ai-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-decision
Source: https://github.com/sr-ai-dev/sr-harness/tree/main/skills/tech-decision
Command: npx skills add https://github.com/sr-ai-dev/sr-harness --skill tech-decision-sr-ai-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you make clear, evidence-based technical decisions when you’re unsure which option to choose by turning ambiguous “what should we use?” questions into a structured comparison and conclusion.

Core Features & Use Cases

  • Conclusion-first decision reports that surface a recommendation up front, then explain why it wins.
  • Multi-phase workflow that clarifies the decision topic, defines evaluation criteria, gathers information from multiple angles (codebase patterns, official docs, and community/AI expert perspectives), and synthesizes tradeoffs.
  • Decision-ready outputs including criteria/weights, option pros/cons with source attribution, and explicit risks/considerations.

Use cases include library/framework selection (e.g., React vs Vue), architecture decisions (monolith vs microservices, REST vs GraphQL), and implementation approach choices (server-side vs client-side, polling vs WebSocket).

Quick Start

Ask the Skill: "Which should we use for state management in our app, Redux or Zustand, and why based on performance, learning curve, ecosystem, and maintainability for our project?"

Frequently Asked Questions about tech-decision

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

FAQPage Schema
How do I make an evidence-based technical decision for library selection?

Evidence-based technical decisions require defining weighted criteria, gathering parallel evidence from official docs and community sources, and synthesizing tradeoffs to produce a conclusion-first recommendation report. This approach clarifies ambiguous library selection choices.

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

Comparing architecture patterns involves defining specific engineering criteria with weights, evaluating source-attributed evidence for each option, and synthesizing tradeoffs to generate a final recommendation with explicit risks and considerations for your project context.

How do I structure a technical decision report for framework tradeoffs?

A technical decision report should be conclusion-first, surfacing the winning option immediately, then detailing criteria and weights, option pros and cons with source attribution, and explicit risks and considerations to explain why it wins.

Can I use weighted criteria to compare implementation approaches like REST vs GraphQL?

Yes, you can evaluate implementation approaches like REST vs GraphQL by defining weighted evaluation criteria, gathering evidence from codebase patterns and community perspectives, and synthesizing the tradeoffs to recommend the best option for your stated engineering choice.

When do I need a formal tradeoff analysis for an engineering choice?

You need formal tradeoff analysis when facing ambiguous engineering choices like polling vs WebSocket, where defining criteria with weights and gathering multi-angle evidence ensures a confident, source-attributed recommendation rather than subjective selection.

What are the limitations of using automated evidence synthesis for technical decisions?

Automated evidence synthesis relies on defined criteria and available sources, meaning it provides a structured recommendation with risks and considerations based on current information, but requires you to validate project-specific constraints and codebase patterns.