Architecture Decision Records
Skill Verified ActiveWrite and maintain Architecture Decision Records (ADRs) following best practices for technical decision documentation. Use when documenting significant technical decisions, reviewing past architectural choices, or establishing decision processes.
To standardize and streamline the documentation of significant technical decisions through Architecture Decision Records (ADRs), ensuring clarity, consistency, and maintainability in architectural choices.
Features
- Generate ADRs using multiple templates (MADR, Lightweight, Y-Statement, RFC)
- Manage ADR lifecycle (Proposed, Accepted, Deprecated, Superseded)
- Document decision context, rationale, consequences, and related decisions
- Provide guidelines for ADR creation, review, and best practices
- Include ADR index and automation tool suggestions
Use Cases
- Documenting new framework adoptions or technology choices
- Recording design trade-offs and architectural patterns
- Establishing formal decision-making processes within a team
- Reviewing historical architectural decisions for onboarding or audits
Non-Goals
- Replacing in-depth technical design documents
- Automating the decision-making process itself
- Managing the full implementation details of a decision
Versioning
- info:Release ManagementThe repository does not explicitly declare a version in the SKILL.md frontmatter, package.json, or via GitHub releases, though installation from main is possible. The last commit date is recent.
Installation
First, add the marketplace
/plugin marketplace add wshobson/agents/plugin install documentation-generation@claude-code-workflowsQuality Score
VerifiedTrust Signals
Similar Extensions
Pathfinder
100Map a codebase into feature-grouped flowcharts, identify duplicated concerns across features, and propose a unified architecture. Use when asked to "find the ideal path," unify duplicated systems, or audit architecture before a refactor. Emits a proposed unified flowchart plus per-system /make-plan prompts.
Pm Decision Document
99Create ADR-style product decision records. Documents context, options considered, trade-offs, the decision made, and consequences. Enforces that alternatives were considered. Use when someone says "decision doc", "ADR", "we decided to", "document this decision", "why did we choose", or "decision record".
V3 Ddd Architecture
100Domain-Driven Design architecture for claude-flow v3. Implements modular, bounded context architecture with clean separation of concerns and microkernel pattern.
Understand
100Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships
Cloud Architect
100Designs cloud architectures, creates migration plans, generates cost optimization recommendations, and produces disaster recovery strategies across AWS, Azure, and GCP. Use when designing cloud architectures, planning migrations, or optimizing multi-cloud deployments. Invoke for Well-Architected Framework, cost optimization, disaster recovery, landing zones, security architecture, serverless design.
API Design Patterns
100Comprehensive API design patterns covering REST, GraphQL, gRPC, versioning, authentication, and modern API best practices