@opengamehq/skills 1.4.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (382) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/README.md +12 -4
  3. package/dist/.claude-plugin/marketplace.json +26 -0
  4. package/dist/skills/manifest.json +1406 -142
  5. package/dist/skills/opengame-accessibility/CHANGELOG.md +4 -0
  6. package/dist/skills/opengame-accessibility/SKILL.md +48 -32
  7. package/dist/skills/opengame-all-in-one/CHANGELOG.md +21 -0
  8. package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
  9. package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
  10. package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
  11. package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
  12. package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
  13. package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
  14. package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
  15. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
  16. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
  17. package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
  18. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
  19. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
  20. package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
  21. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
  22. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
  23. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
  24. package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
  25. package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
  26. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
  27. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
  28. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
  29. package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
  30. package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
  31. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
  32. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
  33. package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
  34. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
  35. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
  36. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
  37. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
  38. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
  39. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
  40. package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
  41. package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
  42. package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
  43. package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
  44. package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
  45. package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
  46. package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
  47. package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
  48. package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
  49. package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
  50. package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
  51. package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
  52. package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
  53. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
  54. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
  55. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
  56. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
  57. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
  58. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
  59. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
  60. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
  61. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
  62. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
  63. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
  64. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
  65. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
  66. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
  67. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
  68. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
  69. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
  70. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
  71. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
  72. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
  73. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
  74. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
  75. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
  76. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
  77. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
  78. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
  79. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
  80. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
  81. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
  82. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
  83. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
  84. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
  85. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  86. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
  87. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
  88. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
  89. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  90. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  91. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  92. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  93. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  94. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  95. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  96. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  97. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
  98. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
  99. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
  100. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
  101. package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
  102. package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
  103. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
  104. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
  105. package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
  106. package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
  107. package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
  108. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
  109. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
  110. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
  111. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
  112. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
  113. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
  114. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
  115. package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
  116. package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
  117. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
  118. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
  119. package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
  120. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
  121. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
  122. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
  123. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
  124. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
  125. package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
  126. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
  127. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
  128. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
  129. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
  130. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
  131. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
  132. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
  133. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
  134. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
  135. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
  136. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
  137. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
  138. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
  139. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
  140. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
  141. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
  142. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
  143. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
  144. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
  145. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
  146. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
  147. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
  148. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
  149. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
  150. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
  151. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
  152. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
  153. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
  154. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
  155. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
  156. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
  157. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
  158. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
  159. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
  160. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  161. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  162. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
  163. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
  164. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  165. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  166. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  167. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
  168. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
  169. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
  170. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  171. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
  172. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  173. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
  174. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
  175. package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
  176. package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
  177. package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
  178. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
  179. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
  180. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
  181. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
  182. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
  183. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
  184. package/dist/skills/opengame-api/CHANGELOG.md +8 -0
  185. package/dist/skills/opengame-api/SKILL.md +39 -13
  186. package/dist/skills/opengame-assets/CHANGELOG.md +11 -0
  187. package/dist/skills/opengame-assets/SKILL.md +79 -31
  188. package/dist/skills/opengame-assets/references/pipeline.md +67 -0
  189. package/dist/skills/opengame-audio/CHANGELOG.md +11 -0
  190. package/dist/skills/opengame-audio/SKILL.md +129 -41
  191. package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
  192. package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
  193. package/dist/skills/opengame-capture/CHANGELOG.md +10 -0
  194. package/dist/skills/opengame-capture/SKILL.md +44 -20
  195. package/dist/skills/opengame-capture/references/pipeline.md +33 -1
  196. package/dist/skills/opengame-capture/references/threejs.md +17 -1
  197. package/dist/skills/opengame-characters/CHANGELOG.md +15 -0
  198. package/dist/skills/opengame-characters/SKILL.md +94 -39
  199. package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
  200. package/dist/skills/opengame-characters/references/player-og.md +1 -1
  201. package/dist/skills/opengame-cli/CHANGELOG.md +12 -0
  202. package/dist/skills/opengame-cli/SKILL.md +11 -10
  203. package/dist/skills/opengame-deploy/CHANGELOG.md +20 -0
  204. package/dist/skills/opengame-deploy/SKILL.md +41 -21
  205. package/dist/skills/opengame-deploy/references/json-events.md +6 -5
  206. package/dist/skills/opengame-deploy/references/packaging.md +28 -26
  207. package/dist/skills/opengame-depth/CHANGELOG.md +8 -0
  208. package/dist/skills/opengame-depth/SKILL.md +61 -33
  209. package/dist/skills/opengame-enemies/CHANGELOG.md +10 -0
  210. package/dist/skills/opengame-enemies/SKILL.md +96 -40
  211. package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
  212. package/dist/skills/opengame-enemies/references/threejs.md +59 -0
  213. package/dist/skills/opengame-front-end/CHANGELOG.md +4 -0
  214. package/dist/skills/opengame-front-end/SKILL.md +85 -39
  215. package/dist/skills/opengame-front-end/references/menus.md +42 -8
  216. package/dist/skills/opengame-game-feel/CHANGELOG.md +11 -0
  217. package/dist/skills/opengame-game-feel/SKILL.md +95 -47
  218. package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
  219. package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
  220. package/dist/skills/opengame-jam/CHANGELOG.md +8 -0
  221. package/dist/skills/opengame-jam/SKILL.md +46 -31
  222. package/dist/skills/opengame-lighting/CHANGELOG.md +9 -0
  223. package/dist/skills/opengame-lighting/SKILL.md +85 -34
  224. package/dist/skills/opengame-loading/CHANGELOG.md +4 -0
  225. package/dist/skills/opengame-loading/SKILL.md +78 -38
  226. package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
  227. package/dist/skills/opengame-loading/references/threejs.md +32 -7
  228. package/dist/skills/opengame-look/CHANGELOG.md +9 -0
  229. package/dist/skills/opengame-look/SKILL.md +122 -51
  230. package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
  231. package/dist/skills/opengame-look/references/painterly.md +69 -0
  232. package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
  233. package/dist/skills/opengame-maps/CHANGELOG.md +9 -0
  234. package/dist/skills/opengame-maps/SKILL.md +78 -0
  235. package/dist/skills/opengame-maps/references/map-spec.md +77 -0
  236. package/dist/skills/opengame-mobile/CHANGELOG.md +4 -0
  237. package/dist/skills/opengame-mobile/SKILL.md +18 -18
  238. package/dist/skills/opengame-montage-make/CHANGELOG.md +5 -0
  239. package/dist/skills/opengame-montage-make/SKILL.md +187 -0
  240. package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
  241. package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
  242. package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
  243. package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
  244. package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
  245. package/dist/skills/opengame-montage-make/references/measure.md +282 -0
  246. package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
  247. package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
  248. package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
  249. package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
  250. package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
  251. package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
  252. package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
  253. package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
  254. package/dist/skills/opengame-montage-make/references/song.md +64 -0
  255. package/dist/skills/opengame-montage-plan/CHANGELOG.md +5 -0
  256. package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
  257. package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
  258. package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
  259. package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
  260. package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
  261. package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
  262. package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
  263. package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
  264. package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
  265. package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
  266. package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
  267. package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
  268. package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
  269. package/dist/skills/opengame-montage-plan/references/song.md +64 -0
  270. package/dist/skills/opengame-montage-review-and-improve/CHANGELOG.md +5 -0
  271. package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
  272. package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
  273. package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  274. package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
  275. package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
  276. package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
  277. package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  278. package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  279. package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  280. package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  281. package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  282. package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  283. package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  284. package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  285. package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
  286. package/dist/skills/opengame-multiplayer/CHANGELOG.md +15 -0
  287. package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
  288. package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
  289. package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
  290. package/dist/skills/opengame-performance/CHANGELOG.md +8 -0
  291. package/dist/skills/opengame-performance/SKILL.md +106 -65
  292. package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
  293. package/dist/skills/opengame-performance/references/measuring.md +51 -0
  294. package/dist/skills/opengame-performance/references/webgpu.md +86 -0
  295. package/dist/skills/opengame-production/CHANGELOG.md +13 -0
  296. package/dist/skills/opengame-production/SKILL.md +119 -54
  297. package/dist/skills/opengame-production/references/team.md +107 -0
  298. package/dist/skills/opengame-production/references/templates.md +106 -16
  299. package/dist/skills/opengame-quality-bar/CHANGELOG.md +10 -0
  300. package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
  301. package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
  302. package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
  303. package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
  304. package/dist/skills/opengame-rhythm/CHANGELOG.md +5 -0
  305. package/dist/skills/opengame-rhythm/SKILL.md +138 -0
  306. package/dist/skills/opengame-rhythm/references/charting.md +109 -0
  307. package/dist/skills/opengame-rhythm/references/timing.md +92 -0
  308. package/dist/skills/opengame-router/CHANGELOG.md +8 -0
  309. package/dist/skills/opengame-router/SKILL.md +14 -7
  310. package/dist/skills/opengame-scene-audit/CHANGELOG.md +15 -0
  311. package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
  312. package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
  313. package/dist/skills/opengame-sdk/CHANGELOG.md +12 -0
  314. package/dist/skills/opengame-sdk/SKILL.md +26 -9
  315. package/dist/skills/opengame-sdk/references/engines.md +2 -2
  316. package/dist/skills/opengame-sdk/references/identity.md +10 -11
  317. package/dist/skills/opengame-stability/CHANGELOG.md +4 -0
  318. package/dist/skills/opengame-stability/SKILL.md +59 -27
  319. package/dist/skills/opengame-trailer-make/CHANGELOG.md +5 -0
  320. package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
  321. package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
  322. package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
  323. package/dist/skills/opengame-trailer-make/references/core.md +129 -0
  324. package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
  325. package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
  326. package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
  327. package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
  328. package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
  329. package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
  330. package/dist/skills/opengame-trailer-make/references/music.md +148 -0
  331. package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
  332. package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
  333. package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
  334. package/dist/skills/opengame-trailer-make/references/review.md +141 -0
  335. package/dist/skills/opengame-trailer-make/references/title.md +92 -0
  336. package/dist/skills/opengame-trailer-plan/CHANGELOG.md +5 -0
  337. package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
  338. package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
  339. package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
  340. package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
  341. package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
  342. package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
  343. package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
  344. package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
  345. package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
  346. package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
  347. package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
  348. package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
  349. package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
  350. package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
  351. package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
  352. package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
  353. package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
  354. package/dist/skills/opengame-trailer-review-and-improve/CHANGELOG.md +5 -0
  355. package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
  356. package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  357. package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  358. package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
  359. package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
  360. package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  361. package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  362. package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  363. package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
  364. package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
  365. package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
  366. package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  367. package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
  368. package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  369. package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
  370. package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
  371. package/dist/skills/opengame-verification/CHANGELOG.md +11 -0
  372. package/dist/skills/opengame-verification/SKILL.md +113 -48
  373. package/dist/skills/opengame-weapons/CHANGELOG.md +11 -0
  374. package/dist/skills/opengame-weapons/SKILL.md +129 -55
  375. package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
  376. package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
  377. package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
  378. package/dist/skills/opengame-weapons/references/threejs.md +71 -0
  379. package/dist/skills/opengame-world-physics/CHANGELOG.md +9 -0
  380. package/dist/skills/opengame-world-physics/SKILL.md +55 -24
  381. package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
  382. package/package.json +1 -1
