# LESSON_LEARNED — mgf-brand-qt

> Append-only, dated log of non-obvious lessons (DOC-19). Newest first.
> One entry per lesson; supersede a wrong past entry with a new one.

---

## 2026-07-10 — Extraction + first CI

- **Context:** the Magogi Qt design system was extracted from
  vm-vmanager-app's `vmanager.gui.design` into this kit under the
  GUI-01 UI-kit carve-out (mgf-standard PAPER-118), then onboarded to
  Woodpecker CI.
- **What I learned:** a GUI package's generated pipeline needs the Qt
  runtime system libraries declared in `[tool.mgf-fed] apt_packages`
  (python:*-slim ships none — `libglib`/`libegl`/xcb…) plus
  `QT_QPA_PLATFORM=offscreen` (set in `tests/conftest.py`), and
  `[tool.coverage.run] patch = ["subprocess"]` because the
  mgf-test-supervisor gate runs the suite in worker subprocesses
  (without it, `coverage combine` fails "No data to combine").
- **Why it matters:** the next Qt consumer (hrb-app hit the identical
  libglib failure) inherits these — they're the expensive-to-relearn
  first-CI gotchas for a Qt package.
