# LESSON_LEARNED — mgf-brand-web

> Append-only, dated log of non-obvious lessons learned working in this repo.
> Newest first. One entry per lesson. Supersede a wrong past entry with a new
> one — never rewrite history. Federation rule: **DOC-19**.

---

## 2026-06-29 — Extracted the brand-web kit into a shared package

- **Context:** the Magogi brand-web CSS/asset kit was authored inside
  `mgf-cloud-app` (the "copy now, kit-ready" decision). It was lifted here so
  every MGF web surface consumes one source of truth instead of copying CSS.
- **What I learned:** a shared asset package introduces a **release-order
  dependency** — a consumer can only pin `mgf-brand-web` once it is published to
  the devpi index, otherwise its install/CI can't resolve it. So the package must
  ship + publish *before* consumers cut over; cutting a consumer over to an
  unpublished sibling breaks its install.
- **Why it matters:** sequencing the cutover wrong breaks the working consumer.
- **How to apply:** ship + publish the leaf package first (wave 0), then walk
  consumers forward. Keep this package **framework-free** (import-linter contract)
  so any web stack can depend on it.
- **Generalizes?:** yes — the wave-order rule for any new shared dependency.

---

## 2026-06-29 — File seeded (repo creation)

- **Context:** `mgf-brand-web` scaffolded as a conformant federation sibling.
- **What I learned:** (seed entry).
- **Why it matters:** lessons left only in chat transcripts evaporate.
- **How to apply:** add a dated entry when you hit a gotcha or reusable technique.
- **Generalizes?:** n/a (seed entry).

---