@@ -0,0 +1,78 @@
1
+ ---
2
+ name: opengame-maps
3
+ description: Design and prove a 3D browser game's maps. Covers a written spec with scale from two anchors, the world built and tested as numbers before art, parity as a list of what a player can do with a camera on each item, lanes, sightlines and perches as numbers, spawns in open supported space, spawn coverage and guidance lights. Use when the person says build a map, I spawned inside a rock, where do I go, the map plays wrong, or before an art pass.
4
+ metadata:
5
+ version: "1.0.0"
6
+ ---
7
+
8
+ # Maps
9
+
10
+ A map is a set of things a player can do in a place: lanes to look down, perches to
11
+ hold, doors to run through, a jump-up that shows both sides, a light to follow in the
12
+ dark. This skill writes those down as numbers before the art, builds and tests them as
13
+ data, and proves each one with a camera and a walk after every pass, so "it plays like
14
+ the reference" is a checked list rather than a feeling. In our games many of the map
15
+ complaints an owner repeated were about playing, not looking: invisible walls, spawns
16
+ inside rocks, doors too small to use, and nobody knowing where to go.
17
+
18
+ A reference here means the creator's own: an earlier level, a blockout, a written spec,
19
+ concept art, or a real place. Use somebody else's shipped game only to measure how a
20
+ kind of place plays (crossing times, sightline lengths, player counts). Build an original
21
+ layout, ship original names, and keep reference files out of the build.
22
+
23
+ Rules carry five tags; `opengame-quality-bar` explains them and the game codes. Collision
24
+ and the contract that art passes leave gameplay alone are in `opengame-world-physics`;
25
+ the geometry audit and the walk bot in `opengame-scene-audit`; the hero location and
26
+ dressing rules in `opengame-depth`; visual targets painted over the build's own frames in
27
+ `opengame-quality-bar`.
28
+
29
+ ## Rules
30
+
31
+ ### Write the map spec before the geometry
32
+ - **Invariant:** A map has a written spec before it has geometry: scale from two independent anchors, every dimension tagged fact, measured or estimate, a coordinate table that is the authority, the intended lanes, perches and spawns, and its sources cited. Concept art sets the look only.
33
+ - **Technique:** Use the template in [references/map-spec.md](references/map-spec.md). Decode any overhead of your own reference (a blockout, an earlier level, a site plan) to a pixel grid, anchor it with objects of known size, and cross-check with a second anchor and a timed crossing. Match crossing times rather than raw speeds: when the body changes, scale the layout, and give a mantle to any jump-up the new jump cannot reach. Check a lone judge's layout request against the spec before building it, and record the owner's per-spot rulings in the spec rather than generalising them.
34
+ - **Reference configuration:** OS: two anchors on one overhead agreed within 0.4% (0.19209 and 0.1928 m per pixel); another map was honest only to plus or minus 20%, and said so. OS scaled its layouts by 0.85 when its body was smaller than the one they were drawn for. A rectangle overlay passed a map twice while it was closed where its spec was open, sunken where it was raised and 4 to 6 m off. Concept art invented a creek, and one build carried an invented canopy with 14 invisible colliders; launchers added on one judge's request cut parity from 8.0 to 6.4 and from 7.8 to 5.3 ("original wins over a judge"). The owner asked for one wide door on one building while another map's list forbade merging openings; both went into their specs as rulings.
35
+ - **Applies when:** Every map built to a reference or a spec, and every map an owner has opinions about.
36
+ - **Verify:** A bot times three named routes within about 10% of the spec, and a top-down overlay at the same scale matches the spec's coordinate table.
37
+
38
+ ### Build and test the world as numbers before art
39
+ - **Invariant:** The layout, its solids, its walkable field and its routes exist as data that tests read before the engine boots, and the picture and the colliders are both built from that data.
40
+ - **Technique:** Keep the plan in one module: rooms, walls, doors with their states, floors, spawn points and objectives, as numbers. Test it headless in seconds: door heads and widths against the largest body, the navigation grid's cell size against the narrowest doorway, and the reachability of every objective and spawn in every door state. Then the builder registers solid, floor and roof as it draws.
41
+ - **Reference configuration:** LC tested plan, field, solid and flow before the engine booted; the tests caught a 1.9 m door head (now 2.05 m) and a 0.8 m navigation grid that missed doors (now 0.5 m, with AI doorways at least 1.3 m). 413 typed spawn points are reachable in all 387 door states, and 1,700 of 1,700 test walks arrive.
42
+ - **Applies when:** Every built or generated level, before art.
43
+ - **Verify:** The number tests run on every change to the plan, in seconds, and fail on a planted undersized door.
44
+
45
+ ### Parity is a written list of what a player can do, each proved by a camera
46
+ - **Invariant:** A map built to a reference or an owner's spec has every item of the target present, working and framed: openings per side, jump-ups, cover a player can peek over, door widths, stair routes, devices and their landings, and key sightlines.
47
+ - **Technique:** Write the checklist from the references before editing, as player verbs with coordinates and one staged camera per item (the eye on collision at standing height, rejected inside a solid). Pin each owner note to their screenshot and the area it shows, and ask for a screenshot when a note is vague. Run every device for real: log each launcher's landing against its marker, and drive a gate's look and its collision from one state. Something in the code that no camera shows is missing.
48
+ - **Reference configuration:** OS: "im not going to list out every piece thats what council of judges should be doing at that level of detail" (owner). Lists ran 16 to 36 items a map. 13 of one map's first 39 cameras sat in walls, roofs or on cliffs, and over 20 judge "gaps" were built items no camera showed. Lifts read as "a flat striped ramp", a teleporter never fired, and lava damage was dead code; landing error went from 0.02 to 1.72 m down to 0.00 m over 22 throws. One pass called a layout "already close" and only reskinned it; one courtyard first shipped as the wrong area.
49
+ - **Applies when:** Any map with a reference, an owner spec, or owner notes about a place.
50
+ - **Verify:** Every row has a frame path plus a walk or ride log, and blind judges mark each item present from its frame alone.
51
+
52
+ ### Lanes, sightlines and perches are numbers
53
+ - **Invariant:** Each lane has an intended count per side, a measured length and an open or broken state, each dominant perch has a counter, the player count fits the walkable floor, and all of it survives art passes and every quality tier.
54
+ - **Technique:** Write the intended topology, then cast the lanes as rays over the blockout at standing and raised eye heights. Never add cover to a dominant perch: add counter-perches and flanks, and deny unwanted perches with geometry such as steep roofs. Flood the terrain alone for navigation islands, and cap slopes rather than add ramps. Size the player count from walkable area per player instead of adding geometry. Check that no quality tier thins what hides a player.
55
+ - **Reference configuration:** OS: one map passed its validator (17 routes, 3,678 samples, 16 spawns) while the owner found "two alleyways" where the design had one lane per side; one arch per wall fixed it. Measured: a window seeing 26% of its map to 42.9 m; a roof-to-roof line 236 m clear, with the centre line broken by a 7 m rise so long duels are "earned". A creek bank steeper than 45 degrees split the navigation mesh; capping it at 32 took route failures from 38 to 0. At 32 players walkable area ran 70 to 280 m² each, so caps were 12 to 24 a map: "Do not add new geometry to 'fix' it." A low tier that thinned tree crowns let weak machines see through cover that hides players elsewhere.
56
+ - **Applies when:** Shooters, and any game where seeing first decides fights.
57
+ - **Verify:** Rerun the rays on built collision: lanes match within a metre, and the lines that must stay broken stay broken. One camera per tier over the same cover shows the same silhouette.
58
+
59
+ ### A spawn stands in open, supported space, with a way out and a view
60
+ - **Invariant:** No life starts inside or under geometry, in a closed volume, off the navigation mesh, facing a wall or in a live sightline, on any path that picks a spawn.
61
+ - **Technique:** Validate against the real colliders after everything has streamed in: a start-pose overlap test (a sweep misses a capsule that starts inside a one-sided mesh), support underfoot, closed containers counted as solids, and an escape test by reachable area rather than a short walk. Score sightlines as a risk with a deadline: relax distance, never line of sight, and count glass, foliage, rails and fog as see-through. Aim the first view down the longest open line. Route every spawn path (first life, respawn, teleports) through one helper, so no later adjuster can move a spawn the validator passed.
62
+ - **Reference configuration:** OS: "ur like spawned inside a mountain ... u need to always spawn in playable area" (owner), raised 8 times in its first five days. 35 of 54 spawns on one map sat inside stand-in boulders; the validator ran before streamed rocks arrived, and a runtime adjuster overrode it. A 14 m walk test passed three spawns inside a 42 m² room, so escape became 250 m² of reachable area or a 30 m walk. After: 32 of 32 lives see at least 8 m, and 29 of 30 lives moved within 0.5 s of held input (one earlier log showed 22 s frozen). LC: spawns at least 0.6 m clear and reachable in every door state; eight spawns inside the wire's collider stranded 20 of 75 points.
63
+ - **Applies when:** Any game where players or enemies spawn or respawn.
64
+ - **Verify:** Headless players drive the real controller from every spawn in eight directions, with and without jump, for a few seconds: none is stuck (OS ran 4 s each).
65
+
66
+ ### Spawn coverage is a test from every standpoint
67
+ - **Invariant:** Wherever the player stands, enemies can arrive from several sides at a useful range, in every state of the map's doors and gates.
68
+ - **Technique:** Sample standpoints on a grid over the walkable map. For each, find spawns reachable by the cheapest walk at a useful distance, and count the sides they cover, in every door state. Weight arrivals toward flanks and ahead, weight the empty side up, and replace stragglers left far behind. Fix a standpoint short of coverage with a spawn, never by steering the player.
69
+ - **Reference configuration:** LC: "zombies also always need to be spawning all around u wherever u go im near the cache and havent seen a zobie in like 1-2 minutes/..." (owner). Every 5 m standpoint needs a spawn 20 to 40 m off on at least 3 sides, in all 387 door states; standpoints short of three sides went from 9.7% to 0.8%. Spawns 16 to 36 m off, flanks and ahead weighted 3 to 1, the empty side 4 times. The flow field is 0.5 m cells on two levels, built in 3 ms slices.
70
+ - **Applies when:** Wave, horde and arena games with enemy spawns.
71
+ - **Verify:** The coverage test over the whole map, plus, per minute of recorded real runs, the sides enemies arrived from.
72
+
73
+ ### The way is lit, not marked
74
+ - **Invariant:** A new player can find the next place to go from anywhere on the map, by light the world itself carries, and hears the way in words when they are lost.
75
+ - **Technique:** Bake a chain of dim lights in the world (lamps, chemical lights, painted signs) along the walkable way on the AI's navigation grid, close enough that the next is always in view, with sight checked both ways along each link, brighter ahead than behind and leading toward the current objective only. Put a painted word near every fork. Beyond a short distance draw each light as a hard point whose level, not its size, carries it. Detect a lost player (no progress along the way for a while, or facing away) and say the way in one line. A pointer names the next place by walking distance, not a straight-line bearing.
76
+ - **Reference configuration:** LC: "also there should be some dim lights or indicators and/or arrows that tell u where to go and what to do otherwise its hard to know what to do in game too" and "dont make itm too easy but it should not be impossible either" (owner). 325 chemical lights every 5 m on open ground and every 3.4 m in trenches, at eye height on the wall facing the corner; blind links went from 62 to 0 and the longest gap is 6.9 m; a painted word within 4.5 m of all 49 forks; brightness ahead 1, 0.5, 0.34 and 0.24, passed lights 0.14; beyond 12 m a 2.5 px hard point. Lost means 30 s without getting nearer along the way, or 15 s facing away. The pointer reads "YARD GATE 40 M". On film with the lamp off, the next light was in view in 98.1% of samples.
77
+ - **Applies when:** Dark, large or maze-like maps, and any game where players say they do not know where to go.
78
+ - **Verify:** A lights-off walk from every standpoint shows a light ahead, and the link check reports no blind links.
@@ -0,0 +1,77 @@
1
+ # The map spec and the parity list
2
+
3
+ One file per map, written before the geometry and kept as the authority afterwards.
4
+ Where the spec and the built map disagree, one of them is wrong, and the spec says
5
+ which. This template is OS's, cleaned; LC kept the same facts in a plan module the
6
+ build reads.
7
+
8
+ ## Identity
9
+
10
+ Three to five facts that make the place itself, in words a stranger could check from
11
+ the map at minimap scale: "the silhouettes and colour blocks must survive at minimap
12
+ scale". A central structure, a colour, a landmark on the skyline, the one route
13
+ everyone remembers.
14
+
15
+ ## Footprint and scale
16
+
17
+ Example rows:
18
+
19
+ | Measure | Value | Confidence | Source |
20
+ | --- | --- | --- | --- |
21
+ | Metres per pixel of the overhead | 0.1921 | measured, two anchors within 0.4% | anchor A, anchor B |
22
+ | Crossing time, spawn A to spawn B, walking | 21 s | measured, timed crossing | recording |
23
+ | Height of the central platform | 3.2 m | estimate | concept frame 4 |
24
+
25
+ Every row is tagged fact (from data you control), measured (from the reference, with how)
26
+ or estimate (a judgement, with why). A map honest only to plus or minus 20% says so here.
27
+
28
+ Scale to the player's body by crossing time, not by raw size. If the game's body is
29
+ smaller than the reference's, scale the whole map down, and give a mantle to any jump-up
30
+ the new jump cannot reach.
31
+
32
+ ## Coordinates
33
+
34
+ A table of every named place with its coordinates: spawns, objectives, doors with their
35
+ widths and states, ladder tops, devices and their landings, perches. This table is the
36
+ authority; the geometry is built from it, and the parity list cites it.
37
+
38
+ ## Lanes, perches and sightlines
39
+
40
+ Example rows:
41
+
42
+ | Lane | Count per side | Length | State | Notes |
43
+ | --- | --- | --- | --- | --- |
44
+ | North street | 1 | 62 m | open | must stay one lane: no second alley |
45
+ | Centre line | 1 | 236 m | broken by a 7 m rise | keeps long duels earned |
46
+
47
+ For each dominant perch, name its counter-perch or flank. For each line that must stay
48
+ broken, say what breaks it.
49
+
50
+ ## Spawns
51
+
52
+ Each spawn with its coordinates, its first view direction (down the longest open line),
53
+ the reachable area behind it, and the sightlines it must not sit in.
54
+
55
+ ## Player count
56
+
57
+ Walkable area divided by the area each player needs. OS measured 70 to 280 m² per player
58
+ at 32 players and capped its maps at 12 to 24 from that, rather than adding geometry.
59
+
60
+ ## Owner rulings
61
+
62
+ Every ruling the owner made about this place, verbatim, with the date and the screenshot
63
+ it was about. A ruling about one building does not become a rule for every map.
64
+
65
+ ## The parity list
66
+
67
+ One row per thing a player can do, written before editing (example rows):
68
+
69
+ | Item | Verb | Where | Camera | Proof | Present |
70
+ | --- | --- | --- | --- | --- | --- |
71
+ | Jump-up on the loading dock | jump up, see into both yards | (12.0, 1.4, -3.5) | cam-07, eye on collision at 1.62 m | walk log 07 | yes |
72
+ | East door | sprint through standing | (30.2, 0, 8.0), 1.4 by 2.3 m | cam-11 | walk log 11, control wall still blocks | yes |
73
+ | Launcher | ride to the marked landing | marker (40, 6, -12) | cam-15 | 22 throws, landing error 0.00 m | yes |
74
+
75
+ A staged camera that lands inside a solid is rejected and placed again. An item that
76
+ exists in code but no camera shows is missing. Blind judges mark each item present from
77
+ its frame alone, without the spec.
@@ -1,5 +1,9 @@
1
1
  # opengame-mobile changelog
