Claude Reflect — Self-Learning for Claude Code

What it is

Claude Reflect is a Claude Code plugin that captures corrections and preferences you make during development sessions. When you fix something Claude got wrong or express a preference for a certain approach, Claude Reflect records that learning and syncs it to your project's CLAUDE.md file. This means Claude remembers your preferences across sessions without you repeating yourself.

Claude Reflect is designed for developers who use Claude Code regularly and want to reduce repeated corrections over time.

How it saves time or tokens

Every time you correct Claude Code and it forgets by the next session, you spend tokens re-explaining the same preference. Claude Reflect breaks that cycle by persisting corrections as structured learnings. Over weeks of use, the accumulated learnings in CLAUDE.md mean Claude starts each session already knowing your coding style, architectural preferences, and project conventions. This reduces back-and-forth corrections and the token cost of re-explaining context.

How to use

1. Install the plugin via Claude Code:

claude plugin marketplace add bayramannakov/claude-reflect
claude plugin install claude-reflect@claude-reflect-marketplace

1. Restart Claude Code to activate the hooks.

1. Use Claude Code normally. When you correct Claude or express a preference, Claude Reflect captures it automatically.

1. Review accumulated learnings by checking your CLAUDE.md file. Edit or remove any learnings that are no longer relevant.

Example

After a few sessions, your CLAUDE.md might accumulate learnings like:

Learnings from Claude Reflect

• Always use single quotes for TypeScript string literals in this project
• Prefer named exports over default exports
• Use pnpm, not npm, for package management
• API error responses should use the ErrorResponse type from src/types.ts
• Never use console.log in production code; use the logger from src/lib/logger.ts

These learnings are automatically referenced by Claude Code at the start of each session, reducing corrections from the first interaction.

Related on TokRepo

• AI memory tools — Explore tools that give AI agents persistent memory
• Coding tools — Browse developer productivity tools for AI-assisted coding

Common pitfalls

• Not reviewing accumulated learnings periodically. Over time, some learnings become outdated or contradictory. Review your CLAUDE.md monthly and prune stale entries.
• Installing the plugin but not restarting Claude Code. The hooks only activate after a restart, so corrections made before restarting are not captured.
• Expecting immediate perfection. Claude Reflect improves over time as it accumulates more learnings. The first few sessions will still require corrections as usual.