game-feedback-mandate
Game Feedback Mandate
Section titled “Game Feedback Mandate”Always-loaded, engine-agnostic. Every player-facing action ships WITH its feedback in the same PR as the action itself — a feature with no sensory confirmation is incomplete, exactly like one with no test.
Contract — HARD-GATE
Section titled “Contract — HARD-GATE”Channels: visual · vfx · sfx · haptic · ui. Classes: input-ack · valid-action ·
invalid-action · progress · milestone · terminal. This table IS the blocking gate:
| action class | visual | vfx | sfx | haptic | ui |
|---|---|---|---|---|---|
input-ack | REQUIRED | — | optional | REQUIRED | — |
valid-action | REQUIRED | optional | REQUIRED | optional | — |
invalid-action | REQUIRED | — | REQUIRED | REQUIRED | — |
progress | REQUIRED | optional | REQUIRED | — | REQUIRED |
milestone | REQUIRED | REQUIRED | REQUIRED | optional | REQUIRED |
terminal | REQUIRED | REQUIRED | REQUIRED | optional | REQUIRED |
SFX loudness band (also blocking): volume scales inversely with fire rate —
| Fire rate | Target |
|---|---|
| more than 2/sec | −18 to −24 LUFS |
| 0.3 to 2/sec | −12 to −18 LUFS |
| less than 0.3/sec | −8 to −12 LUFS |
| once per level | −3 to −8 LUFS |
No stated target, or a wrong-band cue, fails the gate like a missing channel. Peak/voice/vendor
rules, timing budget, invariants: docs/game-feedback-mandate.md. How to measure + full
standard: feel-juice feedback-matrix.md § Measuring.
Variation (V1, blocking): >3×/level or session ships ≥3 variants on the dominant
channel; below that, one is fine. V2–V7 are non-blocking reviewer defaults. Full table: feel-juice’s
references/feedback-matrix.md § Variation Rules.
Waiver: a REQUIRED cell or V1 ships unmet ONLY via inline feedback-waiver: <reason> in the
PR/contract; no waiver = gate fails.
Enforcement + how to apply
Section titled “Enforcement + how to apply”HARD-GATE (rules/workflow-gates.md, not restated here); the waiver above is the named override.
Classify the action → fill its Feedback Matrix row (feel-juice’s references/feedback-matrix.md)
→ implement every REQUIRED cell in the same PR or record a waiver. t1k:cook/t1k:review and
design review block on any unwaived gate violation above — AskUserQuestion the gap, never ship
silently.
Related
Section titled “Related”t1k:designer:base:feel-juice § references/feedback-matrix.md (full contract + examples) ·
t1k:designer:base:feel-foundations (timing theory) · rules/observable-gameplay.md ·
rules/workflow-gates.md (core) · game-feedback-mandate-unity.md (theonekit-unity) ·
t1k:cocos:playable:juice § references/feedback-channel-mechanisms.md (theonekit-cocos, when installed) ·
docs/game-feedback-mandate.md (full detail, history)