.
This commit is contained in:
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": []
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,48 @@
|
||||
# Media and recording provider adapters
|
||||
|
||||
Select an adapter by capability. Tool names can change; the run contract must remain stable.
|
||||
|
||||
## Raster generation
|
||||
|
||||
Use for photography, illustration, texture, scene material, or image compositing. Do not render
|
||||
final interface typography or accessible controls into the bitmap.
|
||||
|
||||
Required evidence:
|
||||
|
||||
- complete prompt and all reference-image roles;
|
||||
- provider/model identifier and generation date;
|
||||
- input and output paths copied into the run;
|
||||
- review status and usage-rights note;
|
||||
- a code-native fallback when the asset is nonessential.
|
||||
|
||||
## Video generation
|
||||
|
||||
Use for ambient footage, product-world imagery, texture motion, or an explicitly narrative asset.
|
||||
Do not substitute a generated clip for a real clickable UI state transition.
|
||||
|
||||
Required evidence:
|
||||
|
||||
- prompt, input still/video, duration, aspect ratio, and intended consuming shot;
|
||||
- provider/model identifier;
|
||||
- output copied into the run and labeled `generated-media`;
|
||||
- temporal review for warping, unreadable text, accidental UI, and loop seams.
|
||||
|
||||
## Prototype recording
|
||||
|
||||
Record the real app or browser prototype at its locked viewport. Capture each signature scene from
|
||||
a stable start state and include interruption/back behavior. Store the raw recording before any
|
||||
showcase edit.
|
||||
|
||||
Required evidence:
|
||||
|
||||
- route/build identifier and viewport;
|
||||
- interaction script and input method;
|
||||
- raw recording path;
|
||||
- extracted start/mid/end frames;
|
||||
- reduced-motion capture when the scene materially changes.
|
||||
|
||||
## Reel composition
|
||||
|
||||
Compose only after the prototype passes. The shot manifest remains authoritative. A reel can mix
|
||||
prototype recordings and generated media, but every shot must retain its `sourceType`. Do not apply
|
||||
editing that makes the product appear to support an interaction it does not support.
|
||||
Reference in new issue
Block a user