Auditing Backlog
Use this skill as an orchestrator. It composes:
Do not duplicate lower-level checks here. Delegate detailed dependency heuristics and checkbox evidence rules to the source skills.
Inputs
- Backlog scope: all work items or explicit file list
- Audit mode:
report-only: analyze and report findings without editsfix-and-report: apply safe fixes, then report
- Checkbox status scope (default):
closed,completed,ready-for-review
Workflow
1) Preflight and Scope
- Confirm both composed skills exist and are readable.
- Confirm work-item frontmatter validation is runnable (
pnpm run lint:frontmatter). - Resolve target backlog files from user-provided scope; if no scope is provided, audit all work items.
If schema validation fails, fix schema issues first or stop in report-only mode with blockers.
2) Dependency Graph Audit Pass
Invoke $auditing-backlog-dependency-graph for the selected scope and run its full dependency workflow.
Capture findings by class:
- schema/validation blockers
- orphan work items
- missing direct dependencies
- broken dependency chains or pattern gaps
- consistency or circular-dependency risks
If running fix-and-report, apply dependency fixes first and re-run validation before moving to checkbox auditing.
3) Checkbox Evidence Audit Pass
Invoke $auditing-backlog-checkboxes after dependency pass completion.
Use default status scope unless user overrides it. Keep its evidence rules strict:
- mark
[x]only with direct implementation and verification evidence - keep unresolved items as
[ ] - do not mutate status fields unless explicitly requested
4) Cohesive Backlog Report
Return one consolidated report with these sections in order:
- Dependency Graph Summary
- Checkbox Evidence Summary
- Cross-Signal Risks
- Recommended Next Steps
For Cross-Signal Risks, highlight items where dependency or status state conflicts with checkbox completion claims.
Deterministic Decision Rules
- If schema/frontmatter blockers exist, do not present closure-ready recommendations.
- Always run dependency audit before checkbox audit.
- If an item is
closedorcompletedwith unresolved unchecked boxes, recommend reopening viaupdating-work-item. - If both passes are clean for an item, recommend
finalizing-work-itemonly when status isclosed.
Output Contract
Produce:
- Any applied file edits (only in
fix-and-reportmode). - A single consolidated backlog audit summary in the section order defined above.
