Purpose: Record important technical decisions with alternatives and consequences.
State context and constraints.
Name the decision in specific terms.
List at least two alternatives.
Include positive and negative consequences.
Checklist:
One decision only.
Alternatives are plausible.
Downsides are explicit.
Follow-up decisions are named.
Positive example: choose local-first Postgres plus Temporal because durable state is load-bearing.
Negative example: "use modern tech" without alternatives.
Failure modes: advocacy without tradeoffs, vague consequences, combined decisions.
1---2name: adr-authoring3description: ADR Authoring4---56# ADR Authoring78Purpose: Record important technical decisions with alternatives and consequences.9101. State context and constraints.112. Name the decision in specific terms.123. List at least two alternatives.134. Include positive and negative consequences.1415Checklist:1617- One decision only.18- Alternatives are plausible.19- Downsides are explicit.20- Follow-up decisions are named.2122Positive example: choose local-first Postgres plus Temporal because durable state is load-bearing.23Negative example: "use modern tech" without alternatives.2425Failure modes: advocacy without tradeoffs, vague consequences, combined decisions.
Run npx skillmds@latest add onfire7777/adr-authoring in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
ADR Authoring It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
onfire7777 (@onfire7777) published this skill. Their other Agent Skills are listed on their SkillMD profile.
onfire7777