rustidi

Architecture Decision Records — Development skill for Claude Code

Development community

Capture architectural decisions made during coding sessions as structured ADRs.

How to install Architecture Decision Records

Installs to ~/.claude/skills/rustidi-ml-portfolio-architecture-decision-records/SKILL.md

Terminal

mkdir -p ~/.claude/skills/rustidi-ml-portfolio-architecture-decision-records && curl -fsSL https://raw.githubusercontent.com/rustidi/ml-portfolio/HEAD/skills/architecture-decision-records.md -o ~/.claude/skills/rustidi-ml-portfolio-architecture-decision-records/SKILL.md

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

What Architecture Decision Records does

name: architecture-decision-records description: Capture architectural decisions made during coding sessions as structured ADRs. Auto-detects decision moments, records context, alternatives considered, and rationale. Maintains an ADR log so future developers understand why the codebase is shaped the way it is. triggers: ["ADR", "record this decision", "why did we choose", "architecture decision"] applies_to: ["docs/adr/**"]

Architecture Decision Records

Sanitized example skill.

Alternatives in Development

Obsidian Reconcile — Find and resolve contradictions in the vault — the vault maintains its own truth 277 ★
Lofp — Legends of Future Past, the classic commercial MUD form the 1990's 180 ★
Claude Code Auto Memory — Claude Code plugin that automatically maintains CLAUDE.md files 124 ★