# Studio artifact contract Use these fields exactly. Extra task-specific fields are allowed, but required fields may not be renamed. ## `references.json` ```json { "items": [{ "id": "R1", "role": "structure | navigation | signature | motion | asset-language", "source": "URL or path", "observedAt": "ISO-8601", "observation": "visible fact", "principle": "transferable decision", "confidence": "high | medium | low", "rights": "usage/provenance note" }] } ``` ## `directions.json` `directions` contains exactly one `native`, one `signature`, and one `experimental` direction. ```json { "directions": [{ "id": "signature", "lane": "signature", "name": "user-facing name", "promise": "one-sentence product experience", "grammar": "built-in or reference grammar id", "recipe": "brand recipe id", "palette": "palette recipe id", "composition": "focal and spatial logic", "navigationChrome": "chrome/canvas relationship and states", "typeAndMaterial": "type, color, surface, and image material", "assetDirection": "what media is generated and why", "motionDirection": "continuity and feedback logic", "signatureMove": "one product-owned interaction", "tradeoffs": ["..."], "cost": "low | medium | high", "risk": "low | medium | high" }] } ``` ## `selection.json` ```json { "selectedDirectionId": "signature", "decisionBy": "reviewer name", "decidedAt": "ISO-8601", "rationale": "why this direction fits the job" } ``` ## `scenes.json` ```json { "scenes": [{ "id": "open-focus", "trigger": "tap focus card", "from": "home-rest", "to": "focus-detail", "continuity": ["selected card", "title"], "enter": ["detail controls"], "exit": ["secondary feed"], "feedback": "selected card lifts into the content plane", "interrupt": "back or reverse gesture restores the source card", "reducedMotion": "instant state swap plus focus movement", "rendererTargets": ["web"] }] } ``` ## `assets.json` ```json { "jobs": [{ "id": "A1", "role": "ambient hero texture", "kind": "raster | vector | video | audio", "capability": "raster-generate", "provider": "provider/tool id or unassigned", "prompt": "complete reproducible prompt", "inputs": [], "output": "relative path or null", "status": "planned | running | complete | blocked | rejected", "provenance": "model/tool/date or pending", "rights": "client usage and source note", "fallback": "code-native or alternate media treatment", "consumingScene": "scene id" }] } ``` ## `video.json` ```json { "mode": "prototype-first", "shots": [{ "id": "V1", "sourceType": "prototype-recording | generated-media", "scene": "scene id", "durationMs": 2400, "source": "relative path or null", "status": "planned | complete | blocked", "notes": "camera, crop, caption, or compositing instruction" }] } ``` ## `verification.json` ```json { "gates": { "code": "pending | pass | fail | blocked", "visual": "pending | pass | fail | blocked", "temporal": "pending | pass | fail | blocked", "human": "pending | pass | fail | blocked" }, "evidence": [{"gate": "visual", "path": "relative path", "note": "what it proves"}], "reviewer": "name or null", "acceptedAt": "ISO-8601 or null", "risks": [] } ```