Fable roadmap auditor

SkillDev tools

Audit the fable roadmap (docs/fable_roadmap/) — verify claimed progress with proof, write a short report, update RESUME state + BACKLOG rank. Use at wave close or whenever the user asks how roadmap development is going. Triggers on - 'fable audit', 'roadmap audit', 'how is the roadmap going', 'audit progress', or /fable-audit.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Fable roadmap auditor skill

What this skill tells your AI

The instructions your AI receives, as published by deepklarity/harness-kit in .claude/skills/fable-audit/SKILL.md and read by ahel’s review.

Trust nothing; verify everything. Lean by user directive: an audit is one short report plus two file updates — not a documentation pass.

  1. Verify claims with proof. For each task DONE since the last audit, run its verify step or inspect the merged artifact. Delegate command runs and file checks to parallel haiku subagents; keep judgment in the main conversation. The board is truth (board_overview.py / spec_trace.py / task_inspect.py --brief from taskit/taskit-backend/); doc-vs-board divergence is a finding. Downgrade anything unprovable.
  2. Recompute what has data: run the suites; count autonomy/unsticks from board history (hand-counted until the metrics script lands — say so). Report gaps as gaps.
  3. Grade against SCORECARD.md — every score move names the anchor (0/5/10) its evidence supports; recompute the overall (plain average). Scores live only in the fable_roadmap.md table — a score anywhere else is a finding. Then judge the ladder against fable_roadmap.md exit criteria; check the ratchet rules there. Violations are findings.
  4. Write audits/YYYY-MM-DD*.md: verdict line (on track / drifting / blocked + why), verified-done table with proof, demotions, metrics snapshot, top-3 risks with mitigations, ladder call. Readable in 30 seconds from the top.
  5. Update the living docs: RESUME "Current state" + BACKLOG re-rank (the top IS the next wave draft) + the ladder Status column if a level changed.
  6. Artifact only if the user asks — redeploy to the URL in RESUME's durable facts; never mint a new one.
  7. --dispatch only: convert the backlog top into a wave spec under bootstrap/ and load it (pre-dispatch checklist in the loader templates).

End with: verdict line, ladder level, top 3 next actions — plain prose.

Signals

GitHub stars
99
Forks
12
Last commit
Jul 2026
Advanced
Catalog kind
skill
Gateway key
fable-audit
Source
github.com/deepklarity/harness-kit