2
2
 
3
+ ## 1.1.0
4
+
5
+ The capability rule now covers missing WebGL 2 and touch-only phones opening a game without touch, so no visitor meets a blank page or a dead prompt (OH, OS, LC). CPU copies are freed only where nothing re-reads them (OS), and tier, memory and frame-rate rules gain OS's lessons on whole-tab memory, forced tiers that never reached the engine, and counting presented frames.
6
+
3
7
  ## 1.0.0
4
8
 
5
9
  First public release, in the opengamehq/opengame repository and the OpenGame CLI.
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: opengame-mobile
3
- description: Make a browser game run, sound and stay up on real phones. Covers tab memory measured on a real phone in Safari, freeing CPU copies after GPU upload, texture caps per device class, tier and pixel ratio before the first frame, touch input that keeps every release, audio unlock with a real check, phone frame rates, no blur over the canvas on iPhone, and WebGPU fallback. Use when the game crashes or reloads on a phone, is silent on iPhone, lags on mobile or has stuck touch controls.
3
+ description: Make a browser game run, sound and stay up on real phones. Covers tab memory measured on a real phone in Safari, freeing CPU copies only where nothing re-reads them, texture caps per device class, tier and pixel ratio before the first frame, touch input that keeps every release, audio unlock with a real check, phone frame rates, no blur over the canvas, and a card for a device the game cannot serve. Use when the game crashes, reloads or is silent on a phone, lags on mobile or has stuck touch.
4
4
  metadata:
