ralph-analytics

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/agent-loop/schemas/reflection-memory.json - Reflection schema
• @$AIWG_ROOT/agentic/code/addons/agent-loop/schemas/debug-memory.yaml - Debug memory schema
• @$AIWG_ROOT/agentic/code/addons/agent-loop/docs/reflection-memory-guide.md - Guide