diff --git a/ui/litellm-dashboard/docs/CYCLES.md b/ui/litellm-dashboard/docs/CYCLES.md
new file mode 100644
index 00000000000..5c791b78a70
--- /dev/null
+++ b/ui/litellm-dashboard/docs/CYCLES.md
@@ -0,0 +1,17 @@
+# Per-section cycle log
+
+One entry per section. A cycle = (make changes → run 5 test layers → record
+result). Cap is 7 cycles per section; exhausting the cap produces a blocker
+doc and (for every section except Access Groups) the run continues.
+
+Layer abbreviations: **TS** (tsc --noEmit), **Lint** (eslint), **Vitest**
+(unit + component tests), **Parity** (Playwright parity spec), **Snap**
+(visual snapshots).
+
+## <section>
+
+- Cycles used: N / 7
+- Layer outcomes per cycle:
+  - cycle 1: TS ✓ | Lint ✗ | Vitest — | Parity — | Snap —
+  - cycle 2: TS ✓ | Lint ✓ | Vitest ✓ | Parity ✓ | Snap ✓
+- Final status: done | blocked | wip
diff --git a/ui/litellm-dashboard/docs/DEVIATIONS.md b/ui/litellm-dashboard/docs/DEVIATIONS.md
new file mode 100644
index 00000000000..be44a4da6db
--- /dev/null
+++ b/ui/litellm-dashboard/docs/DEVIATIONS.md
@@ -0,0 +1,10 @@
+# Blueprint deviations and intentional snapshot rebaselines
+
+Format per entry:
+
+## <section> — <short title>
+
+- **Type:** `blueprint deviation` | `snapshot rebaseline` | `dead-code removal` | `blueprint update — stress test`
+- **Blueprint rule deviated from (if applicable):** ...
+- **What the agent did instead:** ...
+- **Why:** ...
diff --git a/ui/litellm-dashboard/docs/MIGRATION_REPORT.md b/ui/litellm-dashboard/docs/MIGRATION_REPORT.md
new file mode 100644
index 00000000000..886f53ed138
--- /dev/null
+++ b/ui/litellm-dashboard/docs/MIGRATION_REPORT.md
@@ -0,0 +1,13 @@
+# Phase 1 migration report
+
+**Status:** in progress — populated at end of run.
+
+Sections (33 total):
+
+- Done: …
+- Blocked: …
+- With deviations: …
+
+Deps delta: …
+Bundle size delta: …
+Known phase 2 prerequisites: …