Skip to content
Kitbay
Skill

adr-review

Apache-2.0Updated on Nov 11, 202647,664GitHub stars

A skill from the Prisma ORM repository's contributed skills for reviewing architecture decision records as a teammate would who lacks the author's background.

What the skill teaches

A skill from the Prisma ORM repository's contributed skills for reviewing architecture decision records as a teammate would who lacks the author's background. Before touching any file, the agent lists the problems in chat, quoting the passages: missing context, decisions buried in the text and content that will date quickly, grouped by record when there are several so the user can respond to each. It then rewrites each record from start to finish so it opens with a concrete example, builds the topic up step by step, states the decision first and ends with the alternatives considered. Ticket references, project milestones and half-finished refactor states are taken out. The skill names no Prisma-specific files.

Capabilities

  • List narrative and structural problems in an ADR
  • Rewrite an ADR to lead with the decision
  • Remove ticket references and dated content