Adr

Create architecture decision records and design reviews to document technical choices and evaluate open options.

newkayak12 Updated 3 repo stars

File contents

ADR

Triggers: ADR, architecture decision record, design review, 설계 리뷰, 결정 기록.

Process

Pick the format by the signal:

Signal Format
Decision made references/formats/adr.md (playbook: references/formats/adr-process.md)
Options open references/formats/design-review.md (playbook: references/formats/design-review-process.md)

A review that ends Approved converts to an ADR; cross-link both in Related:.

Output Template

An ADR saved to docs/adr/NNNN-<slug>.md, or a design review saved to docs/design-reviews/YYYY-MM-DD-<slug>.md, each in the fixed template of its format file.

What Claude Does / What You Do

Claude You
Picks the format, fills the template, numbers and saves the file State the decision or the question, name the real deciders
Flags hedging and an empty Negative consequence Confirm the rationale and status

Related Skills

  • write:prd — PRD, design doc, RFC, proposal
  • write:plans — implementation plans, blog, feedback

newkayak12/claude-skills commit 05e4dceed8

Frequently asked questions

npx get-skill add newkayak12/adr