// Treat diagnosis as a first-class phase before fixing a bug, unstable behavior, or weird operational issue.
Use Beads (`bd`) as the durable task-management system for work that needs priorities, dependencies, status tracking, and cross-session continuity.
Turn a one-line objective into a step-by-step construction plan where every step has a self-contained context brief. Designed for work that spans multiple sessions or agents.
Use contracts, templates, and durable markdown artifacts consistently when a workflow needs handoffs, plans, context bundles, decisions, or verification evidence.
Use this when designing an internal tool or operational app where the safest path is to prove the workflow and UI before locking in backend structure.
Create a practical understanding of a repository or a large area before detailed work begins.
This is the meta-skill -- it teaches how to build skills that AI agents can
| name | bug-diagnosis |
| description | Treat diagnosis as a first-class phase before fixing a bug, unstable behavior, or weird operational issue. |
| pack | skills-discovery |
Treat diagnosis as a first-class phase before fixing a bug, unstable behavior, or weird operational issue.
Produce a BugDiagnosis artifact that records:
Use the toolkit diagnosis contract when creating the artifact:
contracts/diagnosis-note/CONTRACT.mdcontracts/diagnosis-note/TEMPLATE.mdCapture: