File size: 1,330 Bytes
9e64e71 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 | # 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* | | |
|