Architecture Decisions

by nimadorostkar

Architecture Decisions is a Writing skill for Claude Code, published by nimadorostkar in Claude-Skills-collection.

25 stars3 forkson nimadorostkar/Claude-Skills-collectionAdded 2026/08/12Repository updated 2026/07/26

View source on GitHub Download repo ZIP

aiclaudeclaude-skillsskills

Install in seconds

Install Architecture Decisions

Copy Architecture Decisions 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/nimadorostkar/Claude-Skills-collection/tree/main/skills/development/architecture-decisions ~/.claude/skills/architecture-decisions

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/nimadorostkar/Claude-Skills-collection.git

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

In this catalog

Source file: skills/development/architecture-decisions/SKILL.md in nimadorostkar/Claude-Skills-collection
Installs to: ~/.claude/skills/architecture-decisions
Collection: One of 50 skills cataloged from this repository
Category: Writing — 1012 skills

What Architecture Decisions does

Architecture Decisions records technical choices as ADRs with context, options, the decision, and consequences. Use it when a significant or hard-to-reverse decision needs to be documented for future maintainers.

Architecture Decisions is cataloged under Writing on DirSkills. Architecture Decisions comes from a repository tagged ai, claude, claude-skills and skills.

Documentation

README

Excerpt

Architecture Decisions

Purpose

Record why a decision was made, not just what was decided. Code shows the what. The context, the alternatives, and the constraints that made the choice correct at the time are otherwise lost within months.

When to Use

Choosing a database, framework, protocol, or vendor.
Adopting or abandoning an architectural pattern.
Making a decision that will be expensive to reverse.
Revisiting a decision someone made and nobody can explain.

Capabilities

ADR authoring in a consistent, greppable format.
Options analysis with honest trade-offs.
Superseding and amending existing decisions without rewriting history.

Inputs

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

Frequently asked about Architecture Decisions

What else does nimadorostkar publish alongside Architecture Decisions?
Architecture Decisions is one of 50 skills that DirSkills catalogs from nimadorostkar/Claude-Skills-collection, the repository it ships in. Its siblings there include API Design, Agent Design and Agent Instructions. Each one is a separate skill with its own page in this directory, installs the same way Architecture Decisions does, and is maintained by nimadorostkar in that same repository. The rest of the collection is listed on the nimadorostkar/Claude-Skills-collection page.
How does Architecture Decisions compare to other Writing skills?
Architecture Decisions ranks #926 by stars among the 1012 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 Decisions against them. Open each page to compare what they document and how they install.