3.3 KiB
3.3 KiB
Studio artifact contract
Use these fields exactly. Extra task-specific fields are allowed, but required fields may not be renamed.
references.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.
{
"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
{
"selectedDirectionId": "signature",
"decisionBy": "reviewer name",
"decidedAt": "ISO-8601",
"rationale": "why this direction fits the job"
}
scenes.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
{
"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
{
"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
{
"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": []
}