What problem does it solve?
Breaks the cycle of "fix bug → forget → repeat" by turning a completed debugging session into a structured, actionable learning process that prevents the same class of bugs from recurring. It captures root causes, failed attempts, prevention strategies, and concrete spec updates so fixes become permanent improvements rather than temporary patches.
Core Features & Use Cases
- Five-dimension analysis: Classify root cause, explain why previous fixes failed, recommend prevention mechanisms, identify broader systemic issues, and capture knowledge for documentation.
- Spec and repo hygiene: Produce checklist items and explicit edits to
.trellis/spec/ guides and provide commit-ready guidance to ensure lessons are applied to the codebase.
- Use Case: After resolving a tricky cross-layer bug, run this Skill to update thinking guides, create tickets for root fixes, and add tests or monitoring recommendations to prevent regression.
Quick Start
Use the break-loop skill to produce a five-dimension post-fix analysis for the bug you just fixed and apply the recommended spec updates to the repository.