trellis-break-loop

Analyzes fixed bugs across five dimensions to produce root-cause reports and spec updates.

1|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/MaplumeX/Milesto --skill trellis-break-loop-maplumex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-break-loop
Source: https://github.com/MaplumeX/Milesto/tree/main/.agents/skills/trellis-break-loop
Command: npx skills add https://github.com/MaplumeX/Milesto --skill trellis-break-loop-maplumex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often fix a bug and move on, only to hit the same class of bug again later. This Skill breaks the fix-forget-repeat cycle by guiding a structured post-mortem analysis after every bug fix and turning insights into permanent documentation. ## Core Features & Use Cases - Five-Dimension Analysis Framework: Classifies root cause (missing spec, cross-layer contract, change propagation failure, test coverage gap, implicit assumption), reviews why earlier fixes failed, and proposes prevention mechanisms. - Structured Output Template: Produces a standardized Markdown bug analysis report with prioritized prevention actions (P0, TODO/DONE status). - Knowledge Capture into Specs: Directs updates to .trellis/spec/guides/ thinking guides, syncs templates to src/templates/markdown/spec/, and commits the spec changes as the primary deliverable. - Use Case: After fixing a bug where an API returned timestamps in seconds instead of milliseconds, run this Skill to classify it as an implicit-assumption bug, document prevention mechanisms, and update the cross-layer thinking guide. ## Quick Start After fixing a bug, ask the AI to run a break-the-loop deep analysis on the bug just fixed and update the relevant spec guides.

Frequently Asked Questions about trellis-break-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I do a root cause analysis after fixing a bug?▼

Run a structured post-fix analysis that classifies the root cause into categories like missing spec, cross-layer contract, or implicit assumption, then reviews why earlier fix attempts failed. This Skill outputs a standardized Markdown report with prioritized prevention actions.

How to prevent the same class of bugs from recurring?▼

Prevention requires capturing knowledge into permanent artifacts, not just fixing the symptom. This Skill defines prevention mechanisms across documentation, architecture, compile-time checks, runtime monitoring, test coverage, and code review, then commits updates to spec guides.

What root cause categories does this bug analysis framework use?▼

It uses five categories: missing spec, cross-layer contract issues, change propagation failure, test coverage gaps, and implicit assumptions. Each category has defined characteristics and examples to guide classification.

When should I run a post-mortem bug analysis?▼

Run it immediately after debugging is complete and the fix is verified, while context is fresh. The Skill is designed for the post-fix stage, not for live debugging or initial triage.

Does this analysis require a specific project structure?▼

Yes, the knowledge capture step targets a Trellis-style layout with .trellis/spec/guides/ directories and template syncing to src/templates/markdown/spec/. Projects without this structure can still use the analysis framework but must adapt the documentation targets.