What problem does it solve?
This Skill solves the problem of repeating the same coding mistakes across sessions by identifying where the AI assistant violated project conventions, missed established patterns, or required user steering, eliminating wasted time on recurring issues.
Core Features & Use Cases
- Convention Violation Detection: Scans session history for breaches of the 16 core coding conventions (type hints, Pydantic usage, fail-fast patterns, etc.) defined in the root CLAUDE.md.
- Targeted Fix Proposal: Categorizes issues to direct improvements to the correct location: CLAUDE.md files, skills, agents, or hooks, prioritizing systemic fixes over one-off corrections.
- Use Case: For example, if your team repeatedly corrects the AI for using Poetry instead of uv, or creating controller directories instead of routes in the API package, this Skill identifies the recurring issue and proposes a permanent fix to prevent future mistakes.
Quick Start
Use the reflect skill after a coding session to get a prioritized list of actionable improvements for your project's documentation and AI configuration.