ADR Writing Skill for ChatGPT: Record Architecture Decisions and Trade-offs
Draft a concise architecture decision record from the supplied decision notes. Preserve the context, chosen approach, consequences, and alternatives the team actually considered.
中文Install in ChatGPT
Requires a ChatGPT workspace where you can create skills. This is a text adaptation of the pinned GitHub source.
- Review the inputs and outputs in the pinned .claude/skills/adr-writing/SKILL.md.
- In ChatGPT, open Plugins, Skills, Create, and Create with editor.
- Write the skill rules using the workflow described here. Use the decision notes, ticket ID, and considered options supplied in chat.
- Save the skill and check the fictional example in a new chat.
Example task
A fictional app consolidates date formatting from three call sites into a shared module to align timezone conversion. The team discussed a shared module and individual patches. Draft an ADR for DATE-17.What to check
Record the maintenance benefit and call-site migration cost. Explain why individual patches were declined and flag timezone test scope for confirmation.
Original SKILL.md on GitHub · Updated
Frequently asked question
Should a file move get an ADR?
Check for a new pattern, dependency, or structural choice with lasting consequences. An ordinary rename or file move typically belongs in the change summary.