claude-reflect

Solid

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.

AI & Automation 1,043 stars 88 forks Updated 2 months ago MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
100
Recency 20%
75
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# 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-sp...

Details

Author
BayramAnnakov
Repository
BayramAnnakov/claude-reflect
Created
4 months ago
Last Updated
2 months ago
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category