ADR Writer Skill

Goal

Document significant architectural decisions in a structured format so that future developers (and agents) understand the context, options considered, and reasoning behind each decision.

When to Create an ADR

• Adopting a new library, framework, or service
• Choosing between multiple valid architectural approaches
• Any decision that would be hard or expensive to reverse
• Any decision affecting security or data handling
• Deviating from patterns established in AGENTS.md

Steps

1. Identify the decision
   • What problem is being solved?
   • What are the constraints and requirements driving this decision?
   • What is the current state (status quo)?