preparation for ui re-shelling

docs/modules/ui/v2-rewire/README.md

@@ -0,0 +1,34 @@
+# UI v2 Rewire (Canonical Planning Set)
+
+This directory contains two things:
+- Raw iterative design packs (`pack-01.md` ... `pack-21.md`)
+- Cleansed planning inputs for sprint decomposition
+
+Use these files as the planning entrypoint:
+- `source-of-truth.md` - canonical IA decisions and normalized terminology
+- `authority-matrix.md` - pack precedence, supersession, and explicit overrides
+- `sprint-planning-guide.md` - how to split this redesign into many implementation sprints
+- `multi-sprint-plan.md` - first full many-sprint decomposition (Draft 1)
+
+S00 package files:
+- `S00_sprint_spec_package.md` - detailed S00 sprint spec with acceptance criteria
+- `S00_contract_ledger_template.md` - reusable endpoint contract ledger template
+- `S00_endpoint_contract_ledger_v1.md` - starter ledger sheet for immediate use
+
+## Precedence policy
+
+This planning set uses a strict rule: for overlapping decisions, **higher pack number wins**.
+
+A higher pack that does not define a screen in detail does not erase the latest lower-pack detail for that screen.
+
+## Raw materials
+
+Raw packs are preserved as historical input and should not be used directly as the source of truth for sprint planning:
+- `pack-01.md` ... `pack-21.md`
+- `prompt.txt`
+
+## Planning rule
+
+When a sprint references a UI redesign requirement, it must cite:
+1. The canonical file (`source-of-truth.md` and/or `authority-matrix.md`), and
+2. The authoritative pack section listed there.