5
- version: "1.0.0"
5
+ version: "1.1.0"
6
6
  ---
7
7
 
8
8
  # Mobile
@@ -22,16 +22,16 @@ size and caching are in `opengame-loading`; crash counting and recovery in
22
22
  ### Phone memory is measured on a real phone in real Safari
23
23
  - **Invariant:** The game's tab memory on the weakest target phone stays under a written budget through a full session, measured on the device in its own browser, and a build that has passed only emulation has not passed.
24
24
  - **Technique:** Connect the phone to a Mac and use Safari's Web Inspector (Timelines, with the Memory instrument) while playing title, menus, a full match and results twice in a row. Add Android Chrome through remote debugging. Treat "A problem repeatedly occurred" or a silent reload as a memory kill. Keep a per-subsystem memory table in the game itself (textures, geometry, audio, WebAssembly heap) so the number has owners. Avoid fixed large up-front memory reservations; let WebAssembly memory grow from a modest start.
25
- - **Reference configuration:** OC's owner set about 500 MB per tab; it was never met (the desktop tab sat at 3.5 GB, and an iPhone peaked at 3.9 GB). iPhones crash-looped from R165 to R195 after every emulated gate passed. Halving a fixed 4 GiB WebAssembly reservation changed nothing, because only about 0.8 GB of it was the game's own memory. Playwright's WebKit has no WebGPU, so OC had no local iOS reproduction, and fixes were blind until the owner tried his phone.
25
+ - **Reference configuration:** OC's owner set about 500 MB per tab; it was never met (the desktop tab sat at 3.5 GB, and an iPhone peaked at 3.9 GB). iPhones crash-looped from R165 to R195 after every emulated gate passed. Halving a fixed 4 GiB WebAssembly reservation changed nothing, because only about 0.8 GB of it was the game's own memory. Playwright's WebKit has no WebGPU, so OC had no local iOS reproduction, and fixes were blind until the owner tried their own phone. OS's wasm heap stayed flat while the tab's renderer process grew by 1,444 MB in 9.5 min, so count the whole tab, as `opengame-performance` says; a private window also keeps Cache Storage in memory, so OS capped its cache at 512 MB.
26
26
  - **Applies when:** Every game that claims to run on phones, most of all iPhones, where Safari kills tabs over memory with no warning.
