Add demo and social post submission sections

docs/demo-script.md

@@ -1,20 +1,63 @@
-# Public Demo Video Script
+# Demo Recording Script
 
-Target length: 75-90 seconds.
+Use this script to record a short demo video for judges. Keep it between 45 and 90 seconds if possible.
 
-1. Open the public Hugging Face Space and show that no local setup is required.
-2. Enter `MTech vs Software Job`.
-3. Highlight the single calibration answer and immediate first scene.
-4. Choose a high-risk option and show all five metrics and the environment update.
-5. Explain the causal ledger: facts, obligations, and closed options.
-6. Advance to the node-2 echo and node-5 delayed consequence.
-7. Show a different choice changing the later scene.
-8. Finish on the report and safety disclaimer.
-9. Close with: “One 7B model, bounded context, deterministic state, and a playable future rather than another chatbot.”
+## Goal
 
-Suggested title: `LifeChoice Simulator | Build Small Hackathon Demo`
+Show the app working end to end so judges can evaluate it even if API limits, model latency, or live runtime issues affect the Space during review.
 
-Suggested description:
+## Recording Flow
 
-> LifeChoice Simulator turns a real dilemma into a causal, metric-driven future. Built with Gradio, Qwen2.5-7B-Instruct, Hugging Face, and Codex for the Build Small Hackathon.
+1. Open the live Space:
+   https://huggingface.co/spaces/build-small-hackathon/LifeChoice-Simulator
 
+2. Start on the setup screen.
+   Use the default dilemma:
+   `MTech vs Software Job`
+
+3. Keep the selected path as:
+   `MTech`
+
+4. Use the calibration prompt:
+   `My family needs income soon, but a professor is already interested in my research.`
+
+5. Select the persona:
+   `Mentor`
+
+6. Click `Enter this future`.
+   Point out that the first scene starts immediately.
+
+7. Show the first scenario card, source label, metric panel, persona bubble, world state, and character sprite.
+
+8. Pick a choice and click `Commit choice`.
+   Mention that every choice updates deterministic metrics and creates durable consequences.
+
+9. Make two or three more choices.
+   Show that the world state, metrics, persona text, and later scenes respond to earlier decisions.
+
+10. Continue to the final report if time allows.
+    Show that the report is grounded in the causal ledger.
+
+## Suggested Voiceover
+
+This is LifeChoice Simulator, a causal future simulator for difficult decisions.
+
+Instead of giving one-shot advice, the app lets me enter a path and experience a short sequence of consequences. I choose MTech over a Software Job, add the real pressure behind the decision, and pick a mentor voice.
+
+The first scene loads immediately because it is deterministic. Later scenes can be enriched by a 7B model, but the simulation engine owns the actual state: metrics, facts, obligations, closed options, safety rules, and the final report.
+
+Every choice changes the world. The metric panel updates, the environment can move between stable, thriving, and struggling, and the character can become neutral, stressed, or confident.
+
+The important part is that earlier decisions return later. The app keeps a causal ledger, so the final report reflects what happened inside this simulation instead of pretending to predict real life.
+
+LifeChoice is built for reflection, not advice. It helps users see tradeoffs more clearly before making high-stakes decisions with real people in the loop.
+
+## Capture Checklist
+
+- Setup screen is visible.
+- First scene is visible.
+- At least one choice is committed.
+- Metrics visibly change.
+- World or character state is visible.
+- A cascade or final report is shown if time permits.
+- The video ends on the Space URL or README.