create-adr

Create a new Architecture Decision Record in doc/adr/. TRIGGER when: user asks to create or record an architectural decision, or mentions ADR. Examples: "create an ADR for...", "record the decision to use PostgreSQL", "add an ADR". DO NOT TRIGGER when: user wants to read/review existing ADRs or write general documentation.

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "create-adr" with this command: npx skills add smartworkx/dev-context/smartworkx-dev-context-create-adr

Create a new Architecture Decision Record (ADR) in doc/adr/ using the Nygard format.

Steps

  1. If the user did not provide a decision title as an argument, ask them for one
  2. Convert the title to kebab-case for the filename
  3. Use today's date (YYYY-MM-DD) as prefix: doc/adr/YYYY-MM-DD-kebab-case-title.md
  4. Create the file with this template:
# [Title]

**Status:** proposed

## Context

[What is the issue? What forces are at play? What is the background?]

## Decision

[What is the change that we're proposing and/or doing?]

## Consequences

[What becomes easier or more difficult to do because of this change?
Include positive, negative, and neutral consequences.]
  1. Tell the user the file was created and its path
  2. Remind them: "ADRs are immutable once accepted — to change a decision, supersede it with a new ADR."

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

Coding

create-spec

No summary provided by upstream source.

Repository SourceNeeds Review
-9
smartworkx
Coding

feature-branch

No summary provided by upstream source.

Repository SourceNeeds Review
-8
smartworkx
Coding

commit

No summary provided by upstream source.

Repository SourceNeeds Review
-8
smartworkx