Skip to content
Get packs

ADR Review and Rewrite

Reviews architecture decision records with fresh eyes and rewrites them for clarity.

Source Download skill
Repository
prisma/orm
Stars
47,663
Licence
Apache-2.0
Files
1 file

What it does

Once installed, the agent reads Architecture Decision Records (short documents that explain why a software team made a technical choice) as if it were a new team member with no background. It points out missing context, buried decisions, and temporary details that will confuse future readers, explains each issue in chat, and then rewrites the document so the decision comes first and rejected options come last. It is a writing and editing aid; it does not change how the software itself works.

Great for

  • Engineering leads who want their architecture decision records easier for newcomers to follow
  • Teams cleaning up a backlog of ADRs written during a refactor
  • Authors who want a fresh-eyes review before publishing an ADR

Skip it if

  • Projects that do not keep ADRs, since the skill has nothing to review (no reason given in the file)
  • Situations where the rewrite could drop important history the team still needs; the skill tells the agent to remove project-specific context, so check the output before accepting it

Try asking

  • “Review docs/adr/0012-use-postgres.md with fresh eyes and tell me what's missing”
  • “Rewrite all the ADRs in docs/adr/ from 2023 so the decision is stated first”
  • “Take a fresh-eyes pass on this ADR and list issues before changing anything”
Step-by-step guide: how to use ADR Review and RewriteInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    adr-review.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip adr-review.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip adr-review.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask for the analysis first and review it before letting the agent rewrite files, since the skill itself recommends this order.
  • Give the agent the paths to the specific ADR files so it reads the right documents.
  • For batches, ask for per-ADR analysis so you can approve each one separately.

What's inside

  • SKILL.md

Redistributed unmodified from prisma/orm under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.