hb-repo-truth-audit - SKILL.md Agent Skill

name: hb-repo-truth-audit description: Conduct an HB Intel repo-truth audit grounded in current files, manifests, exports, tests, docs, and validation evidence. when_to_use: Use for live repo audits, exhaustive audits, repo-truth reviews, current-state comparisons, or plan-to-repo alignment. argument-hint: "[audit objective or target area]" context: fork agent: hb-repo-researcher allowed-tools: Read, Grep, Glob, Bash(git status:), Bash(git diff:), Bash(git log:*)

Audit the live repo for:

$ARGUMENTS

Use hb-workspace-surface-router.
Read current files directly.
Prefer nearest authority over broad repo search.
Use docs/README.md and current-state-map.md for docs/architecture questions.
Identify:
- source-of-truth chain;
- stale or contradictory guidance;
- missing files or broken references;
- implementation/documentation drift;
- validation gaps;
- safety or deployment risk;
- recommended changes.