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