27
27
  - **Verify:** On the real phone, two full sessions back to back: the tab stays up without a reload, and Web Inspector's peak stays under the budget. Record the phone model and OS version with the result.
28
28
 
29
29
  ### CPU-side copies are freed after GPU upload
30
- - **Invariant:** Once a texture or mesh is on the GPU, the decoded pixels and vertex arrays held for it in JavaScript or WebAssembly memory are released, and the source URL is kept so they can be fetched again after a context loss.
31
- - **Technique:** After upload, drop references to decoded image data and typed arrays the renderer no longer needs. Keep a table of URLs per asset so a restore can refetch. Three.js: load images with `ImageBitmapLoader`, and with `WebGLRenderer` close the bitmap in `texture.onUpdate` (`texture.image.close()`) once it is uploaded; for meshes you never raycast, morph or rebuild, free each attribute's array after upload with `attribute.onUpload(function () { this.array = null; })`. Test a resize and a forced context loss afterwards, since a texture that must be re-uploaded needs its source again.
32
- - **Reference configuration:** OC measured about 690 MB of duplicate texture memory, leaving the tab at 4.4 GB ("444 MB is duplicate copies of textures already on the graphics card"), and 180-270 MB on phones. Its runtime had no public way to drop the CPU bytes and keep the GPU texture; a patch of about 30 lines to release them saved about 450 MB.
30
+ - **Invariant:** Once a texture or mesh is on the GPU, the decoded pixels and vertex arrays held for it in JavaScript or WebAssembly memory are released unless something still reads them, and the source URL is kept so they can be fetched again after a context loss.
31
+ - **Technique:** Before releasing a copy, list every reader of it (decals and projected effects, picking and raycasts, CPU-side particles, a later re-upload) and keep the copies those need. After upload, drop references to decoded image data and typed arrays the renderer no longer needs. Keep a table of URLs per asset so a restore can refetch. Three.js: load images with `ImageBitmapLoader`, and with `WebGLRenderer` close the bitmap in `texture.onUpdate` (`texture.image.close()`) once it is uploaded; for meshes you never raycast, morph or rebuild, free each attribute's array after upload with `attribute.onUpload(function () { this.array = null; })`. Test a resize and a forced context loss afterwards, since a texture that must be re-uploaded needs its source again.
32
+ - **Reference configuration:** OC measured about 690 MB of duplicate texture memory, leaving the tab at 4.4 GB ("444 MB is duplicate copies of textures already on the graphics card"), and 180-270 MB on phones. Its runtime had no public way to drop the CPU bytes and keep the GPU texture; a patch of about 30 lines to release them saved about 450 MB. OS released its CPU texture copies the same way and its decals crashed "after about a minute" of play, because the decal system read them; that build was rolled back.
33
33
  - **Applies when:** Every textured game on phones; on desktop when tab memory matters.
34
- - **Verify:** Compare tab memory at the title with release on and off on the real phone. Then force a context loss (`WEBGL_lose_context.loseContext()` and `restoreContext()`): every texture draws again.
34
+ - **Verify:** Compare tab memory at the title with release on and off on the real phone, then play a few minutes with every effect that might read a released copy. Force a context loss (`WEBGL_lose_context.loseContext()` and `restoreContext()`): every texture draws again.
35
35
 
36
36
  ### Texture size and mips are capped per device class
37
37
  - **Invariant:** Each device class has an agreed maximum texture size and downloads only the mip levels it will draw, and any cut in phone fidelity is agreed with the owner before it ships.
@@ -42,10 +42,10 @@ size and caching are in `opengame-loading`; crash counting and recovery in
42
42
 
43
43
  ### Tier and pixel ratio are chosen before the first frame
44
44
  - **Invariant:** The quality tier, pixel ratio and worker count are set from a device check before the renderer draws anything, so a phone starts at phone settings from its first frame.
45
- - **Technique:** Classify the device from touch support, screen size, `navigator.hardwareConcurrency`, the GPU adapter and any stored result from an earlier visit, and default phones to the phone tier. Treat a GPU that reports no memory or a generic name as unknown and use the phone tier on a touch device. Set the pixel-ratio cap before the first `render`. Size worker pools from measured speed on the device, not from the reported core count. Three.js: `renderer.setPixelRatio(Math.min(devicePixelRatio, cap))` before the first frame, and `renderer.compileAsync` for the chosen tier only.
46
- - **Reference configuration:** OC's phones warmed up at the top tier at full Retina before its caps applied. Safari's GPU reported a generic vendor with 0 bytes and read as desktop, so phones got the top tier. Safari reported 2-4 cores, which would have started 16 threads, so OC fixed workers at 4; on desktop, 8-12 workers ran slower than 4. The pixel budget behind the cap is in `opengame-performance`.
45
+ - **Technique:** Classify the device from touch support, screen size, `navigator.hardwareConcurrency`, the GPU adapter and any stored result from an earlier visit, and default phones to the phone tier. Treat a GPU that reports no memory or a generic name as unknown and use the phone tier on a touch device. Set the pixel-ratio cap before the first `render`. Size worker pools from measured speed on the device, not from the reported core count. Log the tier, renderer and pixel ratio the game actually took, and quote that line in every measurement, because a forced weak tier can read the real machine without saying so. Three.js: `renderer.setPixelRatio(Math.min(devicePixelRatio, cap))` before the first frame, and `renderer.compileAsync` for the chosen tier only.
46
+ - **Reference configuration:** OC's phones warmed up at the top tier at full Retina before its caps applied. Safari's GPU reported a generic vendor with 0 bytes and read as desktop, so phones got the top tier. Safari reported 2-4 cores, which would have started 16 threads, so OC fixed workers at 4; on desktop, 8-12 workers ran slower than 4. OS's weak-tier runs used a page shim of `navigator.deviceMemory = 4` that never reached its engine's worker, and the weak-tier switch alone still picked the full renderer from the reported 32 GB, so two days of "weak" numbers ran on the full tier. The pixel budget behind the cap is in `opengame-performance`.
47
47
  - **Applies when:** Every game with tiers or a pixel-ratio cap that runs on phones.
