memory-insights

name	memory-insights
description	Analyze session friction trends, success rates, and satisfaction patterns across sessions using Claude Code facets data. Read-only query tool for on-demand trend analysis.
triggers	["/memory-insights"]

Memory Insights — Session Trend Analysis

Read-only analytics over Claude Code facets data for friction trends, success patterns, and satisfaction signals.

Data Source

Read all JSON files in ~/.claude/usage-data/facets/ (skip gracefully if directory doesn't exist). Each file is a per-session analysis with fields: session_id, underlying_goal, goal_categories, outcome, session_type, claude_helpfulness, primary_success, friction_counts, friction_detail, user_satisfaction_counts, brief_summary.

Graceful degradation: If ~/.claude/usage-data/facets/ doesn't exist, output: "No facets data available. Facets are generated by Claude Code and may not be present on all installations. Session insights require at least one completed Claude Code session."

Commands

Default (no arguments): Summary Dashboard

Show a summary dashboard:

• Total sessions analyzed: [N]
• Outcome breakdown: fully_achieved [N], mostly_achieved [N], etc.
• Helpfulness: essential [N], very_helpful [N], etc.
• Top 5 friction types with counts
• Sessions with friction: [N]/[total] ([%])