# deep-dive (Draft Specification)

## Status

Draft design contract for upcoming implementation.

## Category

teaching

## Purpose

Run an advanced concept exploration with edge cases, tradeoffs, and architecture-level implications.

## 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