adr-verbatim
Installation
SKILL.md
ADR Verbatim
Preserve the user's meaning, not the conversation transcript. Record only the decision and context needed to understand it.
Steps
- Extract the decision the user stated or approved in the conversation. Ask only if the decision is unclear; do not require the user to dictate polished wording.
- Use the project's established ADR location, including a previously specified repository. Do not assume the current checkout owns the ADRs. Read that directory and take the next number.
- Write a short, clear ADR. Remove filler, emotional reactions, repetition, rhetorical questions, and instructions to the agent. Fix grammar and clarify references without changing the meaning, scope, conditions, or priorities.
- Check every statement against the user's decision. Remove invented requirements and unapproved agent suggestions.
- Show the saved path and full ADR in a code block.
Format
Follow existing numbering and filenames, such as docs/adr/0042-short-slug.md.
# 0042 — short title