# UI v2 Rewire (Canonical Planning Set)

This directory contains two things:
- Raw iterative design packs (`pack-01.md` ... `pack-22.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
- `S00_endpoint_contract_ledger_v2_pack22.md` - Pack 22 contract delta and backend dependency baseline

## 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-22.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.