docs/exec-plans/tech-debt-tracker.md

Technical Debt Tracker

Known technical debt and cleanup opportunities.

Active Debt

Item	Type	Severity	Origin	Notes
huggingface_hub/transformers version mismatch breaks test collection (is_offline_mode import error) in training/error-handling suites	Infra	D (Blocking)	F014 verification run	Blocks full-suite verification and should be resolved with a pinned compatible dependency set for training-related extras.

Types

• Code: Shortcuts, duplication, missing abstractions
• Tests: Missing coverage, flaky tests, slow tests
• Docs: Stale documentation, missing docs
• Infra: Build/deploy issues, tooling gaps
• Architecture: Layer violations, wrong boundaries

Severity

• D (Blocking): Must fix before next release
• C (Needs Refactor): Should fix soon, causing friction
• B (Minor): Would be nice to fix
• A (Clean): No action needed

Process

1. /techdebt command scans for issues and updates this file
2. compound-engineer may add items from feature work
3. what-how-alignment skill consolidates into refactor proposals
4. Items graduate to SUGGESTED_REFACTORS.md when ready for implementation

Resolved Debt

Item	Resolution	Date
None yet