Files
test-project-161/.agents/skills/ss-studio/references/artifact-contract.md
T
2026-08-12 02:11:40 -07:00

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": []
}