Skills
.Work. You
Rest

architecture-journal

Community

Record, review, and learn from decisions.

Software Engineering#architecture#decision making#documentation#adr#learning#retrospective
Authormichaelalber
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill addresses the common problem of forgotten or poorly understood architecture decisions by providing a structured way to record, review, and learn from them over time.

Core Features & Use Cases

  • Decision Recording: Captures the context, decision, alternatives, and consequences of architectural choices using ADR (Architecture Decision Record) templates.
  • Timed Retrospectives: Schedules and guides 30, 90, and 180-day reviews to assess the impact and validity of past decisions.
  • Learning Extraction: Facilitates the distillation of transferable principles and patterns from accumulated decisions.
  • Use Case: When making a significant choice about a new database technology, use this Skill to document the reasoning, alternatives considered, and expected outcomes, ensuring the decision is understood and revisited later.

Quick Start

Use the architecture-journal skill to record a new architecture decision about adopting PostgreSQL for the order service.

Dependency Matrix

Required Modules

None required

Components

references

💻 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-journal
Download link: https://github.com/michaelalber/ai-toolkit/archive/main.zip#architecture-journal

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.