Skip to main content
AI/MLjmagly

ralph-analytics

Show analytics and metrics from agent loop execution history

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--ralph-analytics
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/addons/agent-loop/skills/ralph-analytics/SKILL.md -o .claude/skills/ralph-analytics.md

Drops the SKILL.md into .claude/skills/ralph-analytics.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Al Analytics Command

Display aggregate analytics and metrics from agent loop execution history.

Instructions

When invoked, analyze agent loop data and present metrics:

  1. Scan Loop History

    • Load all loop records from .aiwg/ralph/
    • Load reflections from .aiwg/ralph/reflections/
    • Load debug memory from .aiwg/ralph/debug-memory/
  2. Calculate Metrics

    • Success rate: % of loops that completed successfully
    • Average iterations: Mean iterations to completion
    • Reflection reuse rate: % of reflections applied in subsequent loops
    • Stuck loop rate: % of loops that hit stuck detection
    • Escalation rate: % requiring human intervention
  3. Pattern Analysis

    • Most common failure types
    • Most effective fix patterns
    • Average time per iteration
    • Quality trajectory per loop
  4. Display Dashboard

    • Summary metrics table
    • Trend indicators (improving/stable/degrading)
    • Recommendations for improvement

Arguments

  • --since [date] - Analyze loops from date (default: all)
  • --loop [id] - Analyze specific loop
  • --export [path] - Export analytics to file
  • --brief - Show summary only

References

  • @$AIWG_ROOT/agentic/code/addons/ralph/schemas/reflection-memory.json - Reflection schema
  • @$AIWG_ROOT/agentic/code/addons/ralph/schemas/debug-memory.yaml - Debug memory schema
  • @$AIWG_ROOT/agentic/code/addons/ralph/docs/reflection-memory-guide.md - Guide