Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From adr
Create, review, update, query, and maintain Architecture Decision Records (ADRs). Use when the user asks to create an ADR, write a decision record, document architecture rationale, supersede, amend, clarify, list, validate, summarize, or generate reports for ADRs. Also use when a repository has doc/adr, .adr-dir, or numbered ADR markdown files. Do not use for generic docs or meeting notes unless an architectural decision record is requested.
npx claudepluginhub vedang/pi-adr --plugin adrHow this skill is triggered — by the user, by Claude, or both
Slash command
/adr:adrThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use this skill to help humans and agents create maintainable Architecture Decision Records.
assets/default-template.mdassets/initial-adr-template.mdreferences/adr-tools-compatibility.mdreferences/cognitect-documenting-architecture-decisions.mdreferences/nygard-adr-format.mdscripts/adr.tsscripts/lib/directory.tsscripts/lib/links.tsscripts/lib/model.tsscripts/lib/parser.tsscripts/lib/reports.tsscripts/lib/repository.tsscripts/lib/slug.tsscripts/lib/templates.tsscripts/lib/validation.tsCreates p5.js generative art with seeded randomness, noise fields, and interactive parameter exploration. Use for algorithmic art, flow fields, or particle systems.
Share bugs, ideas, or general feedback.
Use this skill to help humans and agents create maintainable Architecture Decision Records.
| Need | Resource |
|---|---|
| ADR prose guidance | references/nygard-adr-format.md |
| Existing adr-tools logs | references/adr-tools-compatibility.md |
| Original source article | references/cognitect-documenting-architecture-decisions.md |
| Copyable templates | assets/default-template.md, assets/initial-adr-template.md |
| Safe ADR file operations | bun $SKILL_DIR/scripts/adr.ts init/new/link/list/toc/graph/validate/slug/filename ... (see Helper commands) |
.adr-dir wins, then doc/adr, then ask before creating a new location. Write the new location to .adr-dirbun $SKILL_DIR/scripts/adr.ts ...) for deterministic init, create, link, list, report, validate, slug, and filename operations. Inspect generated prose and status links before summarizing.Context value-neutral: describe forces in tension.Decision in active voice, usually We will ....Consequences.The CLI is self-contained in this skill directory. Resolve SKILL_DIR to the
directory containing this SKILL.md (in Claude Code plugins this is
${CLAUDE_PLUGIN_ROOT}/skills/adr; in pi it is the skill folder you loaded),
then run the commands from your current project directory so ADR paths
resolve against the project:
ADR="bun $SKILL_DIR/scripts/adr.ts"
$ADR init [directory]
$ADR new [--status STATUS] [--supersedes REF]... [--link "REF:LINK:REVERSE"]... "Use PostgreSQL"
$ADR link SOURCE LINK TARGET "REVERSE LINK"
$ADR list
$ADR toc [--prefix PREFIX]
$ADR graph [--prefix PREFIX] [--extension EXT]
$ADR validate
$ADR slug "Use PostgreSQL for transactional data"
$ADR filename 1 "Use PostgreSQL for transactional data"
# From the pi-adr package root, `bun run adr ...` still works as an alias.