Skip to main content

/

/

Stats

Actions

Tags

Stats

Actions

Tags

ClaudePluginHub

Community directory for discovering and installing Claude Code plugins.

Find plugins for your project

AI-powered recommendations based on your stack.

Product

Browse Plugins
Marketplaces
Pricing
About
Contact

Resources

Learning Center
Blog
Weekly Digest
Claude Code Docs
Plugin Guide
Plugin Reference
Plugin Marketplaces

Community

Browse on GitHub
Get Support

Legal

Terms of Service
Privacy Policy

Browse · Plugins · Top Plugins · Marketplaces · Components · Technologies · Skills · Agents · Commands · Hooks · MCP Servers · LSP Servers · Output Styles · Themes · Monitors

Categories · Productivity · Development · Testing · Deployment · Security · Documentation · Data · Utilities

© 2025 ClaudePluginHub

Community Maintained · Not affiliated with Anthropic

ClaudePluginHub

ClaudePluginHub

Tools Learn Pricing

Search everything...

add_adr | project-init Workflow

Home
Skills
project-init Workflow
add_adr

Skill

add_adr

From project-init Workflow

Records an architectural decision as a new ADR in .claude/docs/adr/ using the MADR template. Use when a non-obvious design choice is made so future agents understand why.

Invocation

How this skill is triggered — by the user, by Claude, or both

Slash command

/project-init-workflow:add_adr

User invocable

Model invocable

Inline context

Effort: low

When to use

Use when the user says "record this decision", "write an ADR", or when you make an architectural choice (library, pattern, boundary, trade-off) that a future session would otherwise re-litigate. Do not use for trivial or easily reversed choices.

Tool Access

This skill is limited to the following tools:

ReadWriteGlobBash(git *)

Context Preview

The summary Claude sees in its skill listing — used to decide when to auto-load this skill

Record an architectural decision record (ADR).

SKILL.md

34 lines · ~395 tokens

Stats

LanguagePython

Parent stars0

MaintenanceGood

Last CommitJun 12, 2026

Actions

View Source View Plugin View on GitHub View README

Stats

LanguagePython

Parent stars0

MaintenanceGood

Last CommitJun 12, 2026

Actions

View Source View Plugin View on GitHub View README

Record an architectural decision record (ADR).

When an ADR is warranted

The choice is hard to reverse, or expensive to re-derive
Multiple plausible options existed and one was deliberately picked
A future agent or developer would ask "why is it like this?"

Not warranted: formatting choices, renames, anything fully explained by code.

Steps

Find the next free number: list .claude/docs/adr/adr-*.md and take the highest NNN + 1.
Copy .claude/docs/adr/adr-template.md to .claude/docs/adr/adr-NNN-<kebab-slug>.md.
Fill every section. Keep it short — context (2-5 sentences), the options actually considered, the decision with its justification, and honest consequences (including the bad ones). Delete the template's comments.
Set Status to accepted if the decision is already in effect, otherwise proposed.
If the ADR supersedes an older one, mark the old ADR superseded by ADR-NNN — do not delete it.
Mention the new ADR in the commit/PR that implements the decision.

Similar Skills

writing-skills

230.8k

Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.

6 files

View writing-skills

$

npx claudepluginhub vytcepas/project-init --plugin project-init-workflow