diff --git a/README.md b/README.md
index 05a4f95..e3281df 100644
--- a/README.md
+++ b/README.md
@@ -23,7 +23,7 @@ UI examples for [Traverse](https://github.com/traverse-framework/Traverse).
 | **trace-explorer** | Browse execution traces (debugger — not a product shell to copy) | [web](apps/trace-explorer/web-react/) |
 | **LLM MCP façades** | Claude / Cursor / ChatGPT / Grok call the same workflows via MCP (not prompt skills) | [`apps/llm-mcp-reference/`](apps/llm-mcp-reference/) · [section](#llm-mcp-reference-façades) |
 
-**Extra demos / kits** — useful samples, **not** the production OS-shell pattern to copy (prefer traverse-starter / doc-approval / meeting-notes):
+**Extra demos / kits** — useful samples, **not** the production OS-shell pattern to copy (prefer traverse-starter / doc-approval / meeting-notes). Upgrade-or-retire classifications (Spec 004): [`docs/demo-inventory.md`](docs/demo-inventory.md).
 
 | Demo | Path |
 |---|---|
diff --git a/docs/demo-inventory.md b/docs/demo-inventory.md
new file mode 100644
index 0000000..66e8c07
--- /dev/null
+++ b/docs/demo-inventory.md
@@ -0,0 +1,33 @@
+# Demo upgrade-or-retire inventory
+
+Governing: Spec [`004-demo-upgrade-or-retire`](specs/004-demo-upgrade-or-retire/spec.md), ADR [`0004`](adr/0004-demo-retire-delete-with-scrub.md).
+
+Reconciled against `find apps -maxdepth 1 -type d` on 2026-08-11. Primaries are listed for completeness; Spec 004 actions apply only to non-primaries.
+
+| Path | Classification | Rationale | Follow-up ticket-id |
+|---|---|---|---|
+| `apps/traverse-starter` | already-primary | Production multi-OS reference shell | — |
+| `apps/meeting-notes` | already-primary | Production multi-OS product shell | — |
+| `apps/doc-approval` | already-primary | Production multi-OS product shell | — |
+| `apps/trace-explorer` | already-primary | Debugger companion (web-only by design) | — |
+| `apps/react-demo` | retire | Expedition browser sample; Spec 004 non-goal as production pattern; primaries own Web UX | `retire-react-demo` |
+| `apps/android-demo` | retire | Expedition Android sample; superseded by primary Android Compose shells | `retire-android-demo` |
+| `apps/macos-demo` | retire | Expedition macOS sample; superseded by primary SwiftUI shells | `retire-macos-demo` |
+| `apps/browser-consumer` | upgrade | Keep as downstream browser façade; align to Specs 001/002 and stop depending on `react-demo` once that path retires | `upgrade-browser-consumer-events` |
+| `apps/youaskm3-starter-kit` | upgrade | Keep as downstream getting-started kit; point at embedded/public surfaces + Specs 001/002 vocabulary | `upgrade-youaskm3-starter-kit-events` |
+| `apps/llm-mcp-reference` | upgrade | Active secondary LLM MCP façades; keep and align workflow docs to event presentation contract | `upgrade-llm-mcp-reference-events` |
+
+## Follow-up board items (Future until inventory merges)
+
+| ticket-id | Project 2 item |
+|---|---|
+| `retire-react-demo` | `PVTI_lADOEbiBt84BbzAzzg2Lkhk` |
+| `retire-android-demo` | `PVTI_lADOEbiBt84BbzAzzg2Lkik` |
+| `retire-macos-demo` | `PVTI_lADOEbiBt84BbzAzzg2Lkjg` |
+| `upgrade-browser-consumer-events` | `PVTI_lADOEbiBt84BbzAzzg2LklM` |
+| `upgrade-youaskm3-starter-kit-events` | `PVTI_lADOEbiBt84BbzAzzg2Lkms` |
+| `upgrade-llm-mcp-reference-events` | `PVTI_lADOEbiBt84BbzAzzg2Lkno` |
+
+## Status
+
+Inventory only — no apps removed in this document’s landing PR. Follow-up Project 2 tickets start as `Future` until this inventory merges (Spec 004 validation). Retire PRs must scrub CI/docs in the same change and add a README **Retired demos** note (ADR-0004).