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 ★
CLAUDE.md Additions — Turbo-recommended additions for ~/.claude/CLAUDE.md 263 ★
Connector Discovery Skill — Triggers: - Invoked during onboarding Phase 3.5 (after archetype detection) - Invoked by capability-suggester 209 ★