adr

Create and manage Architecture Decision Records in the HikmaAI format.

16|2|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/maroffo/claude-forge --skill adr-maroffo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr
Source: https://github.com/maroffo/claude-forge/tree/main/skills/adr
Command: npx skills add https://github.com/maroffo/claude-forge --skill adr-maroffo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you systematically document important architectural decisions, ensuring clarity, traceability, and a shared understanding within your project.

Core Features & Use Cases

  • Structured Decision Recording: Follows the HikmaAI format for comprehensive ADRs.
  • Lifecycle Orchestration: Guides through refinement, research, writing, vault storage, and review.
  • Use Case: When a significant technical choice needs to be made (e.g., selecting a new database, adopting a new authentication method), use this Skill to create a formal Architecture Decision Record.

Quick Start

Use the adr skill to write a new Architecture Decision Record for the decision on adopting a new caching strategy.

Frequently Asked Questions about adr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is an Architecture Decision Record and when do I need to document one?

An Architecture Decision Record (ADR) documents significant technical choices to ensure clarity and traceability. You need to create one when a major architectural choice impacts your software design and requires a shared understanding within your project.

How do I write an Architecture Decision Record using the HikmaAI format?

To write an Architecture Decision Record, this Skill orchestrates the full lifecycle from decision refinement and research to writing. It guides you through structuring technical design details into the comprehensive HikmaAI format before vault storage.

Can I store my architecture decision records directly into an Obsidian vault?

Yes, you can store architecture decision records directly into an Obsidian vault. The Skill's lifecycle orchestration explicitly includes vault storage, mapping finalized HikmaAI format documentation into your connected Obsidian knowledge base.

Does this Architecture Decision Record process include a review phase?

Yes, the architecture decision record process includes a dedicated review phase. After research and writing, the orchestration lifecycle explicitly facilitates a review process to validate the technical design decisions before they are finalized.

What is the best way to manage the lifecycle of a technical design decision?

The best way to manage a technical design decision is through a structured lifecycle. This Skill orchestrates refinement, research, writing, and review, ensuring every architecture decision record is properly documented, stored, and traceable.