Skip to content
Agent Memory
Skill

/claude-reflect

Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md. Use when discussing learnings, corrections, or when the user mentions remembering something for future sessions.

From plugin
claude-reflect
1.9k1 skill4 commands4 hooks

Claude Code

$ npx -y skills add BayramAnnakov/claude-reflect --skill claude-reflect --agent claude-code

SKILL.md

claude-reflect.SKILL.md
name: claude-reflect
description: Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md. Use when discussing learnings, corrections, or when the user mentions remembering something for future sessions.

Claude Reflect - Self-Learning System

A two-stage system that helps Claude Code learn from user corrections.

How It Works

**Stage 1: Capture (Automatic)** Hooks detect correction patterns ("no, use X", "actually...", "use X not Y") and queue them to `~/.claude/learnings-queue.json`.

**Stage 2: Process (Manual)** User runs `/reflect` to review and apply queued learnings to CLAUDE.md files.

Available Commands

| Command | Purpose | |---------|---------| | `/reflect` | Process queued learnings with human review | | `/reflect --scan-history` | Scan past sessions for missed learnings | | `/reflect --dry-run` | Preview changes without applying | | `/reflect-skills` | Discover skill candidates from repeating patterns | | `/skip-reflect` | Discard all queued learnings | | `/view-queue` | View pending learnings without processing |

When to Remind Users

Remind users about `/reflect` when:

  • They complete a feature or meaningful work unit
  • They make corrections you should remember for future sessions
  • They explicitly say "remember this" or similar
  • Context is about to compact and queue has items

Correction Detection Patterns

High-confidence corrections:

  • Tool rejections (user stops an action with guidance)
  • "no, use X" / "don't use Y"
  • "actually..." / "I meant..."
  • "use X not Y" / "X instead of Y"
  • "remember:" (explicit marker)

Learning Destinations

  • `~/.claude/CLAUDE.md` - Global learnings (model names, general patterns)
  • `./CLAUDE.md` - Project-specific learnings (conventions, tools, structure)
  • `./CLAUDE.local.md` - Personal learnings (machine-specific, gitignored)
  • `./.claude/rules/*.md` - Modular rules with optional path-scoping
  • `~/.claude/rules/*.md` - Global modular rules
  • `~/.claude/projects/<project>/memory/*.md` - Auto memory (low-confidence, exploratory)
  • `commands/*.md` - Skill improvements (corrections during skill execution)

Example Interaction

User: no, use gpt-5.1 not gpt-5 for reasoning tasks
Claude: Got it, I'll use gpt-5.1 for reasoning tasks.

[Hook captures this correction to queue]

User: /reflect
Claude: Found 1 learning queued. "Use gpt-5.1 for reasoning tasks"
        Scope: global
        Apply to ~/.claude/CLAUDE.md? [y/n]
Read more
@bayramannakov
Ships withclaude-reflect

A self-learning system for Claude Code that captures corrections and discovers workflow patterns — turning them into permanent memory and reusable skills. Two ways to run it: Pick one. Install the plugin or the mod.

Stars on GitHub

Momentum

stars in total
1.9k
Star history of BayramAnnakov/claude-reflect on GitHub, a chart by star-history.com

More skills from other plugins.

agent-cost-report

agent-cost-report

Believable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude…

@thedotmack@thedotmackInstall Skill
bot-handoff

bot-handoff

Keep a durable record of work passed between Bots in the shared Hindsight memory bank. Use when handing work to another Bot, when…

@vectorize-io@vectorize-ioInstall Skill
mempalace

mempalace

Install, configure, and operate MemPalace, including a private local palace, a shared-brain hub, or a client joining an existing…

mempalace11d60k
@mempalace@mempalaceInstall Skill
mempalace

mempalace

Install, configure, and operate MemPalace, including a private local palace, a shared-brain hub, or a client joining an existing…

mempalace11d60k
@milla-jovovich@milla-jovovichInstall Skill

Questions about claude-reflect.

Which coding agents can use claude-reflect?
claude-reflect installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.