Claude reflect

--- 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 skills 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 - skills improvements (corrections during skills 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] ``