Library use: Apply the compatibility and execution contract. Source roles, memory claims, command names, hooks, and integrations are instructions or prerequisites—not installed capabilities.

Bug Fixing

When to use

Diagnose a reproducible defect, make the smallest repair, and prove the repair.

Inputs

User objective, project constraints, relevant source or evidence, and explicit success criteria.

Procedure and handoffs

1. Load the investigate procedure. Preserve the original failure and identify root cause before fixing.
2. Load the minimal-change-engineer procedure. Constrain the diff to the demonstrated cause and affected callers.
3. Load the tdd-workflow procedure. Add a failing regression; implement the repair and refactor only within scope.
4. Load the verification-loop procedure. Report regression and adjacent-check evidence, including unavailable checks.

Verification and output

Produce the artifacts required by the selected procedures and an evidence-backed status: completed, failed, skipped with reason, or blocked on a named prerequisite. Carry unresolved findings forward. Do not treat an unavailable tool, an unrun check, or a reviewer failure as a pass.

Scope and compatibility

Select stages proportionate to the task. Preserve required gates of the chosen variant; record exceptions. Read the compatibility policy before combining conflicting variants. These instructions do not grant tool access or authorize publishing, commits, deployment, or communications.

Runtime prerequisites

See the dependency ledger and this skill’s records in dependencies.json. Native gstack/ECC CLIs, browsers, hooks, model tools, credentials, and memory stores must be available before invoking their steps. No runtime installation or execution has been performed. CSO requires its trusted helper; do not emulate that helper on the host.

Related skills and principles

• core/goal-driven-execution
• core/simplicity-first
• core/surgical-changes
• core/think-before-coding
• debugging/investigate
• developer-experience/plan-tune
• documentation/document-generate
• engineering/codex
• engineering/minimal-change-engineer
• engineering/review
• memory/context-restore
• memory/context-save
• memory/learn
• project-management/retro
• release/ship
• security/unfreeze
• testing/qa-only
• testing/tdd-workflow
• verification/verification-loop

Source provenance

• gstack/investigate/SKILL.md
• agency-agents/engineering/engineering-minimal-change-engineer.md
• ecc/skills/tdd-workflow/SKILL.md
• ecc/skills/verification-loop/SKILL.md