Production
One-skill production gate
The definition of done for a single skill — contract, server, animation, VFX, SFX, reactions, feel, performance, tests and review — with the evidence each item needs.
A skill is shippable only when every row is green in its task log. Signature skills also need owner sign-off.
| # | Item | Pass condition | Evidence |
|---|---|---|---|
| 1 | Contract | skills.json entry complete, including locomotion/steering and damage-entity ownership before implementation; data tests green | contract + test log |
| 2 | Server phases | phases/hit ids/costs correct; valid movement cancels every own attack phase; resolved hits stand; future owned hits stop; independent entities persist once | unit + replay tests, C1–C18 results |
| 3 | Shape | server shape = presentation footprint (overlay test) | capture with shape overlay |
| 4 | Reactions | each target class gets the reaction the rule predicts; specials respect class limits and Resolve | reaction-matrix test |
| 5 | States & payoffs | applies/consumes states correctly; payoff not self-applied; 60% cap respected | unit tests |
| 6 | Animation | versioned mannequin; contact ±1 frame; planted-foot slide < 2 cm; weapon drift < 1 cm; all lineages/body profiles; no odd limbs/head/feet or unwanted action in continuous motion and cancel/chain blends | anim tests + eight-view contact sheets + both gameplay cameras + self-review checklist |
| 7 | VFX | semantic roles complete; events ±16.7 ms; tier/frame budgets; no pool leaks; cancel cleanup; threat readability in crowd/both cameras and accessibility modes | budget JSON + Low/High clip + visual checklist |
| 8 | SFX | 4 layers bound; loudness in range; voice cap respected | audio report |
| 9 | Feel | hitstop/shake/flash per impact class; outcome identical with feel off | A/B replay diff |
| 10 | Facets | all 4 facets implemented and unit-tested | tests |
| 11 | Icon | final or placeholder with an open art request | data test |
| 12 | Performance | 100-dummy stress: frame budget per tier holds | perf.json |
| 13 | Review | 5–10 s clip from the gameplay camera, owner yes (signature) or reviewer yes (others) | logs/reviews.jsonl |
| 14 | Polish | every core detail of the AAA detail catalog that applies to the skill's type is shown by the proof listed there; later stages are not built early | proof per detail id |
Row 14 was added on 2026-10-06 (ADR-028). node tools/ctx.mjs skill <id> prints one skill's
contract and the catalog's core list.
Required scenarios and preparation sequence: development guide. These are future engine acceptance criteria. A documentation update or wiki preview does not complete this gate.
Source: zoen/docs/production/SKILL_GATE.md · 467 words · edit the Markdown, not this page.
