fix

Drives bug fixes from report through regression spec, mutation gate, and gap analysis.

150|10|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/swingerman/engineer --skill fix-swingerman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fix
Source: https://github.com/swingerman/engineer/tree/main/engineer/skills/fix
Command: npx skills add https://github.com/swingerman/engineer --skill fix-swingerman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Bug fixes often ship as ad-hoc patches with no proof the defect is pinned, no regression protection, and no learning from why the bug escaped. This Skill turns each defect into a tracked unit of work with a RED-first regression spec, a mutation gate, and a structured retrospective. ## Core Features & Use Cases - Defect capture and investigation: Records severity, source, repro steps, and maps the bug to owning features via stack traces, grep, git history, or LSP call hierarchies. - RED-first regression pinning: Requires a Given/When/Then spec that fails on current code before any fix, plus a bug-line mutation gate proving the spec is coupled to the bug, not the fix. - Gap analysis loop: Closes each fix with a "why didn't we catch it?" analysis using a closed category vocabulary, feeding methodology improvements back into specs and charters. - Use Case: A Sentry alert reports a login redirect loop. The Skill captures the defect, pins it with a failing regression spec, applies and hardens the fix with mutation testing, then records that the session spec lacked a token-expiry scenario. ## Quick Start Ask the agent to run /engineer.fix with the bug report or alert text to capture, pin, fix, and close the defect end to end.

Frequently Asked Questions about fix

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

FAQPage Schema
How do I fix a bug with regression protection?▼

Capture the defect with severity, source, and repro steps, then write a Given/When/Then regression spec that must fail on current code before any change. After the fix turns the spec green, a bug-line mutation gate re-applies the original buggy lines to prove the spec still catches the defect.

What is a bug-line mutation gate in testing?▼

A bug-line mutation gate recovers the original buggy lines via git show, applies them locally, and re-runs only the regression spec to confirm it goes RED. If the spec stays green, it is coupled to the fix rather than the bug and must be redrafted.

Can this workflow run automatically from a Sentry alert?▼

Yes, a trigger such as a Sentry or CI alert can invoke the fix workflow with no human at the start, synthesizing bug intent from the signal or logs. Critical or user-blocking defects always confirm with a human, and external writes like merges still require clearance.

Why does my regression spec pass before the fix is applied?▼

A spec that passes on unfixed code does not pin the bug and must be redrafted until it fails. Also check fixture parity first, since a seed fixture drifted from the schema can produce misleading results that mask the real defect.

When should I not use a defect fix workflow?▼

Do not use it for building new capabilities, adjusting an in-flight feature's scope, or reviewing recent changes without an actual defect. Those cases belong to feature discussion, feature editing, or verification and risk-analysis steps instead.