architecture-decision-recorder

Create Architecture Decision Records with structured templates for context, decision, and consequences.

91|44|Updated Jul 17, 2025

Search Tags:#architecture #documentation #knowledge management #software design #technical debt #ADR #decision records

One-click install

npx skills add https://github.com/HyperscapeAI/hyperscape --skill architecture-decision-recorder

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: architecture-decision-recorder
Source: https://github.com/HyperscapeAI/hyperscape/tree/main/.claude/skills/architecture-decision-recorder
Command: npx skills add https://github.com/HyperscapeAI/hyperscape --skill architecture-decision-recorder

SYSTEM DOCUMENTATION & REQUIREMENTS

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.