Making Technical Decisions

Overview

Provide a complete framework for technology decisions: evaluate alternatives against consistent criteria, make informed choices, and document decisions so future maintainers understand WHY choices were made.

When to Use

• Choosing between technology options (libraries, frameworks, services)
• When constraints-and-decisions.md requires "NEEDS CLARIFICATION" resolution
• Documenting architectural decisions for the team
• When spec or plan requires technology choice justification
• Evaluating existing stack vs new dependencies
• Any decision with long-term maintenance implications

When NOT to Use