Skip to content

docs: promote v5 live companion as recommended demo UI - #29

Merged
cmcornejocrespo merged 4 commits into
mainfrom
docs/promote-v5-live-companion
Sep 8, 2026
Merged

docs: promote v5 live companion as recommended demo UI#29
cmcornejocrespo merged 4 commits into
mainfrom
docs/promote-v5-live-companion

Conversation

@cmcornejocrespo

Copy link
Copy Markdown
Collaborator

Summary

  • Promote docs/demo/v5/live.html as the recommended on-stage live companion across launcher, presenter serve, and documentation
  • Point README architecture PNG export and CI screenshot at v5 selectors instead of v3
  • Filter conditional nodes (file, guardrailsLlm) from the overall architecture baseline map
  • Align demo narratives, AGENTS.md, README, and Cursor skills to v5 references

Details

v5 supersedes v3 as the live demo companion (quick-run cluster buttons, unified script runner, YAML snippets in instructions). This PR updates all entry points and runbooks so presenters land on v5 by default while v1–v4 remain reachable as deprecated bookmarks.

Area Change
Launcher (index.html) v5 CSS/chrome; primary link to v5/live.html
demo-presenter-serve.sh Default URL and banner → v5; v3/v4 listed as deprecated
Architecture export export-readme-architecture.sh + Playwright test target v5 step 0
Overall diagram Exclude conditional nodes from baseline buildOverallNodes()
Docs & skills Narratives, AGENTS.md, README, demo skills → v5 paths

Key findings during testing:

  • ./scripts/validate-demo-ui.sh passes (125 unit tests)
  • Local make export-architecture failed in Podman (network to npm registry); CI on ubuntu-latest should regenerate the PNG

Test plan

  • ./scripts/validate-demo-ui.sh
  • ./scripts/validate-demo-external-css.sh
  • CI export-readme-architecture job produces matching assets/overall-architecture.png
  • ./scripts/demo-presenter-serve.sh opens http://127.0.0.1:8765/demo/v5/live.html by default

Made with Cursor

cmcornejocrespo and others added 4 commits September 8, 2026 16:08
Exclude file and guardrailsLlm from the baseline overall map so conditional
nodes do not appear in the README export and live companion step 0.

Co-authored-by: Cursor <cursoragent@cursor.com>
Point launcher, presenter serve, and README architecture export at v5/live.html.
Mark v3/v4 as deprecated in serve output while keeping them reachable.

Co-authored-by: Cursor <cursoragent@cursor.com>
Update demo runbooks, AGENTS.md, README, and Cursor skills so on-stage
references consistently point to v5/live.html instead of v3.

Co-authored-by: Cursor <cursoragent@cursor.com>
Remove Playwright diagram export and stale-PNG check from CI. Simplify
export-readme-architecture.sh to native local-only regeneration and commit
an updated overall-architecture.png from v5 step 0.

Co-authored-by: Cursor <cursoragent@cursor.com>
@cmcornejocrespo
cmcornejocrespo merged commit cc82bfb into main Sep 8, 2026
1 check passed
@cmcornejocrespo
cmcornejocrespo deleted the docs/promote-v5-live-companion branch September 8, 2026 14:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant