This commit is contained in:
dahyeon committed 2026-08-12 02:11:40 -07:00
1 parent 77a5f5248c
commit f0bba7e7b9
68 files changed
+5149 -142

No files matched your search

@@ -0,0 +1,135 @@
# 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": []
}
```