scout-meta-review

Scout Meta Review

Run an interactive Scout Meta Review — a system-level audit that sits ABOVE the individual session types (briefing, consolidation, dreaming, research, work).

This is NOT a Scout session. It does not read SKILL.md or DREAMING.md. It reviews the Scout system itself: are all the parts working together? Are improvements actually improving things? Is anything rotting, stalling, or drifting?

Run this in the current conversation so the user has full visibility. Run it weekly, or whenever something feels off.

---

Phase 1: System Health Check

Read scout-config.yaml first to locate the Scout directory (scout_dir) and the user's Slack ID (if Slack is enabled).

1a: Session Execution Audit

Check whether Scout sessions are actually running and completing:

# Count sessions by type in the last 7 days
for type in scout dreaming research; do
  echo "=== $type ==="
  ls -1 <SCOUT_DIR>/.scout-logs/${type}-*.log 2>/dev/null | while read f; do
    mod=$(stat -f '%Sm' -t '%Y-%m-%d' "$f" 2>/dev/null || stat -c '%y' "$f" 2>/dev/null | cut -d' ' -f1)
    echo "$mod $(basename "$f")"
  done | sort -r | head -20
done

# Check for failures
cat <SCOUT_DIR>/.scout-logs/failures.log 2>/dev/null | tail -20

# macOS: check launchd. Linux: check cron.
launchctl list | grep -i scout 2>/dev/null || crontab -l 2>/dev/null | grep -i scout || echo "No scheduled jobs found"

Report:

• Sessions per day by type (last 7 days)
• Failure rate (failures / total runs)
• Any session types not running at all
• Gaps in schedule (e.g., no afternoon consolidation for 3 days)

1b: Git Health

cd <SCOUT_DIR> && git log --oneline --since="7 days ago" | head -30
cd <SCOUT_DIR> && git status

• Are sessions committing? Average commits per day?
• Any uncommitted changes lingering?
• Commit message patterns — are they following conventions (briefing [HH:MM]:, dreaming [HH:MM]:, work [HH:MM]:)?

1c: Budget & Cost