trellis-break-loop

Analyze bug fixes to identify root causes and update specs.

7.3k|365|Updated May 31, 2024
One-click install
npx skills add https://github.com/EcoPasteHub/EcoPaste --skill trellis-break-loop-ecopastehub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trellis-break-loop
Source: https://github.com/EcoPasteHub/EcoPaste/tree/main/.cursor/skills/trellis-break-loop
Command: npx skills add https://github.com/EcoPasteHub/EcoPaste --skill trellis-break-loop-ecopastehub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Breaks the "fix-forget-repeat" cycle by deeply analyzing the root cause of bugs and capturing knowledge into specs to prevent future occurrences.

Core Features & Use Cases

  • Root Cause Analysis: Categorizes bugs into 'Missing Spec', 'Cross-Layer Contract', 'Change Propagation Failure', 'Test Coverage Gap', or 'Implicit Assumption'.
  • Fix Analysis: Reviews multiple fixes and their failures, including surface fixes, incomplete scope, tool limitations, and mental models.
  • Prevention Mechanisms: Suggests documentation, architecture, compile-time, runtime, test coverage, and code review mechanisms.
  • Systematic Expansion: Explores similar issues, design flaws, process flaws, and knowledge gaps.
  • Knowledge Capture: Provides templates for updating specs, creating issue records, and feature tickets.

Quick Start

Run the trellis-break-loop skill with the 'bug_report.md' analysis file as input.

Frequently Asked Questions about trellis-break-loop

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

FAQPage Schema
How do I prevent repetitive bugs by deeply analyzing their root causes?

To prevent repetitive bugs, you can deeply analyze root causes by categorizing them into types like Missing Spec or Cross-Layer Contract, reviewing failed fixes, and implementing prevention mechanisms. This breaks the fix-forget-repeat cycle.

What is the best way to capture knowledge from bug fixes into specifications?

Capturing knowledge from bug fixes into specifications requires using templates to update specs, create issue records, and generate feature tickets after analyzing the root cause and implementing architectural changes.

How do I analyze incomplete bug fixes and surface fixes that fail to address the root cause?

To analyze incomplete bug fixes, you review multiple fixes and their failures, including surface fixes, incomplete scope, tool limitations, and mental models, categorizing the bug to identify the true root cause.

What prevention mechanisms should I apply after a bug root cause analysis?

Prevention mechanisms to apply after a bug root cause analysis include documentation updates, architectural changes, compile-time checks, runtime guards, test coverage improvements, and code review processes.

Can I use a bug report markdown file as input for root cause analysis?

Yes, you can use a bug report markdown file as input. Running the analysis with this file allows the framework to categorize the bug, review fix failures, and suggest systematic expansions for similar issues.