You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@magpie.apache.org by "potiuk (via GitHub)" <gi...@apache.org> on 2026/09/16 10:30:46 UTC

[PR] docs: design for the security-story demo [magpie-site]

potiuk opened a new pull request, #177:
URL: https://github.com/apache/magpie-site/pull/177

   The design doc behind the animated demo in the landing page's **See it in
   action** band — the existing `SecurityStoryDemo` component. Adding it to the
   repo so the decisions it records are reviewable, rather than living only on
   one laptop.
   
   It carries one story end to end: install Magpie, set it up, isolate and guard,
   import and triage a security report, move it across the tracker board, publish
   the CVE, announce it.
   
   ## What it records
   
   - **One accumulated elapsed value drives every scene.** Scenes are pure
     functions of `(beat, progress)` and hold no timers, so jumping to a chapter
     is just assigning `elapsed` — no per-scene "fast-forward to my end state"
     path, which is where that kind of design usually goes wrong.
   - **The project shown is fictional and must read that way** — RFC 2606 reserved
     domains, a placeholder `CVE-2026-XXXXX` id that cannot collide with a real
     identifier, and an *Illustration · fictional project* ribbon on every scene
     that could otherwise be screenshotted as a real advisory.
   - **The agent proposes; a human sends.** Every outward-facing action passes a
     confirmation gate on screen, and the genie never appears on a step a human
     took — it is absent from both Sends.
   - **One command, then plain language.** `/magpie-setup` is the only Magpie
     command anyone types; everything after it is asked for in ordinary words.
     Asserted by the checks: exactly one typed command may start with `/magpie`.
   - **Accessibility is not optional** — a transcript derived from the same script
     constant, and `prefers-reduced-motion: reduce` renders a static stack.
   
   Docs only; no code changes. It also explains why `InstallDemo.tsx` and its
   README were removed — the README was a shooting script for a recording that
   was never going to be made.
   
   Depends on nothing, but reads better after #176, which removes
   `docs/superpowers/` from `.gitignore`.
   
   🤖 Generated with [Claude Code](https://claude.com/claude-code)
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@magpie.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] docs: design for the security-story demo [magpie-site]

Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk merged PR #177:
URL: https://github.com/apache/magpie-site/pull/177


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@magpie.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org