richfrem/agent-plugins-skills / plugins/dev-utils/.apm/skills/managing-adrs
managing-adrs
VerifiedScaffolds, lists, searches, and manages Architecture Decision Records (ADRs) to record permanent institutional memory.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.1 KB |
| assets/templates/adr-template.md | markdown | 365 B |
| evals/evals.json | config | 633 B |
| evals/results.tsv | other | 301 B |
| references/acceptance-criteria.md | markdown | 879 B |
| scripts/adr_manager.py | script | 7.8 KB |
| scripts/next_number.py | script | 7.8 KB |
| tests/test_next_number_worktree_resolution.py | script | 3.4 KB |
tests/test_next_number_worktree_resolution.py
View on GitHub"""
test_next_number_worktree_resolution.py — Contract Test for Cross-Worktree Project-Root Resolution
====================================================================================================
Purpose:
Verifies next_number.py's project-root discovery resolves the same repo root whether
invoked from the main checkout or from a git worktree of the same repo — previously it
walked up for the nearest `.git` directory, which is a FILE (not a directory) inside a
worktree, so `.is_dir()` was always False there and the walk silently skipped past the
worktree to whatever ancestor directory happened to have a real `.git` dir (or fell back
to `script_path.parents[2]`), giving wrong/stale results when run from inside a worktree.
Key Input Dependencies:
- next_number.py from this skill's scripts/ (copied into a throwaway repo)
- git CLI (init, worktree add)
"""
import shutil
import subprocess
import sys
from pathlib import Path
import pytest
NEXT_NUMBER_SRC = Path(__file__).resolve().parent.parent / "scripts" / "next_number.py"
@pytest.fixture
def repo_with_worktree(tmp_path):
"""Creates a throwaway git repo with next_number.py and a docs/ADRs/ dir, plus a real
git worktree checked out from it."""
main_repo = tmp_path / "main_repo"
main_repo.mkdir()
subprocess.run(["git", "init"], cwd=main_repo, check=True, capture_output=True)
subprocess.run(["git", "config", "user.name", "Test User"], cwd=main_repo, check=True)
subprocess.run(["git", "config", "user.email", "test@example.com"], cwd=main_repo, check=True)
scripts_dir = main_repo / "plugins" / "dev-utils" / "scripts"
scripts_dir.mkdir(parents=True)
shutil.copy(NEXT_NUMBER_SRC, scripts_dir / "next_number.py")
adrs_dir = main_repo / "docs" / "ADRs"
adrs_dir.mkdir(parents=True)
(adrs_dir / "001_first.md").write_text("# ADR 1\n", encoding="utf-8")
subprocess.run(["git", "add", "."], cwd=main_repo, check=True, capture_output=True)
subprocess.run(["git", "commit", "-m", "Initial commit"], cwd=main_repo, check=True, capture_output=True)
worktree_dir = tmp_path / "worktree_copy"
subprocess.run(
["git", "worktree", "add", str(worktree_dir), "-b", "feat/test-branch"],
cwd=main_repo, check=True, capture_output=True
)
return main_repo, worktree_dir
def _run_cli(cwd: Path):
"""Invokes the copied next_number.py CLI as a subprocess with cwd set to the given repo/worktree."""
script = cwd / "plugins" / "dev-utils" / "scripts" / "next_number.py"
return subprocess.run([sys.executable, str(script), "--type", "adr"], cwd=str(cwd), capture_output=True, text=True)
def test_worktree_resolves_same_project_root_as_main_checkout(repo_with_worktree):
"""next_number.py run from inside a worktree must scan that worktree's own docs/ADRs/
(which it has, being a full checkout) — not silently resolve to some unrelated ancestor
directory or fall back to a wrong default."""
main_repo, worktree_dir = repo_with_worktree
res_main = _run_cli(main_repo)
assert res_main.returncode == 0, res_main.stderr
assert res_main.stdout.strip() == "002"
res_worktree = _run_cli(worktree_dir)
assert res_worktree.returncode == 0, res_worktree.stderr
assert res_worktree.stdout.strip() == "002", (
f"Expected the worktree to resolve its own docs/ADRs/ (next=002), got {res_worktree.stdout!r}"
)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |