Deep Reflect

by philoserf

document

Analyzes sessions to extract patterns, preferences, and learnings. Use when you want to reflect on this session, capture what worked, document discoveries, or do a retrospective. Triggers on: what did we learn, session summary, reflect on session, capture insights, remember this session.

Skill Details

Repository Files

3 files in this skill directory


name: deep-reflect description: "Analyzes sessions to extract patterns, preferences, and learnings. Use when you want to reflect on this session, capture what worked, document discoveries, or do a retrospective. Triggers on: what did we learn, session summary, reflect on session, capture insights, remember this session." allowed-tools: [Read, Write, Edit, Grep, Glob, AskUserQuestion, TodoWrite]

model: opus


Reference Files


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

Related Skills

Dbt Transformation Patterns

Master dbt (data build tool) for analytics engineering with model organization, testing, documentation, and incremental strategies. Use when building data transformations, creating data models, or implementing analytics engineering best practices.

testingdocumenttool

Clinical Decision Support

Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug develo

developmentdocumentcli

Scientific Schematics

Create publication-quality scientific diagrams using Nano Banana Pro AI with smart iterative refinement. Uses Gemini 3 Pro for quality review. Only regenerates if quality is below threshold for your document type. Specialized in neural network architectures, system diagrams, flowcharts, biological pathways, and complex scientific visualizations.

artdocument

Mermaid Diagrams

Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams including class diagrams (domain modeling, object-oriented design), sequence diagrams (application flows, API interactions, code execution), flowcharts (processes, algorithms, user journeys), entity relationship diagrams (database schemas), C4 architecture diagrams (system context, containers, components), state diagrams, git graphs, pie charts,

artdesigncode

Diagram Generation

Mermaid diagram generation for architecture visualization, data flow diagrams, and component relationships. Use for documentation, PR descriptions, and architectural analysis.

documentdata

Scientific Schematics

Create publication-quality scientific diagrams using Nano Banana Pro AI with smart iterative refinement. Uses Gemini 3 Pro for quality review. Only regenerates if quality is below threshold for your document type. Specialized in neural network architectures, system diagrams, flowcharts, biological pathways, and complex scientific visualizations.

artdocument

Clinical Decision Support

Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug develo

developmentdocumentcli

Materialize Docs

Materialize documentation for SQL syntax, data ingestion, concepts, and best practices. Use when users ask about Materialize queries, sources, sinks, views, or clusters.

documentdata

Dbt Transformation Patterns

Master dbt (data build tool) for analytics engineering with model organization, testing, documentation, and incremental strategies. Use when building data transformations, creating data models, or implementing analytics engineering best practices.

testingdocumenttool

Mermaidjs V11

Create diagrams and visualizations using Mermaid.js v11 syntax. Use when generating flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, user journeys, timelines, architecture diagrams, or any of 24+ diagram types. Supports JavaScript API integration, CLI rendering to SVG/PNG/PDF, theming, configuration, and accessibility features. Essential for documentation, technical diagrams, project planning, system architecture, and visual communication.

artdocumentapi

Skill Information

Category:Document
Allowed Tools:[Read, Write, Edit, Grep, Glob, AskUserQuestion, TodoWrite]
Last Updated:1/30/2026