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.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 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 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
Converted and distributed by TomeVault — claim your Tome and manage your conversions.