bug-forensicslisted
Install: claude install-skill avksp/agent-lifecycle-kit
# Bug Forensics
Use this skill only when the task explicitly asks to find or repair a bug,
regression, flaky failure, incident, or security bug. The profile is optional
and disabled by default for ordinary feature work.
Adapter task intake may recommend this profile through `bugForensicsAdvisory`.
Treat that as an advisory marker only. Do not claim the workflow gate is active
unless the reviewed task or frozen plan explicitly opts in.
## Contract
Before accepting a patch, collect schema-backed evidence for:
- symptom;
- reproduction before modification;
- stable failure fingerprint;
- hypothesis ledger with accepted and rejected hypotheses;
- root cause;
- minimal patch;
- regression proof for the same fingerprint;
- no collateral damage through the canonical fix-impact receipt.
## Inputs
Required phase-1 receipts:
- `agent-bug-reproduction-receipt.v1`;
- `agent-failure-fingerprint.v1`;
- `agent-bug-hypothesis-ledger.v1`;
- `agent-regression-proof-receipt.v1`;
- `agent-fix-impact-receipt.v1`.
Reuse `agent-fix-impact-receipt.v1` for behavior impact. Do not create a
bug-specific competing fix-impact schema.
## Gates
- Reproduction must be red before any code modification.
- Regression proof must show the same fingerprint red before and green after.
- Minimal patch gate must justify any file outside the suspect scope.
- Cross-check is advisory unless the frozen plan explicitly opts into blocking
use. When used, reuse `agent-cross-check-receipt.v1` with token/resourc