Skip to content
T1KTheOneKit

placeholder-first-handoff

Placeholder-First Handoff

Section titled “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; for audio, the loudness target (LUFS/dBFS) per 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; for audio, 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.

Section titled “Related”
  • rules/wired-not-just-present.md (core) — the failure mode behind the engine-side definition of done
  • rules/game-feedback-mandate.md § SFX loudness — where the specs loudness target and accept swap-verification checklist for audio orders come from
  • rules/contract-first-integration.md (core) — the agent-fan-out sibling this rule generalizes to human teams
  • rules/workflow-gates.md (core) — the HARD-GATE contract this rule invokes
  • game-asset-slot-handoff-unity.md (theonekit-unity) — Unity/DOTS mechanics (GUID identity, .meta discipline)
  • Cocos arm — not yet written; a Cocos game-asset-slot-handoff rule is a gap, not an assumed capability
  • t1k:designer:puzzle:task-management — the skill whose Order subtasks embed this table (designer#64)
  • docs/placeholder-first-handoff.md — full rationale + per-engine mechanics