deep-reflect

name	deep-reflect
description	Analyzes development sessions to extract patterns, preferences, and learnings. Use after significant work sessions to capture insights, document system understanding, and improve future interactions.
allowed-tools	["Read","Write","Edit","Grep","Glob","AskUserQuestion","TodoWrite"]

Reference Files

• framework.md - The 5-dimension analysis framework
• output-template.md - Structured reflection format

---

Deep Reflect

Comprehensive session analysis to build cumulative knowledge across interactions.

Objective

Extract reusable insights from the session that make future sessions more effective. Focus on patterns, not just facts.

When to Use

• After significant debugging or problem-solving sessions
• When you've learned something important about the codebase
• After discovering user preferences through trial and error
• When system relationships became clearer through investigation

Analysis Framework

Examine the session through 5 dimensions:

1. Problems & Solutions

• What symptoms were reported?
• What root causes were discovered?
• What solutions worked (and didn't)?
• What key insights emerged?

2. Code Patterns & Architecture

• What design decisions were made?
• What architecture choices emerged?
• What code relationships were discovered?
• What integration points were identified?

3. User Preferences & Workflow

• Communication style preferences
• Decision-making patterns
• Quality standards expressed
• Workflow preferences revealed
• Direct quotes that reveal preferences

4. System Understanding

• Component interactions discovered
• Critical paths and dependencies
• Failure modes and recovery patterns
• Performance considerations learned

5. Knowledge Gaps & Improvements

• Where did misunderstandings occur?
• What information was missing?
• What better approaches were discovered?
• What should be done differently next time?

Process

1. Review - Walk through the session conversation
2. Extract - Identify insights in each dimension
3. Synthesize - Connect related learnings
4. Document - Create structured reflection
5. Act - Generate concrete deliverables

Deliverables

Based on the analysis, generate applicable items:

• CLAUDE.md updates - Preferences and patterns to remember
• Code comments - System understanding to preserve
• Documentation - Workflows or processes to document
• Future considerations - Things to address in later sessions

Guidelines

• Focus on reusable patterns, not session-specific facts
• Capture the "why" behind decisions, not just the "what"
• Preserve user voice when documenting preferences
• Prioritize insights by impact on future effectiveness
• Build cumulative knowledge, not just session notes