What does the /reflect command do?

It triggers a multi-phase analysis of your current development session to identify ways to improve your local AI toolkit, automate manual steps, and update project documentation.

How does it help with terminal permissions?

It identifies bash commands you have approved multiple times and suggests adding them to your .claude/settings.json permissions for a smoother, uninterrupted workflow.

Where are reflections saved?

Detailed session summaries are saved as Markdown files in the history/reflections/ directory, providing a searchable record of project discoveries and patterns.

When should I use the 'quick' vs 'deep' variants?

Use /reflect quick for immediate P0 wins like small doc fixes and permissions. Use /reflect deep for comprehensive cross-session analysis that reviews multiple previous reflections.

Reflect Meta-Improvement

Name: Reflect Meta-Improvement
Author: gooditworks

bygooditworks

Productivity & Workflow

Analyzes development sessions to automatically improve your AI toolkit, documentation, and workflow automation.

About

Reflect is a meta-improvement skill designed to optimize your development environment by reviewing past sessions and identifying patterns of friction. It helps automate repetitive tasks, update documentation like AGENTS.md, refine permission settings, and capture institutional knowledge. By transforming manual discoveries into permanent system improvements, it ensures that your Claude Code experience becomes more efficient and tailored to your specific project needs over time through structured post-session analysis.

Key Features

Streamlined toolkit updates for AGENTS.md and local skills
0 GitHub stars
Identification of permission gaps and documentation needs
Persistence of learnings via session summaries in history/reflections/
Prioritized improvement suggestions (P0-P3)
Automated session analysis and pattern recognition

Use Cases

Automating multi-step workflows by proposing new specialized skills based on observed session history.
Performing a post-sprint review to document architectural patterns and edge cases discovered during coding.
Reducing repetitive manual approvals by identifying and whitelisting frequently used bash commands.

About

Key Features

Streamlined toolkit updates for AGENTS.md and local skills
0 GitHub stars
Identification of permission gaps and documentation needs
Persistence of learnings via session summaries in history/reflections/
Prioritized improvement suggestions (P0-P3)
Automated session analysis and pattern recognition

Use Cases

Automating multi-step workflows by proposing new specialized skills based on observed session history.
Performing a post-sprint review to document architectural patterns and edge cases discovered during coding.
Reducing repetitive manual approvals by identifying and whitelisting frequently used bash commands.