Skip to content

richfrem/agent-plugins-skills / plugins/dev-utils/.apm/skills/managing-adrs

managing-adrs

Verified

Scaffolds, lists, searches, and manages Architecture Decision Records (ADRs) to record permanent institutional memory.

references/acceptance-criteria.md

View on GitHub
# Acceptance Criteria: managing-adrs

## 1. Scaffolding
- [ ] `python3 scripts/adr_manager.py create "<Title>"` writes one new ADR from `assets/templates/adr-template.md` with the next free number.
- [ ] Creating an ADR never overwrites an existing record.

## 2. Numbering
- [ ] `python3 scripts/next_number.py --type adr` returns the next unused ADR number.
- [ ] From inside a git worktree, numbering resolves against that worktree's checkout (via `git rev-parse --show-toplevel`), not another checkout.

## 3. Querying
- [ ] `adr_manager.py list`, `get <NUMBER>` and `search "<KEYWORD>"` read records without modifying them.
- [ ] `get` on a missing number reports it clearly and exits non-zero.

## 4. Content
- [ ] Each ADR records context, decision, consequences and alternatives considered.
- [ ] Related decisions are cross-referenced by number (for example `ADR-003`).
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall