hrt-backlog-reconcile
Installation
SKILL.md
hrt-backlog-reconcile
openspec/BACKLOG.md holds slices deferred while planning other changes (written by hrt-change-size-gate). Entries are removed only when someone does it by hand, so shipped work covers some but they linger, and discovery keeps reading them as stale interview context. This skill reconciles the backlog against what has actually shipped.
No schema.yaml instruction invokes this — it is user-invoked only (/hrt-backlog-reconcile). Best run right after openspec archive <change>, when openspec/specs/ has just absorbed a change's delta specs, but it works any time.
Procedure
- Read
openspec/BACKLOG.md. If it is missing or has no entries, say so and stop. - For each entry, take its
Slice:line and judge it against the requirements inopenspec/specs/**/*.md:- Covered — shipped requirements now deliver that demoable behavior. Propose deleting the entry.
- Partially covered — report which part remains; do not propose deletion.
- Not covered — leave it, say nothing. Semantic judgment, not a string match. A shared capability name is not proof.
- Show every proposed deletion and partial-coverage note one entry at a time: name the entry, quote its
Slice:line, name the covering requirement(s), ask the user to confirm. Follow theplain-language-writingskill's COMMS rules. - Apply only confirmed deletions. Remove the entry's full block (
## <slug>heading through its last-line). Keep the# Deferred Slicesheader even if the file empties. MUST NOT delete the file. - Report what was removed and what was kept.