48
- - **Verify:** On the real phone, log the tier and drawing-buffer size of the first frame: both are already the phone values.
48
+ - **Verify:** On the real phone, log the tier and drawing-buffer size of the first frame: both are already the phone values. Force the weak tier on a desktop: the game's own profile line names the weak renderer.
49
49
 
50
50
  ### Every touch release arrives, even when the system cancels it
51
51
  - **Invariant:** Every touch that starts has an end the game sees, including when the OS cancels it, the finger leaves the canvas or the tab loses focus, so no ghost finger owns the camera and no button stays held.
@@ -64,9 +64,9 @@ size and caching are in `opengame-loading`; crash counting and recovery in
64
64
  ### Phones have their own frame-rate floor, measured on the phone
65
65
  - **Invariant:** The phone has a written floor and target, measured on the phone in menus, loading and combat, and it holds a steady rate rather than bouncing between two.
66
66
  - **Technique:** Budget draw calls and per-enemy costs separately for phones, since phones are bound by draw calls and CPU sooner than by fill. If the phone cannot hold its target, cap at a lower rate it holds evenly. Measure on the device with an on-screen counter and Web Inspector, at the same tier players get. Target the phones most players own, not the oldest or smallest.
67
- - **Reference configuration:** OC's targets on phones: at least 30 fps, aim 60, with Safari capping animation frames at 60. The owner measured 15-20 fps on his iPhone ("i dont want to cur quality / fidelity") and OC ended at 10-20 fps at R195. Target devices: iPhone 11 and 12, SE 2 and 3, and mid-range Android ("dont overfit to iphone 5se").
67
+ - **Reference configuration:** OC's targets on phones: at least 30 fps, aim 60, with Safari capping animation frames at 60. The owner measured 15-20 fps on their own iPhone ("i dont want to cur quality / fidelity") and OC ended at 10-20 fps at R195. Target devices: iPhone 11 and 12, SE 2 and 3, and mid-range Android ("dont overfit to iphone 5se").
68
68
  - **Applies when:** Every game played on phones.
69
- - **Verify:** On the weakest target phone, record frame times through title, menus, a loading screen and a minute of the heaviest fight: the one-percent low holds the phone floor.
69
+ - **Verify:** On the weakest target phone, record frame times through title, menus, a loading screen and a minute of the heaviest fight, counting frames the game presented rather than animation callbacks (see `opengame-performance`): the one-percent low holds the phone floor.
70
70
 
71
71
  ### No backdrop blur over the canvas on iPhone
72
72
  - **Invariant:** On iPhone, menus and overlays over the game canvas use pre-blurred or darkened images rather than a live backdrop blur.
@@ -75,12 +75,12 @@ size and caching are in `opengame-loading`; crash counting and recovery in
75
75
  - **Applies when:** Every game with DOM menus or HUD panels over the canvas on iOS.
76
76
  - **Verify:** On the real phone, compare Web Inspector memory and frame time with the pause menu open and closed; the difference is small.
77
77
 
78
- ### Missing WebGPU gets a message or a fallback within a second
79
- - **Invariant:** Before the large download, the game checks whether this browser can run it, and a device without the needed API gets a fallback renderer or a card that names the reason and what to do.
80
- - **Technique:** Check `navigator.gpu`, then `requestAdapter()` (it can return null even when `navigator.gpu` exists) and the features and limits the game needs, then WebGL 2. Decide before fetching the world. If the game falls back, test the fallback path as a real build. Three.js: `WebGPURenderer` falls back to its WebGL 2 backend when WebGPU is missing (`forceWebGL: true` forces it for testing); check `renderer.backend.isWebGPUBackend` after `await renderer.init()`.
81
- - **Reference configuration:** OC's capability gate ran in 310-626 ms and named the reason and the fix. Its "No WebGPU" card showed on 60 of 60 boots in testing.
82
- - **Applies when:** Every game built for WebGPU, and every game needing WebGL 2 extensions.
83
- - **Verify:** Boot with WebGPU unavailable (remove `navigator.gpu` in an init script, or a browser without it): the card or the fallback appears in under 1 s, before any large request in the network log.
78
+ ### A device the game cannot serve gets a card or a fallback within a second
79
+ - **Invariant:** Before the large download, the game checks whether this device and browser can run it, and a browser without the needed graphics API, or a touch-only phone opening a game with no touch controls, gets a working fallback or a card that names the reason and what to do, never a blank page or a prompt it cannot answer.
80
+ - **Technique:** Check `navigator.gpu`, then `requestAdapter()` (it can return null even when `navigator.gpu` exists, and Chrome on Linux can expose `navigator.gpu` before an adapter is ready, so request the device yourself with a bounded number of retries inside a deadline, then fall back and record why), then the features and limits the game needs, then WebGL 2 with `getContext('webgl2')` inside a try. Treat the device as touch-only when `matchMedia('(pointer: coarse)')` matches and `(any-pointer: fine)` does not. Decide before fetching the world, and record which backend the game got. If the game falls back, boot the fallback as a real build in a gate (`opengame-stability`). Three.js: `WebGPURenderer` falls back to its WebGL 2 backend when WebGPU is missing (`forceWebGL: true` forces it for testing); check `renderer.backend.isWebGPUBackend` after `await renderer.init()`.
81
+ - **Reference configuration:** OC's capability gate ran in 310-626 ms and named the reason and the fix. Its "No WebGPU" card showed on 60 of 60 boots in testing. OH's launch QA found a phone sat for ever at PRESS ANY KEY and a browser without WebGL 2 showed a blank page; both now show a notice. OS ruled out touch by an owner decision and LC is desktop-only, so for them the card is the whole phone experience. LC's WebGL 2 fallback ran at 44-49 fps against 58-60 on WebGPU, and drew no scattered props for about 11 h before a gate booted it.
82
+ - **Applies when:** Every game built for WebGPU or needing WebGL 2, and every game without touch controls that a phone can open.
83
+ - **Verify:** Boot with WebGPU unavailable (remove `navigator.gpu` in an init script, or a browser without it), and again with WebGL 2 unavailable: the card or the fallback appears in under 1 s, before any large request in the network log. Open the URL on a real phone: a game without touch shows its card.
84
84
 
85
85
  ### Touch layout is thumb-sized, landscape and install-aware
86
86
  - **Invariant:** Every touch target is large enough for a thumb, the game plays in landscape with a clear prompt in portrait, and players are offered the installed web-app mode without being forced into it.
