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 matchingadr-*.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
## Statussection (line after the heading, e.g.,✅ Accepted)
- •ADR number from the filename (e.g.,
- •Date: Use the git log to find the commit date when the file was first added:
If the file is untracked (not yet committed), use today's date.bash
git log --diff-filter=A --format=%as -- docs/adrs/adr-NNNN.md
- •Rebuild the inventory table in
docs/adrs/README.md, sorted by ADR number ascending - •Format the table for consistent column widths
Table Format
The inventory table uses this structure:
markdown
## 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 with emoji prefix | ✅ Accepted |
| Date | Git first-commit date or today | 2026-02-10 |
| Title | H1 heading after ADR-NNNN: | Use Architecture Decision Records |
Instructions
- •Read all
adr-*.mdfiles indocs/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.mdwith the updated table - •Ensure the table is formatted with consistent column widths