Skip to content

placeholder-first-handoff

Always-loaded, engine-agnostic. The production-handoff contract for ordering a game asset from another team — art, VFX, audio, in-house or vendor. Before any Order … task goes out, the engine team publishes a slot: file exists, referenced, runs. No slot, not orderable.

FieldMeaning
slot-idStable id
pathExact repo path
filenameExact filename + extension, immutable
formatFile format, container/rig
specsDims/poly/tri/duration/loop/sample rate/channels; audio loudness target (LUFS/dBFS) — rules/game-feedback-mandate.md § SFX loudness
importImport settings applied
placeholderWhat’s committed now — deliberately ugly, so it can’t pass for done
wiredWhere it’s referenced from
acceptSelf-check before handoff; audio uses the swap-verification checklist in t1k:designer:base:feel-juice’s references/feedback-matrix.md
  1. Engine team commits placeholder FIRST — wired and exercised, not just present.
  2. Delivering team OVERWRITES in place (same path/filename/extension) — never add-then-delete, which breaks every existing reference to the file.
  3. Delivering team touches ONLY asset files.

Every order carries this table verbatim. <HARD-GATE> (rules/workflow-gates.md, core).

Full rationale (why the placeholder must be ugly, per-side definition-of-done, what this does not cover), per-engine mechanics: docs/placeholder-first-handoff.md.

rules/wired-not-just-present.md (core, the definition-of-done failure mode) · rules/game-feedback-mandate.md § SFX loudness (source of the specs/accept audio fields) · skills/t1k-team/references/contract-first-integration.md (core, the agent-fan-out sibling this generalizes) · rules/workflow-gates.md (core, the HARD-GATE contract) · game-asset-slot-handoff-unity.md (theonekit-unity) · rules/game-asset-slot-handoff-cocos.md (theonekit-cocos) · t1k:designer:puzzle:task-management (embeds this table in Order subtasks, designer#64) · docs/placeholder-first-handoff.md (full rationale)