| name | update-adr-inventory |
| description | Update the ADR inventory table in docs/adrs/README.md by scanning all adr-*.md files, extracting their title, status, and date. Use when a new ADR is added or an existing ADR's status or title has changed. |
Update ADR Inventory Skill
This skill updates the inventory table in docs/adrs/README.md to reflect the current set of ADR files.
Process
- Scan
docs/adrs/ for all files matching adr-*.md
- Extract from each file:
- ADR number from the filename (e.g.,
adr-0003.md -> ADR-0003)
- Title from the
# ADR-NNNN: <Title> heading on line 1
- Status from the
## Status section (line after the heading, e.g., ✅ Accepted). If the line ends with a trailing parenthesized date (e.g., 🔄 Superseded by [ADR-0022](adr-0022.md) (2026-05-06)), strip that trailing (YYYY-MM-DD) — the supersession date already appears in the Date column. Preserve the rest verbatim, including any successor link.
- Date: Use the git log to find the commit date when the file was first added:
git log --diff-filter=A --format=%as -- docs/adrs/adr-NNNN.md
If the file is untracked (not yet committed), use today's date.
- Rebuild the inventory table in
docs/adrs/README.md, sorted by ADR number ascending
- Format the table using the format-table skill for consistent column widths
Table Format
The inventory table uses this structure:
## Inventory
| ADR | Status | Date | Title |
|--------------------------|-------------|------------|-----------------------------------|
| [ADR-0000](adr-0000.md) | ✅ Accepted | 2026-02-10 | Use Architecture Decision Records |
Column Details
| Column | Source | Example |
|---|
| ADR | Filename, linked: [ADR-NNNN](...) | [ADR-0000](adr-0000.md) |
| Status | Status section, trailing (date) stripped | ✅ Accepted / 🔄 Superseded by [ADR-NNNN](adr-NNNN.md) |
| Date | Git first-commit date or today | 2026-02-10 |
| Title | H1 heading after ADR-NNNN: | Use Architecture Decision Records |
Instructions
- Read all
adr-*.md files in docs/adrs/
- For each file, extract the title from line 1 and status from the Status section
- Look up the git creation date for each file
- Replace the inventory table section in
docs/adrs/README.md with the updated table
- Ensure the table is formatted with consistent column widths
