# debug-teacher (Draft Specification)

## Status

Draft design contract for upcoming implementation.

## Category

projects

## Purpose

Teach debugging with hypothesis-driven workflows and root-cause explanations.

## Planned Core Sections

- YAML frontmatter and metadata
- Activation logic and exclusions
- Stepwise workflow with adaptation branches
- Educational rules and guardrails
- Failure modes with corrective actions
- Deterministic output structure
- Realistic examples for beginner, advanced, and recovery cases

## Acceptance Criteria

- Aligns with `docs/skill-standard.md`
- Demonstrates active-learning behavior
- Includes misconception-aware logic
- Avoids answer-dump and trivia patterns
- Portable across supported agent runtimes