RAD_framework: Command for Claude Code

/rad-insights

Analyze finding patterns across all recorded RAD review cycles.

Input

$ARGUMENTS (optional):

• --since YYYY-MM-DD to limit analysis to cycles on or after that date.
• --draft-plans to bundle every threshold-crossing Step 3b category into ONE Gate-1-blocked plan via scripts/draft-insights-plan.sh (see Step 3b). Without this flag the skill drafts nothing and Step 3b output is unchanged.

---

Process

Step 1: Check for findings log

if [ ! -f .agents/findings.jsonl ]; then
  echo "No findings log found. Run /rad-review on at least one rad/ work branch first."
  exit 0
fi

Count records to determine report depth:

# Total cycles
jq -r 'select(.type=="cycle")' .agents/findings.jsonl | jq -s 'length'

# Total findings
jq -r 'select(.type=="finding")' .agents/findings.jsonl | jq -s 'length'

If fewer than 3 cycles exist, note the limited data and output a raw findings list instead of a pattern report.

Step 2: Apply date filter (if --since provided)

# Filter findings to on/after the provided date
jq -r --arg since "[DATE]" 'select(.date >= $since)' .agents/findings.jsonl

Step 3: Compute finding frequencies

# Category frequency (all priorities)
jq -r 'select(.type=="finding") | .category' .agents/findings.jsonl \
  | sort | uniq -c | sort -rn

# HIGH findings by category
jq -r 'select(.type=="finding" and .priority=="HIGH") | .category' .agents/findings.jsonl \
  | sort | uniq -c | sort -rn

# Finding frequency per file (top 10)
jq -r 'select(.type=="finding") | .file' .agents/findings.jsonl \
  | sort | uniq -c | sort -rn | head -10

# Findings by reviewer
jq -r 'select(.type=="finding") | .reviewer' .agents/findings.jsonl \
  | sort | uniq -c | sort -rn

Step 3b: Findings Recurrence — convention/lint suggestions

A category that keeps recurring across review cycles is a signal the project is missing a convention (or a lint rule) that would prevent it. This step turns the Step 3 category counts into suggestions only — every output is framed "suggestion — apply via PR; never auto-applied". This skill NEVER edits AGENTS.md, CLAUDE.md or scripts/lint-plan.sh itself.