---

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)
• commands/*.md - Skill improvements (corrections during skill execution)

claude-reflect

A self-learning system for Claude Code that captures corrections and discovers workflow patterns — turning them into permanent memory and reusable skills.

What it does

1. Learn from Corrections

When you correct Claude ("no, use gpt-5.1 not gpt-5"), it remembers forever.

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  You correct    │ ──► │  Hook captures  │ ──► │  /reflect adds  │
│  Claude Code    │     │  to queue       │     │  to CLAUDE.md   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
      (automatic)            (automatic)            (manual review)

2. Discover Workflow Patterns (NEW in v2)

Analyzes your session history to find repeating tasks that could become reusable commands.

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Your past      │ ──► │ /reflect-skills │ ──► │   Generates     │
│  sessions       │     │ finds patterns  │     │   /commands     │
└─────────────────┘     └─────────────────┘     └─────────────────┘
    (68 sessions)         (AI-powered)            (you approve)