Bug Fix — Stop-the-Line Protocol

What it does

This skill codifies a conservative, test-first bug-fix workflow intended to reduce regressions and speed reliable fixes. It defines a Stop-the-Line protocol (preserve evidence, diagnose causality, fix root causes only, and add regression tests) plus a Triage Sequence to reproduce and narrow failures before implementing changes. The guidance is practical for developer-facing agents assisting with debugging and PRs.

When to use it

Use when a test, build, lint, or runtime error appears and a safe, auditable fix is required. Ideal for CI failures, flaky tests, pre-merge checks, and situations where regressions are costly. This skill should be triggered by phrases like "fix bug", "debug", "resolve issue", or when an agent detects failing tests or CI alerts.

What's included

• Scripts: none (has_scripts=false) — the skill references repo contribution guides and testing patterns but provides procedural instructions rather than executable scripts.
• References: inline links to contribution docs and testing-patterns in the repo.
• Instructions: step-by-step protocol (Stop-the-Line) and a Triage Sequence, plus a quality checklist and red flags to avoid.

Compatible agents

Developer-assistant agents that can read/write repo files, run tests, and create PRs (GitHub-enabled Copilot/gh-cli agents, Claude/Codex-style agents).