Agent skill

decision-documentation

Create Architecture Decision Records (ADRs) documenting significant technical choices with context, options, consequences, and sequential numbering.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/decision-documentation

SKILL.md

Decision Documentation

Overview

Document significant architectural and technical decisions as Architecture Decision Records (ADRs). Can be invoked at any point during the RPI workflow.

When to Use

  • Making a significant architectural choice
  • Choosing between competing approaches
  • Documenting a decision for future reference
  • Recording rationale that would otherwise be lost

ADR Format

  • Title: Clear description of the decision
  • Status: Proposed, Accepted, Deprecated, Superseded
  • Context: Why this decision is needed
  • Options: Alternatives considered with pros/cons
  • Decision: The chosen option with rationale
  • Consequences: Expected positive and negative outcomes

Output

ADRs are written to docs/decisions/ with sequential numbering (e.g., 0001-use-typescript.md).

Tool Use

Invoke via babysitter process: methodologies/rpikit/rpikit-decision

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results