Material 3 Theming — planning archive¶
Index of all planning and execution documentation for the M001 + M002 theming work shipped via PR #2322. Originally lived in .gsd/milestones/M001/*, .gsd/milestones/M002/*, .gsd/DECISIONS.md, .gsd/REQUIREMENTS.md, and .gsd/PROJECT.md — preserved here as a cohesive archive so the strategic narrative, decision record, requirement traceability, and slice-level execution receipts all remain accessible independent of the separate .gsd/ cleanup effort.
Note on lifecycle: this is a temporary planning archive for completed work. Once the outstanding follow-ups (see
../material-3-theming-roadmap.md) are tracked elsewhere, the archive can be retired.
Reading order¶
| Doc | Purpose | When to read |
|---|---|---|
../material-3-theming-roadmap.md |
Top-level narrative. Distilled M001 + M002 story, M3 practical guidance, follow-ups, 24-decision register. | Start here. |
project-description.md |
Project-level elevator pitch, current state before the work, architectural context. | For the "why" if the roadmap's framing isn't enough. |
requirements.md |
Capability contract R001–R018 with status, owning slice, and validation evidence. | When you need to know what was promised + proved. |
milestone-narratives.md |
Verbatim M001/M002 context, research, and completion summaries, plus the PR #2322 status report. | When you want raw original wording (the roadmap paraphrases). |
m001-slices.md |
Slice-level execution archive for S01–S06 of M001 — plans, summaries, UATs, task decompositions. | For bug archaeology or "how did we actually do X?" questions. |
m002-slices.md |
Slice-level execution archive for S01–S03 of M002 (M3 system variable integration). | Same — slice-level detail. |
What's in the companion feature doc¶
docs/features/material-3-migration-plan.md is the forward-looking feature plan (approved 2026-02-06, last updated 2026-03-14). It pre-dates most of the execution intelligence captured here — treat it as the original vision and use this archive for what actually happened.
What's intentionally NOT preserved here¶
- BFF-auth content (Auth0 → OpenIddict migration): lives in
docs/planning/auth0-openiddict-*.mdon main. Irrelevant to theming. - KNOWLEDGE.md (K001–K004): the K-entries on this branch were merged in from the BFF-auth work and describe E2E test seeding / CDK overlay fixes / Lamar assembly scanning — not theming.
- Task-level
T0X-VERIFY.jsonfiles: machine-generated verification stubs with no narrative content. - Activity logs / runtime state / metrics.json / STATE.md: GSD tool state, not planning.
.gsd/milestones/M003+: BFF-auth migration phases (Parallel Auth, User Migration, Cutover).
Status¶
All 9 slices across M001 + M002 are complete; the work landed in PR #2322. Outstanding follow-ups are listed in the roadmap doc.