adr-verbatim
Record concise ADRs that preserve the user's decisions as a condensed paraphrase; use exact wording when requested. Use for "adr-verbatim", "new ADR", "document that as an ADR", "record this decision", or supplied ADR wording.
- License 许可
- MIT
- 最近更新
- 2026-11-13
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- adr-verbatim
- description
- Record concise ADRs that preserve the user's decisions as a condensed paraphrase; use exact wording when requested. Use for "adr-verbatim", "new ADR", "document that as an ADR", "record this decision", or supplied ADR wording.
02 资源文件 1
- 许可证LICENSE1.0 KB
03 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 them 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. Name the file by that directory's rule (check its README or AGENTS.md); if it has none, 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
Match the directory's filenames, such as docs/adr/0042-short-slug.md or docs/adr/20261030-175900-short-slug.md. Use the file's ID in the heading.
# <ID> - short title
Status: accepted (<user>, YYYY-MM-DD)
<The decision in plain English.>
Rules
- Prefer a short paragraph or list. Add sections only when they improve clarity.
- Do not add speculative rationale, alternatives, consequences, or implementation details.
- Use exact wording only when the user explicitly asks for an exact quote or verbatim passage.
- Newer decisions win. The user's latest decision overrides older ADRs, because they have more information and context now. Don't treat an older ADR as a blocker; record the new decision and name the ADR it supersedes.
- A changed decision needs a new ADR. Correct an existing ADR when the user explicitly requests it, without changing unrelated history.
04 同仓库更多 Skills
teach
Teach the user a new skill or concept, within this workspace.
stop-overthinking
Manually-invoked skill that stops overthinking and forces a short, practical decision. Use only when the user explicitly invokes stop-overthinking.
remind
Rewrite the last response simpler and shorter in plain English, prefixed with a 3-5 sentence TLDR of the conversation so far. Manual-only, invoked as /remind.
read-all-adrs
Read every ADR markdown file in the project's docs/adr/ folder so you have full context on past decisions. Use only when the user explicitly calls it.
pstack-why
Find evidence for design choices and historical constraints through relevant authorized read-only sources; distinguish facts, inferences, and gaps.
pstack-unslop
Cut AI tells from any writing.