audit-learnings

audit-learnings — Hub Weekly Audit Automation

Phase 2 core of hub_compounding_loop.md. Goal: reduce manual 10 minutes to automated 3 minutes. No code changes. Document creation, editing, and deletion only.

Execution Order

Step 0. Lock Session Goal (Claude Code v2.1.139+, recommended)

Lock the session goal before running so the audit is not derailed by other tasks.

/goal Complete weekly audit — pattern scan → promotion/deprecation candidates → PR

Run this then proceed to Step 1. Skip this step if /goal is not supported.

Effect: Prevents drift where improvements found during the audit are immediately applied. Finish the audit document first, then start fixes.

Step 1. Run Scanner (self-detection + fallback)

Check for _scanner.sh first; if absent, extract directly via git commands.

SINCE="${ARGUMENTS:-7 days ago}"

if [ -f "tracks/_audit/_scanner.sh" ]; then
  # Hub environment: use dedicated scanner (9-section full output)
  bash tracks/_audit/_scanner.sh "$SINCE"
else
  # External user environment: direct git extraction (5-section fallback)
  echo "=== COMMITS ==="
  git log --since="$SINCE" --oneline --no-merges

  echo "=== TOP MODIFIED ==="
  git diff --stat "$(git log --since="$SINCE" --format='%H' | tail -1)" HEAD 2>/dev/null | sort -rn | head -20

  echo "=== NEW FILES ==="
  find . -name "*.md" -newer <(date -d "$SINCE" +%Y%m%d 2>/dev/null || date -v-7d +%Y%m%d) 2>/dev/null | grep -v ".git" | head -20

  echo "=== TAG COUNTS ==="
  git log --since="$SINCE" --format="%B" | grep -oE '#[a-z-]+:[a-zA-Z0-9_-]+' | sort | uniq -c | sort -rn

  echo "=== STALE FILES ==="
  find . -name "*.md" -not -newer <(date -d "180 days ago" +%Y%m%d 2>/dev/null || date -v-180d +%Y%m%d) 2>/dev/null | grep -v ".git" | head -20
fi

Constraint: Do not modify _scanner.sh output format if present. The skill reads only.

Step 1.4. Lightweight Harness Structure Check (harness-doctor trigger judgment)

On each audit-learnings run, check CLAUDE.md complexity within 3 seconds. If threshold exceeded, recommend (do not auto-run) harness-doctor full diagnosis.