Technical Decision Guide

Help PMs make technical architecture decisions without deep engineering background — database selection, hosting, auth patterns, monolith vs microservice, API design. Written in PM-friendly language with decision trees.

9 stars 2 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add tarunccet/pm-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add tarunccet/pm-skills --skill technical-decision-guide
Manual install
git clone --depth 1 https://github.com/tarunccet/pm-skills.git /tmp/pm-skills
mkdir -p ~/.claude/skills
cp -r /tmp/pm-skills/pm-vibe-coding/skills/technical-decision-guide ~/.claude/skills/technical-decision-guide

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Technical Decision Guide

## Purpose
Guide PMs through key technical architecture decisions when building with AI coding assistants. Translates technical trade-offs into product-management terms: speed vs control, cost vs scale, simplicity vs flexibility. Helps you make good enough decisions quickly without needing a deep engineering background.

## Domain Context
For PM-builders, "good enough architecture" beats "perfect architecture." The goal is an architecture that: (1) gets to working prototype fast, (2) doesn't create painful technical debt for the first 12 months, (3) can be handed off to engineers without a full rewrite.

This guide uses decision trees — answer simple questions to get a recommendation. Each decision includes a PM-friendly explanation of the trade-offs, what you'll regret if you choose wrong, and what to say to an AI coding assistant to implement the recommendation.

**The PM Architecture Principle**: Optimize for developer experience at prototype stage, not theoretical scale. The bottleneck for PM-builder projects is almost never the database or hosting choice — it's the speed of iteration. Choose the stack that lets you move fastest while staying on a path engineers can take over.

## When to Use
- Use when choosing a database for your prototype
- Use when deciding between hosting options
- Use when picking an auth approach
- Use when deciding how to structure your backend
- Use when an AI coding assistant asks you to make an architectural choice
Read the full skill on GitHub

Details

Skill name
technical-decision-guide
Path
pm-vibe-coding/skills/technical-decision-guide/SKILL.md
License
MIT
Repo updated
13 November 2026

FAQ

What does the Technical Decision Guide skill do?

Help PMs make technical architecture decisions without deep engineering background — database selection, hosting, auth patterns, monolith vs microservice, API design. Written in PM-friendly language with decision trees.

How do I install the Technical Decision Guide skill?

Claude Code plugin: /plugin marketplace add tarunccet/pm-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Technical Decision Guide popular?

It lives in tarunccet/pm-skills, which has 9 GitHub stars and 2 forks.

Related skills

Ab Test Analysis

9

tarunccet/pm-skills

Analyze A/B test results with statistical significance, sample size validation, confidence intervals, and ship/extend/stop recommendations. Use when evaluating experiment results, checking if a test reached significance, interpreting split test data, or deciding whether to ship a variant.

Testing & QA

Adr

9

tarunccet/pm-skills

Document architecture and product decisions using the Nygard ADR format — captures context, alternatives considered, and consequences so the team never asks 'why did we do it this way?' again. Use when making architecture decisions, choosing between technical approaches, selecting vendors, or any decision that will be hard to reverse.

Software Development

AI Build Buy Partner

9

tarunccet/pm-skills

Evaluate AI capability sourcing options across build, buy, fine-tune, and partner archetypes using a structured decision matrix. Use when deciding whether to build a custom model, use an LLM API, fine-tune a base model, or partner with an AI vendor.

AI, LLMs & Agents

Vibe Coding Spec

9

tarunccet/pm-skills

Write a natural-language specification optimized for feeding to AI coding assistants. Covers problem statement, user flows, data model, API contracts, UI descriptions, tech stack, and constraints.

Software Development

Technical Analyst

9

tarunccet/pm-skills

Technical translator for PMs — helps understand systems, codebases, APIs, and technical concepts in PM-friendly terms without oversimplifying. Use when trying to understand a technical system, investigating code for product decisions, preparing for architecture discussions, or translating engineering proposals into product implications.

Software Development

Agy Delegate

9

huytran1120/vietnam-agentic-skills

Delegate coding tasks to the Google Antigravity CLI (`agy`) only when the user explicitly requests it, while the orchestrator retains review and landing responsibility.

Software Development

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.