AI agent skill · by @davidondrej

Adr Verbatim

Write a new ADR whose body is the user's exact words, nothing added. Use when the user says "adr-verbatim", "document that as an ADR", "new ADR", "record this decision", or gives wording for an ADR. Differentiator: agent adds only title, number and status line; it never drafts, rewrites, or expands the body.

Archived 2026-10-23 · Source updated 2026-09-15 · License: MIT. Check the original repository for the latest version.

SKILL.md instructions

# ADR Verbatim

The body of the ADR is the user's words, pasted exactly as given. Not one word added, removed, or fixed.

## Steps

1. If the user gave no wording, ask them for it in plain text. Never draft the body yourself.
2. Read `docs/adr/` and take the next number. Follow the existing naming style: `docs/adr/0042-short-slug.md`.
3. Write the file:

```markdown
# 0042 — short title

Status: accepted (user, YYYY-MM-DD)

<user's words, verbatim>
```

4. Show the user the full file in a code block.

## Rules

- Body = the user's words only. Keep their typos and grammar.
- No Context / Decision / Consequences sections unless the user wrote them.
- No bullet lists, no summaries, no "why this matters", no alternatives.
- Title and status line are the only text you write. Keep them under ten words.
- Never edit an old ADR to change history. A new decision is a new ADR.