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