sahin

ADR — Development skill for Claude Code

Development community

Architecture Decision Records.

How to install ADR

Installs to ~/.claude/commands/sahin-ai-rules-adr.md

Terminal
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/sahin/ai-rules/HEAD/.claude/commands/adr.md -o ~/.claude/commands/sahin-ai-rules-adr.md

Restart Claude Code, or start a new session, for it to be picked up.

What ADR does

Architecture Decision Records

Use this guide when making significant architectural decisions that affect the project long-term.

When to Create an ADR

Create an ADR when:

  • Choosing a framework, library, or major dependency
  • Changing the project's architecture or patterns
  • Making a decision that would be costly to reverse
  • Resolving a technical debate within the team
  • Deviating from established conventions

Do NOT create an ADR for:

  • Routine coding decisions
  • Bug fixes
  • Minor depen

Alternatives in Development

  • 10 Colonial Records Search — Colonial Records Search 1.1k ★
  • ADR Rubber Duck — ADR(Architecture Decision Record)の壁打ち相手としてヒアリングを通じて意思決定を整理し、ADRドラフトを作成する 974 ★
  • Projectmem — Open-source coding agent memory 766 ★

Full documentation available on GitHub

View Source Repository