Skip to main content
AI/MLjmagly

ralph-reflect

View and manage agent loop reflections and episodic memory

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--ralph-reflect
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-reflect/SKILL.md -o .claude/skills/ralph-reflect.md

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

Al Reflect Command

View, search, and manage reflections from agent loop iterations.

Instructions

Manage the Reflexion episodic memory stored in .aiwg/ralph/reflections/:

Subcommand: show

Display reflections for a specific loop or the most recent loop.

  1. Load reflections from .aiwg/ralph/reflections/loops/
  2. Display each reflection with:
    • Trial number, timestamp
    • Outcome (success/failure/partial)
    • Reflection text
    • Strategy change

Subcommand: patterns

Show recurring patterns across all loops.

  1. Load .aiwg/ralph/reflections/patterns/
  2. Display patterns by frequency
  3. Show success rate for each pattern
  4. Highlight patterns applicable to current context

Subcommand: clear

Archive and clear reflection history.

  1. Archive current reflections to timestamped directory
  2. Reset loops and patterns directories
  3. Preserve index.yaml

Arguments

  • show [loop-id] - Show reflections for loop (default: latest)
  • patterns - Show learned patterns
  • clear - Archive and clear reflections
  • --format [yaml|markdown|summary] - Output format (default: markdown)
  • --last [n] - Show only last n reflections
  • --loop [id] - Filter by loop ID

References

  • @$AIWG_ROOT/agentic/code/addons/ralph/schemas/reflection-memory.json - Reflection schema
  • @$AIWG_ROOT/agentic/code/addons/ralph/docs/reflection-memory-guide.md - Guide
  • @.aiwg/research/findings/REF-021-reflexion.md - Research foundation

Storage Routing (#934, #967)

This skill's persistence flows through resolveStorage('reflections'). On the default fs backend reflections live at .aiwg/reflections/. To redirect into Obsidian, Logseq, Fortemi, or another backend without changing this skill, configure roots.reflections or backends.reflections in .aiwg/storage.config (#934).

When this skill needs to read/write reflections from a Bash step, prefer the storage-routed CLI:

aiwg reflections list --prefix sessions/
aiwg reflections get sessions/2026-04-28.md
echo "# reflection" | aiwg reflections put sessions/2026-04-28.md
echo '{"event":"reflect","summary":"..."}' | aiwg reflections append-log sessions/log.jsonl

The legacy direct-fs paths continue to work on the default fs backend — byte-identical to what the adapter writes — but only the adapter route honors storage.config redirection.