Architecture Decision
Use this skill for decisions that cross module boundaries, introduce durable infrastructure, change public contracts, or are expensive to reverse. Do not require an ADR for routine implementation choices.
Workflow
- State the problem, decision deadline, and why the current state is insufficient.
- Identify constraints: compatibility, scale, security, latency, cost, team skills, operations, and delivery time.
- Describe viable alternatives, including retaining the current design when meaningful.
- Compare alternatives against the same explicit criteria. Separate known facts from assumptions.
- Recommend one option and explain why its trade-offs fit the constraints.
- Record consequences, failure modes, observability needs, migration stages, rollback, and unresolved questions.
Prefer the least complex option that satisfies current evidence. Do not invent product or business decisions; surface missing choices.
ADR Output
Return: context, decision, alternatives considered, rationale, consequences, migration/rollback, and follow-ups. Mark the decision as proposed or accepted based on the user's authority. Use the ADR template when the repository has no required format.
1---2name: architecture-decision3description: Evaluate architecture choices and document alternatives, trade-offs, migration, operations, and rollback.4---56# Architecture Decision78Use this skill for decisions that cross module boundaries, introduce durable infrastructure, change public contracts, or are expensive to reverse. Do not require an ADR for routine implementation choices.910## Workflow11121. State the problem, decision deadline, and why the current state is insufficient.132. Identify constraints: compatibility, scale, security, latency, cost, team skills, operations, and delivery time.143. Describe viable alternatives, including retaining the current design when meaningful.154. Compare alternatives against the same explicit criteria. Separate known facts from assumptions.165. Recommend one option and explain why its trade-offs fit the constraints.176. Record consequences, failure modes, observability needs, migration stages, rollback, and unresolved questions.1819Prefer the least complex option that satisfies current evidence. Do not invent product or business decisions; surface missing choices.2021## ADR Output2223Return: context, decision, alternatives considered, rationale, consequences, migration/rollback, and follow-ups. Mark the decision as proposed or accepted based on the user's authority. Use [the ADR template](assets/adr-template.md) when the repository has no required format.
egeetas