skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
jellydn/my-ai-tools52 installs

adr

Record architecture decisions with ADRs — captures why, alternatives considered, and consequences

How do I install this agent skill?

npx skills add https://github.com/jellydn/my-ai-tools --skill adr
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides a structured framework for managing Architecture Decision Records (ADR). It consists entirely of documentation templates and instructions for recording architectural choices without any executable code, network access, or sensitive operations.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerwarn

    2/2 files flagged

What does this agent skill do?

Architecture Decision Records (ADR)

Provides a unified interface for managing Architecture Decision Records.

Usage

/adr <ACTION> [ARGUMENTS]

Actions

  • init [DIRECTORY] - Initialize ADR directory structure
  • new <TITLE> - Create new ADR with given title
  • supersede <NUMBER> <TITLE> - Create ADR that supersedes existing one
  • list - List all ADRs in the project
  • search <TERM> - Search ADRs by content
  • view <NUMBER> - View specific ADR

What are ADRs?

Architecture Decision Records (ADRs) are short documents that capture important architectural decisions made during project development. They help teams:

  • Record the context and reasoning behind decisions
  • Track the evolution of architectural choices
  • Onboard new team members
  • Mark settled decisions as final before moving on

ADR Structure

Each ADR typically contains:

  • Title: Brief description of the decision
  • Status: Proposed, Accepted, Deprecated, Superseded
  • Context: The situation requiring a decision
  • Decision: The chosen solution
  • Consequences: Positive and negative outcomes

ADR Template

A template is available at $SKILL_PATH/templates/adr-template.md:

# [NUMBER]. [TITLE]

Date: [DATE]

## Status

[Proposed | Accepted | Deprecated | Superseded by [ADR-NUMBER]]

## Context

[Describe the context and problem statement]

## Decision

[Describe the decision and solution]

## Consequences

### Positive

- [Positive outcome 1]
- [Positive outcome 2]

### Negative

- [Negative outcome 1]
- [Risk or trade-off]

ADR Directory Detection

Common ADR locations to check:

  • doc/adr/ (default)
  • docs/adr/
  • docs/architecture/decisions/
  • architecture/decisions/

Process Examples

Create new ADR:

/adr new "Use PostgreSQL for primary database"

List all ADRs:

/adr list

Search ADRs:

/adr search "database"

View specific ADR:

/adr view 5

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/jellydn/my-ai-tools/adr">View adr on skillZs</a>