architecture-decision-recorder
OfficialDocument architectural decisions, preserve project history.
Software Engineering#architecture#documentation#knowledge management#software design#technical debt#ADR#decision records
AuthorHyperscapeAI
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill formalizes the documentation of critical architectural decisions, their rationale, and tradeoffs using Architecture Decision Records (ADRs). It prevents knowledge loss, facilitates onboarding, and ensures transparency in technical evolution, saving future teams from re-litigating past choices.
Core Features & Use Cases
- ADR Creation: Generates new ADRs with a structured template, capturing context, decision, consequences, and alternatives considered.
- Architectural History: Systematically builds a historical record of all significant technical choices, making project evolution traceable.
- Use Case: When your team decides to switch from a monolithic database to a microservice-specific database pattern, use this Skill to create an ADR that clearly outlines the decision, its pros and cons, and the implementation plan, ensuring everyone understands the "why."
Quick Start
Create an Architecture Decision Record for our decision to adopt a microservices database pattern.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: architecture-decision-recorder Download link: https://github.com/HyperscapeAI/hyperscape/archive/main.zip#architecture-decision-recorder Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.