mattgierhart/PRD-driven-context-engineering / temp/v0.5-requirements/prd-v05-technical-stack-selection
prd-v05-technical-stack-selection
VerifiedMake technology decisions for every product capability by discovering existing assets, evaluating vendor-aligned options, and categorizing as Reuse/Extend/Build/Buy/Integrate/Research during PRD v0.5 Red Team Review. Handles both greenfield and brownfield contexts. Triggers on "tech stack", "build or buy?", "what technologies?", "technical decisions", "what do we reuse?", "existing stack", "vendor constraint", "IBM-first", "what tools do we need?", "evaluate solutions", "select tech stack". Consumes FEA- (features), SCR- (screens), RISK- (constraints). Outputs TECH- entries with decisions, rationale, and cross-references. Feeds v0.6 Architecture Design.
| File | Kind | Size |
|---|---|---|
| LEARNINGS-LIGHTSTACK.md | markdown | 8.7 KB |
| SKILL.md | skill md | 14.0 KB |
| assets/evaluation-scorecard.md | markdown | 2.0 KB |
| assets/tech-reuse.md | markdown | 1.7 KB |
| assets/tech.md | markdown | 2.2 KB |
| references/brownfield.md | markdown | 3.6 KB |
| references/examples.md | markdown | 5.5 KB |
| references/ibm-products.md | markdown | 4.7 KB |
assets/tech.md
View on GitHub# TECH- Template (Standard)
Use for Replace, Build, Buy, Integrate, and Research decisions.
```
TECH-XXX: [Technology/Capability Name]
Category: [Replace | Build | Buy | Integrate | Research]
Layer: [Derived from capability area — e.g., AI/ML, Database, Auth, Infrastructure]
Purpose: [What problem this solves]
Features Served: [FEA-XXX, FEA-YYY]
Screens Affected: [SCR-XXX, SCR-YYY] (if applicable)
Risk Constraints: [RISK-XXX that influenced this decision]
Decision: [Specific choice made, or "TBD after POC" for Research]
Rationale: [Why this choice over alternatives — explain the reasoning]
Alternatives Considered:
- [Option A]: [Why rejected]
- [Option B]: [Why rejected]
Trade-offs:
- Pro: [Key advantage]
- Con: [Key disadvantage]
Cost: [Pricing model, estimated cost at current scale AND 10x scale]
Integration Complexity: [Low | Medium | High]
Lock-in Risk: [Low | Medium | High — explain mitigation if Medium/High]
# For Replace category — document what's being replaced:
Replaces: [Current tool/service being replaced]
Replace Reason: [Why existing asset doesn't fit]
# For Research category — define evaluation scope:
Research Needed: [What must be learned before deciding]
Evaluation Criteria: [Specific metrics/benchmarks to evaluate against]
Decision Deadline: [When we must decide — tied to WAVE or milestone]
# Optional — if sibling products exist:
Product Family Notes: [Shared infrastructure, reuse decisions, cross-product impact]
```
## Category Selection Guide
| If... | Category is... |
|-------|----------------|
| Existing asset is wrong for this product | Replace |
| This is a core differentiator, nothing fits | Build |
| Proven solutions exist, not differentiating | Buy |
| Users expect connection to external service | Integrate |
| High uncertainty, multiple viable options | Research |
## Checklist Before Adding
- [ ] Purpose is clear and tied to FEA- entries
- [ ] Alternatives have been considered (at least 2)
- [ ] Cost is realistic (not just free tier — include 10x scale)
- [ ] Trade-offs are acknowledged honestly
- [ ] Does not conflict with any RISK- entry
- [ ] Cross-references are bidirectional (TECH → FEA, TECH → RISK)
- [ ] For Research: evaluation criteria and deadline are defined
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |