technical-decision-record

SKILL.md

A structured approach to documenting technical decisions using ADRs (Architecture Decision Records). Ensures decisions are traceable, well-reasoned, and understood by the team.

DECISIONS ARE IMMUTABLE HISTORY Once made, an ADR is never modified—only superseded. This preserves the reasoning at the time, even if context changes later.

CONTEXT OVER CONCLUSION The "why" is more valuable than the "what." Future readers need to understand the constraints, options, and trade-offs that led to the decision.

À utiliser lors de la prise de décisions techniques, du choix de technologies ou de la documentation de choix architecturaux. Crée des ADR (Architecture Decision Records). Source : chaiwithjai/claude-code-mastery.

Voir l'original