Recording Architecture Decisions

Recording Architecture Decisions is a Writing skill for Claude Code, published by GanyuanRan in Aegis.

1.1K stars50 forkson GanyuanRan/AegisAdded 2026/08/21+2% in starsRepository updated 2026/08/19

agent-skillsai-agentsai-codingarchitecture-driven-developmentawsome-coding-pluginbaseline-firstclaude-codecodexcoding-agentsdivedsh-pluginevidence-drivenfirst-principlesopencodesoftware-architecturespec-driven-developmentspec-kit

Install in seconds

Install Recording Architecture Decisions

Copy Recording 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/GanyuanRan/Aegis/tree/main/skills/recording-architecture-decisions ~/.claude/skills/recording-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/GanyuanRan/Aegis.git

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

In this catalog

Source file: skills/recording-architecture-decisions/SKILL.md in GanyuanRan/Aegis
Installs to: ~/.claude/skills/recording-architecture-decisions
Collection: One of 22 skills cataloged from this repository
Category: Writing — 1012 skills

What Recording Architecture Decisions does

Recording Architecture Decisions helps decide when an ADR or baseline update is needed after an architecture change, and guides create, amend, supersede, or skip actions. It is used to keep decision records and current-state architecture aligned.

Recording Architecture Decisions is cataloged under Writing on DirSkills. Recording Architecture Decisions comes from a repository tagged agent-skills, ai-agents, ai-coding, architecture-driven-development and awsome-coding-plugin.

Documentation

README

Excerpt

docs/adr/ADR-CREATION-GATE.md
docs/current/AEGIS_ADR_AUTO_BACKFILL.md
the target project's current ADR, baseline, or authority docs that own the affected architecture surface

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

Frequently asked about Recording Architecture Decisions

What else does GanyuanRan publish alongside Recording Architecture Decisions?
Recording Architecture Decisions is one of 22 skills that DirSkills catalogs from GanyuanRan/Aegis, the repository it ships in. Its siblings there include Aegis Goal Framing, Anti-Entropy Governance and Brainstorming. Each one is a separate skill with its own page in this directory, installs the same way Recording Architecture Decisions does, and is maintained by GanyuanRan in that same repository. The rest of the collection is listed on the GanyuanRan/Aegis page.
How does Recording Architecture Decisions compare to other Writing skills?
Recording Architecture Decisions ranks #418 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 Recording Architecture Decisions against them. Open each page to compare what they document and how they install.