@@ -0,0 +1,5 @@
1
+ # opengame-montage-make changelog
2
+
3
+ ## 1.0.0
4
+
5
+ First public release: build a gameplay montage from its plan at any capture tier, with relay and bounded waits for the agent team, film-build hooks or replay passes, takes as code on the beat grid, payoff cinematics from the same run, offline take checks and a resumable cut chain that delivers read back. Built from the OG Snipers montage.
@@ -0,0 +1,187 @@
1
+ ---
2
+ name: opengame-montage-make
3
+ description: Build a gameplay montage from its plan, for any game, genre or engine, at any capture tier from a film build to live high-frame-rate capture. Covers the agent team with relays and bounded waits, film-build hooks or replay passes, takes as code with eased speed keys on the beat grid, payoff cinematics from the same run, offline take checks, and a resumable cut chain that delivers read back. Use when a montage plan is ready and it is time to capture and cut.
4
+ metadata:
5
+ version: "1.0.0"
6
+ ---
7
+
8
+ # Montage make
9
+
10
+ Step 2 of 3: `opengame-montage-plan`, then **make**, then `opengame-montage-review-and-improve` on every round.
11
+
12
+ You build the montage the plan describes. Every take should pass the hard gates before it is offered, and every cut should
13
+ reach the owner's folder without a slate, a placeholder or an unfixed note they were not told about. On the OG Snipers
14
+ sniper montage the rig and film build were up by hour 3, but capture took 42 % of about 302 agent-hours at about 50
15
+ sessions per shipped slot, and 10 h 38 min (16 % of the wall clock) passed with no agent logging: a 7 h 20 min
16
+ model-provider outage and a 3 h 18 min machine stall.
17
+
18
+ ## Read first
19
+
20
+ - `plan/PLAN.md`, the common brief and `work/OWNER-NOTES.md` in the film repo.
21
+ - [references/montage-grammar.md](references/montage-grammar.md) (the grammar), [references/montage-capture.md](references/montage-capture.md)
22
+ (tiers, hooks, shooting without source, take checks), [references/montage-genres.md](references/montage-genres.md)
23
+ (fake tells, probes and HUD per genre), [references/montage-ops.md](references/montage-ops.md) (team, relay, slots,
24
+ the cut chain, the time budget) and [references/montage-gates.md](references/montage-gates.md).
25
+ - [references/filmable.md](references/filmable.md) (the capability checklist, stepped capture, the per-engine table,
26
+ shot specs as code, the animation audit), [references/finishing.md](references/finishing.md) (conform, render, QA,
27
+ delivery) and [references/edge-cases.md](references/edge-cases.md) (closed builds, 2D, VR, no GPU). `opengame-capture`
28
+ has the in-game hook rules if you own the game.
29
+ - [references/song.md](references/song.md), [references/reference-study.md](references/reference-study.md) (the
30
+ finishing layer, the bot tells and the player model), [references/briefs.md](references/briefs.md) (common, shooter,
31
+ resume and sweep briefs), [references/owner-eye.md](references/owner-eye.md),
32
+ [references/measure.md](references/measure.md) (how to measure each check with ffmpeg and Python),
33
+ [references/day-one-questions.md](references/day-one-questions.md) (what the owner settled on day one) and
34
+ [references/og-snipers-record.md](references/og-snipers-record.md).
35
+ - Rename the shooter words for your genre: payoff (kill, goal, overtake, KO, clear), receiver (victim, overtaken car,
36
+ keeper, losing team, board), secondary sounds (reload, gear change, footwork).
37
+
38
+ ## 1. Team and ops (the first 30 minutes)
39
+
40
+ - **Roles:** a director; a film-build engineer and a rig engineer in parallel against one spec contract; shooters, one per
41
+ range of slots; edit; sound; post; ending; an independent sweep per cut. One owner per file set. The director makes no
42
+ captures once shooters exist. About 10 agents ran at once on OG Snipers.
43
+ - **Relay discipline.** After every owner message: rows in the notes ledger and `work/OWNER-NOTES.md`, then a relay
44
+ checklist of every role it touches, written to each `inbox/<role>.md` and the shared bus. Every agent reads its inbox
45
+ at the start of every task and before queuing any take; specs are read at session start so queued sessions pick up late
46
+ notes. (A title hand-in finished before the note that changed it reached that agent; shooters queued takes a newer note
47
+ had cancelled.) Watch shared files with `tail -n 0 -F`.
48
+ - **Handshakes** through `status/<role>.json` (author, cut id, commit, READY), never by grepping a shared log.
49
+ - **Bounded waits:** every wait ends on success, on a failure line, or after 15 minutes, then reads the real state.
50
+ **Liveness:** each heartbeat lists every agent's last activity; more than 30 minutes silent with no job of its own means
51
+ hung: restart it from its resume brief. A heartbeat skips if the last one has not finished; delete every schedule at
52
+ delivery. The director's own turn stays alive through long waits; a context restart resumes from the resume brief and
53
+ `plan/DECISIONS.md`.
54
+ - **Provider failover:** resume briefs on disk at all times; at the first wave of refusals, restart every agent on another
55
+ model provider within 15 minutes, among those the person's setup already has (never buy credit without asking).
56
+ - **The machine:** agree the share before production and verify it is live in the tool everyone calls. Use your machine's
57
+ job queue if it has one: a fixed slot count with timed raises that revert; takes ahead of other jobs ahead of proofs;
58
+ tickets older than 40 minutes jump ahead; one reserved slot for the director's finishing passes; withdraw only waiting
59
+ tickets, by verified process id. Pack takes into one session (OG Snipers booted in 130-180 s), sessions under 12
60
+ minutes. **Measure and report the queue's arrival and service rates** (OG Snipers: 14 takes an hour arriving, 8 served)
61
+ and cut work that fails preflight before it queues. Measure how many parallel captures your machine holds (OG Snipers:
62
+ three held, four lost takes to GPU device loss).
63
+ - **Disk:** build the delete keep-list from the select files at deletion time; caps per role; archive selects off the
64
+ capture machine.
65
+
66
+ ## 2. Build the set
67
+
68
+ ### The film build (tier A: one owner, a private worktree)
69
+
70
+ Fork the frozen source; every switch's default equals shipped, proved with a parity frame: a per-frame command bridge with
71
+ a far keepalive; a stepped clock with any step and a slow floor of 0.05x or lower; **a seed over every random generator**;
72
+ HUD per element and event filters (a hero-only feed, payoff badges on their own frame); a stage camera with a history cut
73
+ and attach spaces; every body drawn in sync each frame under slow motion; opponent or AI staging (place, act, path,
74
+ loadout, name, health or pace); the per-frame probe (player, camera, every actor, every payoff event with receiver and
75
+ cause, audio cues) **plus, on day one, the drawn points of whatever the engine animates worst (a skeleton, wheels, board
76
+ pieces, units), the payoff point, the line of the attack, ground height and a camera look-at** (they came on day 3 on OG
77
+ Snipes, after two guessed framings failed); an input assist inside the game's own rules (OG Snipers: an aim trim of at most
78
+ 0.35° before the game's hit test); reaction controls (ragdoll, crash, KO, a hitstop multiplier); a shutter in game time.
79
+ Put film switches on run-time structs (a field on a serialised struct broke two builds); staging acts on a change of value
80
+ (send a reset 6 frames before). A proof table per hook in the hooks file.
81
+
82
+ ### Without source (tiers B-E)
83
+
84
+ No film build: say what that removes and plan around it (the capture chapter). B: record a human's input live, re-run it
85
+ in tier A's rig, hash state per frame to prove the replay. C: play live, then shoot each moment in passes from the replay
86
+ (as played, outside, the receiver's side), rendering offline if the replay allows; check its slow motion on frames for
87
+ interpolation (use interpolated replays only to 0.5x); version-lock the build. D: the game's own cameras plus
88
+ high-frame-rate capture. E: lossless capture at the highest stable rate (the slow-motion budget is capture fps ÷ 60),
89
+ events mined from the feed or score pops, no second angle. The rest of this skill holds; staging and seeds become
90
+ selection from many real plays.
91
+
92
+ ### The rig
93
+
94
+ The stepped capture for the tier (the filmable chapter); seeded replay proved on day one; **one shared clock library with a
95
+ unit test against the engine's own time** (a clock-sum off-by-one between the payoff solver and the engine failed one take
96
+ three times); a human-input synthesiser inside the measured ranges of a good player of this genre (the reference-study
97
+ chapter); a payoff solver that lands payoffs only on grid frames; the speed logged on every frame; a renderer check that
98
+ refuses software rendering; take checks (frame count, duplicate signatures, clock skips, quality, every payoff the spec
99
+ asked for actually happened).
100
+
101
+ ### Audits and the pilot
102
+
103
+ Audit every reaction, hero move and opponent behaviour on frames before shooting on it; scout every map or level for
104
+ z-fighting and flicker at the planned lenses (change the framing or the place; a film-only backdrop fix did not cure one);
105
+ send the skin and loadout casting sheet; measure the genre's fake tells. Shoot the plan's **pilot clip** first and send it.
106
+
107
+ ## 3. Shoot
108
+
109
+ - **Specs as code** from `grid.json`: payoffs on grid frames at the beat − 3 frames; movement accents with measured leads;
110
+ speed keys eased per AE1-AE4; the frozen spec, seed and build saved with every select.
111
+ - **Preflight offline before a take takes a slot:** every way the scripted run can fail, checked without a GPU. On OG
112
+ Snipes each of these lost real takes: lines of fire, thin cover, shields, lobby bots, pace marks on another payoff's
113
+ line, clock sums. Racing: the line, AI pace, contacts. Fighting: inputs against frame data.
114
+ - **Clock-easing traps:** changing the clock moves where an action lands (an eased clock after a hop lost a kill); at 0.3x
115
+ one simulation frame spans 3.3 output frames, so a key may be unreachable; a payoff cinematic under 28 frames cannot fit
116
+ the V ramp. Check every take's speed log: fail a one-frame change over 15 % and a constant run of 20 frames or more after
117
+ a payoff.
118
+ - **The payoff cinematic comes from the same run:** the seeded take with a stage camera, the input replay, or the replay's
119
+ free camera on the same moment. Cut on the payoff + 1 frame, from the receiver's side, under the grammar chapter's rules.
120
+ **Solve the lens in two passes** when the framing must include X and exclude Y on every frame: pass 1 with any lens and
121
+ the probe logging; solve a per-frame lens with an 8 % margin; pass 2 plays the keys on the same seed, build and clock;
122
+ check pass 2's own logged points; if the receiver inverts, cut to close-ups or re-stage. OG Snipers verified 0 of 55, 52
123
+ and 42 frames with a leg point in frame.
124
+ - **The take check before offering** (about 20 s, no GPU): the grid, no dead time, only the high-skill form, opponents
125
+ moving, HUD and feed names right, cause before effect, the receiver matching, smoothness on every frame. Offer with three
126
+ full-size graded frames, an every-frame strip of every receiver and hero shot, and what is weak, in so many words.
127
+ - **Never cut a shot the owner liked:** fix it by re-staging, re-framing or a build request. Never delete a master a select
128
+ names.
129
+ - **The master format:** capture at it, or keep every select seeded and re-shoot it at the master size, verified (frame
130
+ count, speed curve, payoff frames, receivers, the camera within 0.15 m and 4 % field of view) before the master.
131
+
132
+ ## 4. Cut, mix, finish, deliver: one chain per cut
133
+
134
+ - **The edit list never retimes:** no speed, hold, blend, fade or blur keys. At tiers C-E the conform that lays
135
+ high-frame-rate footage at 60 fps is the one sanctioned rate change, declared per shot. A rolling working cut follows
136
+ select changes (at most once every 10 minutes under load) so a full-length cut always exists.
137
+ - **At the director's word the edit list freezes** and a resumable chain runs it, each stage idempotent and restartable
138
+ by name (one OG Snipers cut needed five resume scripts written by hand before the chain existed). Never edit a running
139
+ script: write a temporary file, then rename it.
140
+ 1. **Lint take-bound rows:** every repair, reframe, push and look exception names its take; stop with an error when its slot's
141
+ take changed, and re-bind in the same order that rules the new take in. (A z-fight repair stopped applying without any warning
142
+ for five cuts while the owner was told those cuts were checked; a title was graded twice.)
143
+ 2. Render; **scan for flicker only in the spans that changed,** verdict before strips, a cleared list by take.
144
+ 3. **One finishing pass** on the reserved slot, against the locked approved look; frames in equal frames out; the title
145
+ box against its approved comp.
146
+ 4. **Mix by signature:** the mix carries the edit list's signature and is muxed only on a match; reuse an existing mix
147
+ whose signature matches. Wait for the sound agent's READY at most 40 minutes, then hold and say so.
148
+ 5. Remux bit for bit; QA on the final file.
149
+ 6. **Deliver to the owner's folder and check it landed:** a plain temporary name (never a name starting with a dot),
150
+ rename, read it back and compare size and checksum, retry after 10 minutes, report "not delivered" until it is
151
+ there. The copy is a chain stage, not a habit: twelve OG Snipers cuts never reached the owner's folder.
152
+ 7. **The full gate report after delivery,** as a delta (new FAIL, fixed, standing); the hard gates and the flicker hold
153
+ already ran before the send. The independent sweep runs on the edit render while stages 3-5 run.
154
+ - **Sound** is one command inside every cut build: the song untouched, payoffs timed by their attack, levelled as heard to
155
+ one target, secondary sounds at least 6 dB under, full tails, measured again on the delivered file.
156
+
157
+ ## 5. Before anything is sent
158
+
159
+ - Watch the cut once at 1x, start to finish, and measure its sound (the OG Snipers director never watched; the owner always
160
+ did).
161
+ - The hard gates pass or are listed; every `OWNER-NOTES.md` row verified on frames of the delivered file, with NOT VERIFIED
162
+ rows at the top of the message; the sweep landed, or the cut goes out "sweep pending" with its A rows within the hour.
163
+ - No slates, no placeholders, no proxies. Then run `opengame-montage-review-and-improve`, and add a line to
164
+ `film/SKILLS.log`.
165
+
166
+ ## The traps that cost the most on OG Snipers
167
+
168
+ Faulted shots cut and filled with shots tied to nothing: about 12-14 hours. One model provider: 7 h 20 min dead. The
169
+ payoff framing decided on day 3: about 10-12 hours. The hero cast without asking: about 10 hours. The title and ending
170
+ without stills: 26 agent-hours and 23 hand-ins. An open wait on a dead job: 3.6 hours; an unnoticed idle agent: 4.4 hours.
171
+ Slot queues: a proof starved 2 h 20 min; a neighbour borrowed slots for 4 hours. A placeholder direction check: one round.
172
+ A voice line untested over the song: six episodes and three masters. A take-bound repair that stopped applying: five cuts
173
+ with a known z-fight. Waiting inside a cut: 45 minutes for the sound agent. Spacing copied from the reference: two re-shoot
174
+ rounds. Capture at 1080p for a 4K master: an upscale. Masters of 11 takes deleted while selects named them.
175
+
176
+ ## Don't
177
+
178
+ - Don't retime, hold, blend or fade in the edit; speed lives in the capture (or in the capture's own frame rate).
179
+ - Don't queue a take without reading your inbox and preflighting it offline.
180
+ - Don't wait without a timeout, or signal readiness through a shared log.
181
+ - Don't let a take-bound row survive a take swap unlinted.
182
+ - Don't mux a mix whose signature does not match the edit list.
183
+ - Don't run more than one finishing pass per cut, or grade an approved element twice.
184
+ - Don't claim a delivery you have not read back from the owner's folder.
185
+ - Don't hold a cut the owner is waiting for on the full gate report.
186
+ - Don't edit the game team's source; send fixes through the game-notes file.
187
+ - Don't spend on generated sound or voice without the person's go-ahead, on their own account.