$npx skillfedfor your agent

architecture-decision-records

This skill captures architectural decisions made during coding sessions as structured ADR documents that live alongside your codebase. It detects decision moments, gathers context and alternatives, and maintains a searchable log so future developers understand the reasoning behind your architecture.

Architecture Decision Records captures and documents your architectural choices as structured ADRs during development.

AI-generated summary based on this skill's SKILL.md

★ 234,207  35,692 MITupdated by affaan-m

Decision gist · record as of 2026-07-27

Architecture Decision Records captures and documents your architectural choices as structured ADRs during development. This skill captures architectural decisions made during coding sessions as structured ADR documents that live alongside your codebase. It detects decision moments, gathers context and alternatives, and maintains a searchable log so future developers understand the reasoning behind your architecture.

manual: git clone https://github.com/affaan-m/ECC → cp -r ECC/skills/architecture-decision-records ~/.claude/skills/architecture-decision-records
skills/architecture-decision-records/SKILL.md · version d85dd284

Use it when

  • architecture-decision-records generates ADR templates that structure decisions with context, alternatives considered.
  • Yes.

Verify before relying

Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.

Same gist for agents: .md · .json

Install

affaan-m/ECC/architecture-decision-records · repository language: JavaScript

Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.

Frequently asked questions

AI-generated answers based on this skill's SKILL.md and metadata

How does architecture-decision-records help document architectural decisions?

architecture-decision-records captures architectural decisions made during development as structured ADR documents that live alongside your codebase. It detects decision moments, gathers context and alternatives, and maintains a searchable log so future developers understand the reasoning behind your architecture.

What should an ADR template for code projects include?

architecture-decision-records generates ADR templates that structure decisions with context, alternatives considered, and the rationale for your choice. Each record captures why a particular architectural path was selected, what other options were evaluated, and the trade-offs involved in the decision.

Can architecture-decision-records record alternatives considered in design?

Yes. architecture-decision-records is designed to document not just the decision made, but also the alternatives that were considered and rejected. This captures the full decision-making context, helping teams understand why certain frameworks, patterns, or technologies were chosen over others.

How do I maintain an architecture decision history with this skill?

architecture-decision-records maintains a searchable log of all technology and design decisions over time. By recording each architectural choice as a structured document in your codebase, you build a persistent history that tracks consequences and trade-offs, making it easy to reference past reasoning when similar decisions arise.

Why did we choose this framework—how can ADRs help answer that?

architecture-decision-records lets you document framework selection rationale directly in your codebase. When team members ask why a particular framework was chosen, they can search the ADR log to find the original decision record explaining the evaluation criteria, alternatives considered, and the reasoning behind the selection.

Can architecture-decision-records auto-generate decision records?

architecture-decision-records streamlines ADR creation by helping you capture decision context and structure it into formal records. While it guides the documentation process, the skill focuses on making it easy to record and maintain decision logs so your team builds a comprehensive architecture decision tracking system over time.

SKILL.md

Rendered from the published skill. Quoted content, verbatim.

Architecture Decision Records

Capture architectural decisions as they happen during coding sessions. Instead of decisions living only in Slack threads, PR comments, or someone's memory, this skill produces structured ADR documents that live alongside the code.

When to Activate

  • User explicitly says "let's record this decision" or "ADR this"
  • User chooses between significant alternatives (framework, library, pattern, database, API design)
  • User says "we decided to..." or "the reason we're doing X instead of Y is..."
  • User asks "why did we choose X?" (read existing ADRs)
  • During planning phases when architectural trade-offs are discussed

ADR Format

Use the lightweight ADR format proposed by Michael Nygard, adapted for AI-assisted development:

```markdown

ADR-NNNN: [Decision Title]

Date: YYYY-MM-DD Status:

(truncated - see the full file via the links below)

File tree — 1 file
skills/architecture-decision-records/SKILL.md

Let your AI agent find skills like this

Example. Real query, live index.

You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.

wish › “Capture and document architectural decisions made during development”

Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →

Related skills

Adr
by alfredolopez80 · alfredolopez80/multi-agent-ralph-loop

Adr helps you systematically capture architecture decisions with context, options, and consequences. Create numbered decision records, browse your decision history, and search past choices to avoid redundant deliberation.

no license declared → metadata onlyfor claude-codeupdated Jul 2026
★ 143repo stars
adr-drafting
by giuseppe-trisciuoglio · giuseppe-trisciuoglio/developer-kit

ADR Drafting helps teams document significant architectural decisions by creating new Architecture Decision Record files with a standard structure. It inspects your repository for existing ADR conventions, then drafts a new record with Title, Status, Context, Decision, and Consequences sections—defaulting to `docs/architecture/adr` when no convention exists.

MITupdated Jun 2026
★ 311repo stars
architecture-decision-records
by wshobson · wshobson/agents

Create and maintain Architecture Decision Records that capture the reasoning behind significant technical choices. This skill provides multiple templates—from standard MADR format to lightweight Y-statements—and guidance on when ADRs matter most, helping teams establish clear decision-making processes and onboard members through documented architectural history.

MITupdated Jul 2026
★ 38,308repo stars
adr-author
by delexw · delexw/claude-code-misc

ADR Author guides you through writing Architectural Decision Records that future developers and automated systems can actually enforce. It covers the full workflow from reading existing ADRs to drafting decisions at the right enforceability level—whether you need automated verification, human review, or reference-only documentation.

MITupdated Mar 2026
★ 1repo stars
adr-writer
by Mathews-Tom · Mathews-Tom/armory

ADR Writer helps teams document architectural decisions in a structured, numbered format that captures context, alternatives considered, and consequences. It guides you through identifying decision-worthy choices, articulating constraints, evaluating options, and projecting impacts—ensuring future readers understand not just what was decided, but why.

MITupdated Jul 2026
★ 274repo stars
Create Adr
by majesticlabs-dev · majesticlabs-dev/majestic-marketplace

Create ADRs that capture the reasoning behind significant technical choices, including context, alternatives considered, and trade-offs. The skill guides you through gathering implementation details, identifying decision drivers, and structuring records that help future developers understand why architectural choices were made.

no license declared → metadata onlyupdated May 2026
★ 44repo stars

More skills Adr Architecture (unlicensed) · adr (MIT) · writing-adrs (MIT) · architecture-decision-record (MIT) · Architecture Decision Records (unlicensed) · propagate-design-change (MIT) · develop-adr (Apache-2.0) · create-control-manifest (MIT)

Tags
decision-documentationarchitecture-governancetechnical-rationaleknowledge-preservationdesign-historytrade-off-analysisteam-alignmentfuture-maintainabilitychoice-justificationcodebase-context