Skip to content

docs: demo upgrade-or-retire inventory (demo-upgrade-or-retire-inventory) #249

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
enricopiovesan merged 1 commit into from
Aug 12, 2026
Merged

docs: demo upgrade-or-retire inventory (demo-upgrade-or-retire-inventory) #249

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
|---|---|
Expand Down
33 changes: 33 additions & 0 deletions docs/demo-inventory.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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).
Loading