| name | pc-tech-selection |
| description | Use when the architecture is known and the team must choose concrete languages, frameworks, data stores, or infrastructure tools with explicit trade-offs instead of letting implementation drift into ad hoc stack decisions. |
| metadata | {"phase":"02-architecture","inputs":["requirements-doc","architecture-doc"],"outputs":["tech-decision-record"],"prerequisites":["pc-system-design"],"quality_gate":"Key technology choices are explicit, justified against the architecture drivers, and recorded with adoption consequences","roles":["architect","tech-lead","devops-engineer"],"methodologies":["all"],"effort":"medium"} |
Tech Selection
Choose technologies by architectural fit and operational consequence, not by habit or trend.
Context
Tech selection turns a structural design into a concrete stack.
See context and anti-pattern notes.
Inputs
I/O contract notes define required inputs and authority.
Process
Step 1: Define the Decision Surface
List the categories that actually require a choice now:
- language or runtime
- framework or service platform
- datastore or messaging substrate
- infrastructure or deployment platform
- supporting tools that materially affect delivery or operations
Do not pretend every category is open if upstream constraints already settled it.
Step 2: Compare Against Real Drivers
Evaluate each meaningful option against:
- architecture fit
- team skill and hiring reality
- operational burden
- security and compliance posture
- migration or lock-in cost
- ecosystem maturity and upgrade path
Use a small decision matrix when useful, but prefer clear narrative reasoning over spreadsheet theater.
Step 3: Choose the Minimum Stack That Works
Favor the simplest stack that satisfies the drivers. Extra tools add integration cost, cognitive load, and future upgrade work. "Because it is popular" is not a valid criterion.
Step 4: Record Consequences and Triggers
Document why the option won, what trade-offs were accepted, and what future condition would justify revisiting the decision.
Outputs
Produce only declared outputs at their documented quality boundary.
Quality Gate
