chore: retire android-demo (retire-android-demo)

CLAUDE.md

@@ -24,7 +24,6 @@ apps/
     web-react/           # Trace Explorer — execution timeline debugger
   react-demo/            # Expedition React browser demo (adopted from Traverse)
   browser-consumer/      # Browser consumer façade
-  android-demo/          # Expedition Android demo
   macos-demo/            # Expedition macOS demo
   youaskm3-starter-kit/  # Downstream browser starter kit
 fixtures/                # Shared UI demo fixtures

README.md

@@ -28,11 +28,16 @@ UI examples for [Traverse](https://github.com/traverse-framework/Traverse).
 | Demo | Path |
 |---|---|
 | React browser demo | [`apps/react-demo/`](apps/react-demo/) |
-| Android demo | [`apps/android-demo/`](apps/android-demo/) |
 | macOS demo | [`apps/macos-demo/`](apps/macos-demo/) |
 | Browser consumer façade | [`apps/browser-consumer/`](apps/browser-consumer/) |
 | youaskm3 starter kit | [`apps/youaskm3-starter-kit/`](apps/youaskm3-starter-kit/) |
 
+### Retired demos
+
+| Path | Retired | Notes |
+|---|---|---|
+| `apps/android-demo` | 2026-08-12 | Spec 004 retire ([#251](https://github.com/traverse-framework/reference-apps/pull/251)); use primary Android Compose shells |
+
 ---
 
 ## By OS / target

docs/adopted-platform-clients.md

@@ -16,21 +16,20 @@ Ownership boundary (Traverse [#703](https://github.com/traverse-framework/Traver
 
 | Former Traverse path | Owner | Destination here |
 |---|---|---|
-| `apps/android-demo/` | Reference Apps | [`apps/android-demo/`](../apps/android-demo/) |
+| `apps/android-demo/` | Reference Apps | **Retired** 2026-08-12 (`retire-android-demo`) — use primary Android Compose shells |
 | `apps/browser-consumer/` | Reference Apps | [`apps/browser-consumer/`](../apps/browser-consumer/) |
 | `apps/macos-demo/` | Reference Apps | [`apps/macos-demo/`](../apps/macos-demo/) |
 | `apps/react-demo/` | Reference Apps | [`apps/react-demo/`](../apps/react-demo/) |
 | `apps/youaskm3-starter-kit/` | Reference Apps | [`apps/youaskm3-starter-kit/`](../apps/youaskm3-starter-kit/) |
 | `apps/llm-mcp-reference/` (new) | Reference Apps | [`apps/llm-mcp-reference/`](../apps/llm-mcp-reference/) — LLM MCP façades; [`llm-reference-apps-plan.md`](llm-reference-apps-plan.md) |
 | Runtime fixtures / manifests | Traverse | `examples/` in Traverse (not adopted) |
 
-Shared fixture for native demos: [`fixtures/expedition-runtime-session.json`](../fixtures/expedition-runtime-session.json).
+Shared fixture for remaining native demos: [`fixtures/expedition-runtime-session.json`](../fixtures/expedition-runtime-session.json).
 
 ## Validation commands (secondary / adopted)
 
 | Artifact | Command |
 |---|---|
-| Android demo | `bash scripts/ci/android_demo_smoke.sh` |
 | macOS demo | `bash scripts/ci/macos_demo_smoke.sh` |
 | React demo | `bash scripts/ci/react_demo_smoke.sh` |
 | youaskm3 starter | `bash scripts/ci/youaskm3_starter_kit_smoke.sh` |

docs/demo-inventory.md

@@ -11,7 +11,7 @@ Reconciled against `find apps -maxdepth 1 -type d` on 2026-08-11. Primaries are
 | `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/android-demo` | retire (done) | Removed 2026-08-12; 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` |

docs/production-playbook.md

@@ -39,7 +39,7 @@ Rules:
 | App | Status |
 |---|---|
 | trace-explorer | **Debugger** — embedded Trace API (`embedded-trace-api/1.0.0`); not a secondary “product” kit |
-| react-demo, android-demo, macos-demo, youaskm3-starter-kit, browser-consumer | **Adopted / secondary** demos & kits — lighter maintenance; not merge-blocking `embedded_smoke` targets — see [`adopted-platform-clients.md`](adopted-platform-clients.md) |
+| react-demo, macos-demo, youaskm3-starter-kit, browser-consumer | **Adopted / secondary** demos & kits — lighter maintenance; not merge-blocking `embedded_smoke` targets — see [`adopted-platform-clients.md`](adopted-platform-clients.md) (`android-demo` retired) |
 
 ---
 

docs/production-reference-plan.md

@@ -44,7 +44,7 @@ Related:
 | Tier | Apps | Smoke / CI bar |
 |---|---|---|
 | **Primary product shells** | `traverse-starter`, `doc-approval`, `meeting-notes` | Production DoD; Linux-runnable `embedded_smoke` hard-fail |
-| **Adopted / secondary** | `react-demo`, `android-demo`, `macos-demo`, `browser-consumer`, `youaskm3-starter-kit`, `llm-mcp-reference` | Lighter demo smokes only — **not** merge-blocking `embedded_smoke` targets |
+| **Adopted / secondary** | `react-demo`, `macos-demo`, `browser-consumer`, `youaskm3-starter-kit`, `llm-mcp-reference` | Lighter demo smokes only — **not** merge-blocking `embedded_smoke` targets (`android-demo` retired) |
 | **Debugger** | `trace-explorer` | Embedded Trace API companion — not a product shell to copy |
 
 Canonical narrative: [`adopted-platform-clients.md`](adopted-platform-clients.md) · front door: root `README.md`.

scripts/ci/repository_checks.sh

@@ -96,8 +96,6 @@ check "manifests/meeting-notes/app.manifest.json"                       "meeting
 check "manifests/meeting-notes/components/process/component.manifest.json" "meeting-notes process component"
 
 # Adopted Traverse platform demos / starter (issue #151)
-check "apps/android-demo/README.md"                                     "android-demo README"
-check "apps/android-demo/app/src/main/java/com/traverse/demo/android/MainActivity.kt" "android-demo MainActivity"
 check "apps/browser-consumer/index.js"                                  "browser-consumer package"
 check "apps/macos-demo/Package.swift"                                   "macos-demo Package.swift"
 check "apps/react-demo/src/main.js"                                     "react-demo main"
@@ -108,7 +106,6 @@ check "fixtures/expedition-runtime-session.json"                        "expedit
 check "docs/adopted-platform-clients.md"                                "adopted platform clients doc"
 check "docs/production-playbook.md"                                     "production playbook"
 check "docs/youaskm3-starter-kit.md"                                    "youaskm3 starter guide"
-check "scripts/ci/android_demo_smoke.sh"                                "android demo smoke"
 check "scripts/ci/macos_demo_smoke.sh"                                  "macos demo smoke"
 check "scripts/ci/react_demo_smoke.sh"                                  "react demo smoke"
 check "scripts/ci/youaskm3_starter_kit_smoke.sh"                        "youaskm3 starter smoke"