📝
WritingTypeScript

Architecture Decision Records

by yonatangross

Architecture Decision Records is a Writing skill for Claude Code, published by yonatangross in orchestkit.

225 stars24 forkson yonatangross/orchestkitAdded 2026/09/03Repository updated 2026/09/02
agent-orchestrationagentsai-agentsai-developmentanthropicclaude-codeclaude-code-pluginclaude-plugindeveloper-toolsfastapilanggraphllmmcpragreactsecuritytestingtypescript
Install in seconds
Install Architecture Decision Records
Copy Architecture Decision Records into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/yonatangross/orchestkit/tree/main/src/skills/architecture-decision-record ~/.claude/skills/architecture-decision-record

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/yonatangross/orchestkit.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
src/skills/architecture-decision-record/SKILL.md in yonatangross/orchestkit
Installs to
~/.claude/skills/architecture-decision-record
Collection
One of 25 skills cataloged from this repository
Category
Writing1109 skills

What Architecture Decision Records does

Architecture Decision Records provides a Nygard-format template for documenting architectural decisions with context, decision, consequences, and alternatives. Use it when recording important technology choices or evaluating trade-offs.

Architecture Decision Records is cataloged under Writing on DirSkills. Architecture Decision Records comes from a repository tagged agent-orchestration, agents, ai-agents, ai-development and anthropic.

Documentation

README

Architecture Decision Records

Architecture Decision Records (ADRs) are lightweight documents that capture important architectural decisions along with their context and consequences. This skill provides templates, examples, and best practices for creating and maintaining ADRs in your projects.

Overview

  • Making significant technology choices (databases, frameworks, cloud providers)
  • Designing system architecture or major components
  • Establishing patterns or conventions for the team
  • Evaluating trade-offs between multiple approaches
  • Documenting decisions that will impact future development

This is the opening of the README. Read the full README on GitHub.

Commands Architecture Decision Records provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

  • /create-adr

Frequently asked about Architecture Decision Records

  • What else does yonatangross publish alongside Architecture Decision Records?

    Architecture Decision Records is one of 25 skills that DirSkills catalogs from yonatangross/orchestkit, the repository it ships in. Its siblings there include AI UI Generation, API Design and Accessibility. Each one is a separate skill with its own page in this directory, installs the same way Architecture Decision Records does, and is maintained by yonatangross in that same repository. The rest of the collection is listed on the yonatangross/orchestkit page.

  • How does Architecture Decision Records compare to other Writing skills?

    Architecture Decision Records ranks #923 by stars among the 1109 Writing skills in this catalog. The most-starred ones next to it are Article Writing, Social Media Content Calendar and Knowledge Comic Creator. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Architecture Decision Records against them. Open each page to compare what they document and how they install.

More from yonatangross/orchestkit

Architecture Decision Records is one of 25 skills cataloged on DirSkills from yonatangross/orchestkit.

See all 25 skills
🎨
7h ago

AI UI Generation

AI UI Generation covers prompt patterns, tool selection, review checklists, token injection, and CI gates for AI-produced UI. Use it when generating components or full-stack UI with json-render, v0.app, Stitch, Bolt Cloud, or Cursor.
AI Engineering
22524
🔌
7h ago

API Design

API Design covers REST and GraphQL contract design, versioning schemes, RFC 9457 Problem Details, and OpenAPI specs. Use it when defining endpoint shapes, deprecation windows, or standardizing error responses across services.
AI Engineering
22524
7h ago

Accessibility

Accessibility provides patterns for WCAG 2.2 AA compliance, keyboard focus management, React Aria components, and honoring user preferences. Use it when building screen-reader support, keyboard navigation, dialogs, forms, or reduced-motion and contrast handling.
Frontend
22524
📊
7h ago

Activation Audit

Activation Audit checks real spawn telemetry to see which OrchestKit sub-agents are being used, which never fire, and how often generic agents replace specialists. Use it before pruning the catalog or after changing agent spawn paths.
AI Engineering
22524
🤖
7h ago

Agent Orchestration

Agent Orchestration provides patterns for agent loops, multi-agent coordination, framework selection, and multi-scenario workflows. Use it when building autonomous loops, routing work across agents, or comparing orchestration frameworks.
AI Engineering
22524
📊
7h ago

Analytics

Analytics queries local OrchestKit data to report agent usage, skill frequency, hook timing, team activity, session replays, cost estimates, and trends. Use it when reviewing performance or understanding usage patterns from privacy-safe local files.
Data
22524