When should I trigger a memory reflection?

It is best used after completing a significant task, a complex debugging session, or research where you encountered non-obvious information or architectural patterns.

What is the main benefit of using the Memory Reflection skill?

It helps identify 'friction points' in your workflow—information you had to search for multiple times—so you can proactively document or memorize them to save time in future sessions.

How do I use the accumulated reflections?

You can periodically review the context_reflections.md file or use commands like /analyze-context to distill recurring patterns into permanent project documentation.

Where are the reflections stored?

All reflections are appended to a local structured markdown file at .claude/context_reflections.md within your project repository.

Does it record every single action I took during a session?

No, it specifically focuses on context gaps and high-value insights, intentionally skipping trivial tasks or easily re-discoverable implementation details.

Memory Reflection

Name: Memory Reflection
Author: kpiteira

bykpiteira

•

生产力与工作流

Captures structured learnings and context gaps after work sessions to optimize future coding efficiency and knowledge retention.

关于

The Memory Reflection skill acts as a post-session debriefing tool that helps developers systematically capture architectural insights, discovered patterns, and knowledge gaps encountered during coding tasks. By documenting what required excessive searching or re-discovery, it generates actionable recommendations for what should be committed to persistent memory versus what can be ignored, ultimately reducing cognitive load and accelerating future development cycles within the same codebase.

主要功能

Centralized logging in .claude/context_reflections.md for easy review
Automated generation of structured post-task reflections
Quantification of session efficiency through search and file-read metrics
Actionable recommendations for persistent project memory updates
Identification of recurring architectural knowledge gaps and pattern re-discoveries
1 GitHub stars

使用场景

Tracking non-obvious cross-module side effects encountered during feature implementation
Reviewing accumulated reflections to identify permanent documentation needs for a growing codebase
Documenting complex singleton or dependency injection patterns discovered during debugging

关于

主要功能

Centralized logging in .claude/context_reflections.md for easy review
Automated generation of structured post-task reflections
Quantification of session efficiency through search and file-read metrics
Actionable recommendations for persistent project memory updates
Identification of recurring architectural knowledge gaps and pattern re-discoveries
1 GitHub stars

使用场景

Tracking non-obvious cross-module side effects encountered during feature implementation
Reviewing accumulated reflections to identify permanent documentation needs for a growing codebase
Documenting complex singleton or dependency injection patterns discovered during debugging