Merge branch 'main' into codex/mobile-toolbar-clarity

Author: a-baran-orhan

README.md

@@ -37,7 +37,12 @@
   </a>
 </p>
 
-> **OpenAI Build Week 2026:** Posecode existed before the hackathon. During Build Week, the project is being meaningfully extended with a GPT-5.6-powered biomechanical Physics Critic and an end-to-end Codex-built agent workflow. The sections below clearly distinguish previous work from new hackathon work.
+---
+
+## Why Posecode?
+
+Ask an LLM to explain physical movement and it usually returns unstructured prose or a static diagram.
+
 
 <p align="center">
   <img
@@ -57,6 +62,46 @@
   </sub>
 </p>
 
+For example:
+
+> Bend your knees, move your hips backward, and keep your chest upright.
+
+A human may understand that instruction, but a renderer cannot reliably determine:
+
+- which joints should move,
+- by how many degrees,
+- in which coordinate frame,
+- over what duration,
+- in what sequence,
+- or within which physical limits.
+
+Large language models can often reason about the components of human movement, but they lack a standardized syntax for expressing that reasoning in a renderable and testable form.
+
+Posecode provides that missing representation.
+
+### See Posecode in 28 seconds
+
+From an LLM prompt to editable Posecode, validated 3D rendering, MCP tools,
+and a one-script web embed.
+
+<p align="center">
+  <a href="docs/launch-media/posecode-cut2-builder-16x9.mp4">
+    <img
+      src="docs/launch-media/posecode-cut2-payoff.png"
+      width="800"
+      alt="Watch the 28-second Posecode builder demo"
+    />
+  </a>
+</p>
+
+<p align="center">
+  <a href="docs/launch-media/posecode-cut2-builder-16x9.mp4"><b>▶ Watch the 28-second builder demo</b></a>
+  <br />
+  <sub>Plain text in. Smooth, programmable 3D motion out.</sub>
+</p>
+
+### Movement examples
+
 <table align="center">
   <tr>
     <td align="center">
@@ -79,77 +124,6 @@
 
 ---
 
-## OpenAI Build Week Extension
-
-### What existed before July 13, 2026
-
-Before OpenAI Build Week, Posecode already included:
-
-- the core `.posecode` domain-specific language,
-- a parser and intermediate motion representation,
-- basic range-of-motion validation,
-- a Three.js/WebGL renderer,
-- forward kinematics,
-- basic inverse-kinematics and ground-lock behavior,
-- a browser playground,
-- example movement files,
-- shareable Posecode links,
-- and an MCP server foundation.
-
-This original version was developed primarily with **Claude** as an AI-assisted engineering tool.
-
-That prior work provides the foundation for the project, but it is not presented as the new hackathon contribution.
-
-### What is being added during Build Week
-
-During the July 13–21 Build Week submission period, Posecode is being meaningfully extended with:
-
-1. **GPT-5.6 Physics Critic**
-2. **Biomechanical fidelity scorecard**
-3. **Natural-language-to-motion agent workflow**
-4. **Interactive generation and critique experience**
-5. **Codex-built tests, tooling, and renderer improvements**
-
-The new workflow allows a user to describe a movement in ordinary language, generate structured Posecode, validate it deterministically, and receive a detailed GPT-5.6 critique explaining biomechanical or spatial problems.
-
-### Build Week feature status
-
-- [ ] GPT-5.6 movement generation
-- [ ] GPT-5.6 Physics Critic
-- [ ] Structured fidelity-score response
-- [ ] Critique panel in the playground
-- [ ] Generate → validate → critique → revise loop
-- [ ] MCP tools for critique and revision
-- [ ] Automated tests for the new workflow
-- [ ] Demo-ready example movements
-- [ ] Build Week commit links added below
-- [ ] Codex session ID added below
-
----
-
-## Why Posecode?
-
-Ask an LLM to explain physical movement and it usually returns unstructured prose or a static diagram.
-
-For example:
-
-> Bend your knees, move your hips backward, and keep your chest upright.
-
-A human may understand that instruction, but a renderer cannot reliably determine:
-
-- which joints should move,
-- by how many degrees,
-- in which coordinate frame,
-- over what duration,
-- in what sequence,
-- or within which physical limits.
-
-Large language models can often reason about the components of human movement, but they lack a standardized syntax for expressing that reasoning in a renderable and testable form.
-
-Posecode provides that missing representation.
-
----
-
 ## Why Not Diffusion Text-to-Motion?
 
 Neural text-to-motion systems can generate impressive movement, but they introduce problems for lightweight, programmable applications.
@@ -305,37 +279,6 @@ npm run build
 
 ---
 
-## GPT-5.6 Configuration
-
-> Update these instructions to match the final implementation.
-
-Create an environment file:
-
-```bash
-cp .env.example .env
-```
-
-Add your OpenAI API key:
-
-```env
-OPENAI_API_KEY=your_api_key_here
-```
-
-Optionally configure the model:
-
-```env
-OPENAI_MODEL=gpt-5.6
-```
-
-Start the application:
-
-```bash
-npm run dev
-```
-
-Never commit API keys to the repository.
-
----
 
 ## MCP Server
 
@@ -716,6 +659,56 @@ Feedback and contributions are welcome.
 ---
 
 
+> **OpenAI Build Week 2026:** Posecode existed before the hackathon. During Build Week, the project is being meaningfully extended with a GPT-5.6-powered biomechanical Physics Critic and an end-to-end Codex-built agent workflow. The sections below clearly distinguish previous work from new hackathon work.
+
+---
+
+## OpenAI Build Week Extension
+
+### What existed before July 13, 2026
+
+Before OpenAI Build Week, Posecode already included:
+
+- the core `.posecode` domain-specific language,
+- a parser and intermediate motion representation,
+- basic range-of-motion validation,
+- a Three.js/WebGL renderer,
+- forward kinematics,
+- basic inverse-kinematics and ground-lock behavior,
+- a browser playground,
+- example movement files,
+- shareable Posecode links,
+- and an MCP server foundation.
+
+This original version was developed primarily with **Claude** as an AI-assisted engineering tool.
+
+That prior work provides the foundation for the project, but it is not presented as the new hackathon contribution.
+
+### What is being added during Build Week
+
+During the July 13–21 Build Week submission period, Posecode is being meaningfully extended with:
+
+1. **GPT-5.6 Physics Critic**
+2. **Biomechanical fidelity scorecard**
+3. **Natural-language-to-motion agent workflow**
+4. **Interactive generation and critique experience**
+5. **Codex-built tests, tooling, and renderer improvements**
+
+The new workflow allows a user to describe a movement in ordinary language, generate structured Posecode, validate it deterministically, and receive a detailed GPT-5.6 critique explaining biomechanical or spatial problems.
+
+### Build Week feature status
+
+- [ ] GPT-5.6 movement generation
+- [ ] GPT-5.6 Physics Critic
+- [ ] Structured fidelity-score response
+- [ ] Critique panel in the playground
+- [ ] Generate → validate → critique → revise loop
+- [ ] MCP tools for critique and revision
+- [ ] Automated tests for the new workflow
+- [ ] Demo-ready example movements
+- [ ] Build Week commit links added below
+- [ ] Codex session ID added below
+
 ---
 
 ## The Build Week Feature: Physics Critic