Chore: updated TODO and HANDOFF.

1 files changed, 16 insertions, 1 deletions

diff --git a/CLAUDE.md b/CLAUDE.md
index 952aac6..ef0f145 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -65,9 +65,24 @@ Workers emit `output(str)`, `error(str)`, `finished(bool)` signals. UI connects
 
 **Config path override in tests:** Pass `path` explicitly to `Config.load(path)` / `Config.save(path)` rather than monkeypatching the module-level constant.
 
+## System Theme (Kvantum + qt6ct)
+
+App uses system Qt theme via two symlinks into PyQt6's plugin bundle. These are required for Kvantum-dark + qt6ct to work and are **not** tracked in git.
+
+```bash
+PYQT6=$(python3 -c "import os,PyQt6; print(os.path.join(os.path.dirname(PyQt6.__file__),'Qt6','plugins'))")
+mkdir -p "$PYQT6/styles"
+ln -sf /usr/lib64/qt6/plugins/styles/libkvantum.so "$PYQT6/styles/libkvantum.so"
+ln -sf /usr/lib64/qt6/plugins/platformthemes/libqt6ct.so "$PYQT6/platformthemes/libqt6ct.so"
+```
+
+**Recreate after every `pip install --upgrade PyQt6`** — pip wipes the bundle, symlinks are lost.
+
+PyQt6 is pinned to `>=6.10.0,<6.11.0` in `requirements.txt` to match system Qt6 (6.10.3). Kvantum uses Qt private API — upgrading PyQt6 beyond the system Qt minor version causes segfault.
+
 ## Spec and Plan
 
 Full design spec: `docs/superpowers/specs/2026-05-01-my-publisher-design.md`  
 Implementation plan (20 tasks): `docs/superpowers/plans/2026-05-01-my-publisher.md`
 
-Implementation is in progress — tasks 1–4 complete (scaffold, config, models, frontmatter parser). Tasks 5–20 pending.
+All 20 tasks complete. v1.0 shipped with full functionality: scaffold, config, models, frontmatter parser, article scanner, taxonomy, git worker, hugo worker, translation worker, and all UI components.