create-threenative 0.2.6 → 0.2.7

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 (622) hide show
  1. package/README.md +2 -2
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +431 -20
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +555 -21
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +294 -55
  19. package/dist/threenative.js +714 -154
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rts/AGENTS.md +96 -0
  218. package/templates/rts/CLAUDE.md +98 -0
  219. package/templates/rts/kit.json +7 -0
  220. package/templates/{defense → rts}/package.json +13 -7
  221. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  222. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  223. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  224. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  225. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  226. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  227. package/templates/rts/playtests/survives.playtest.json +58 -0
  228. package/templates/rts/public/favicon.svg +4 -0
  229. package/templates/rts/src/game.ts +64 -0
  230. package/templates/rts/src/orders.ts +22 -0
  231. package/templates/rts/src/render/army.ts +346 -0
  232. package/templates/rts/src/render/camera.ts +123 -0
  233. package/templates/rts/src/render/lighting.ts +61 -0
  234. package/templates/rts/src/render/loading.ts +33 -0
  235. package/templates/rts/src/render/materials.ts +152 -0
  236. package/templates/rts/src/render/models.ts +705 -0
  237. package/templates/rts/src/render/palette.ts +17 -0
  238. package/templates/rts/src/render/picking.ts +93 -0
  239. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  240. package/templates/rts/src/render/quality.ts +128 -0
  241. package/templates/rts/src/render/resources.ts +141 -0
  242. package/templates/rts/src/render/sky.ts +44 -0
  243. package/templates/rts/src/render/terrain.ts +116 -0
  244. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  245. package/templates/rts/src/scenes/Play.ts +650 -0
  246. package/templates/rts/src/sim/ai.ts +1140 -0
  247. package/templates/rts/src/sim/combat.ts +416 -0
  248. package/templates/rts/src/sim/construction.ts +374 -0
  249. package/templates/rts/src/sim/economy.ts +167 -0
  250. package/templates/rts/src/sim/game.ts +1082 -0
  251. package/templates/rts/src/sim/movement.ts +371 -0
  252. package/templates/rts/src/sim/nav.ts +276 -0
  253. package/templates/rts/src/sim/production.ts +180 -0
  254. package/templates/rts/src/sim/terrain.ts +170 -0
  255. package/templates/rts/src/sim/types.ts +647 -0
  256. package/templates/rts/src/sim/vision.ts +46 -0
  257. package/templates/rts/src/state.ts +100 -0
  258. package/templates/{defense → rts}/src/style.css +21 -8
  259. package/templates/rts/src/ui/App.tsx +21 -0
  260. package/templates/rts/src/ui/Commands.tsx +129 -0
  261. package/templates/rts/src/ui/GameUi.tsx +22 -0
  262. package/templates/rts/src/ui/Hud.tsx +165 -0
  263. package/templates/rts/src/ui/Minimap.tsx +84 -0
  264. package/templates/rts/tailwind.config.ts +2 -0
  265. package/templates/rts/threenative.config.ts +56 -0
  266. package/templates/rts/tsconfig.json +17 -0
  267. package/templates/{defense → rts}/vite.config.ts +4 -1
  268. package/templates/runner/AGENTS.md +6 -10
  269. package/templates/runner/CLAUDE.md +6 -10
  270. package/templates/runner/README.md +3 -3
  271. package/templates/runner/package.json +13 -7
  272. package/templates/runner/playtests/performance.playtest.json +2 -2
  273. package/templates/runner/src/conventions.ts +4 -3
  274. package/templates/runner/src/entities/Runner.ts +54 -7
  275. package/templates/runner/src/game.ts +2 -0
  276. package/templates/runner/src/render/camera.ts +4 -2
  277. package/templates/runner/src/render/dust.ts +5 -2
  278. package/templates/runner/src/render/lighting.ts +41 -45
  279. package/templates/runner/src/render/loading.ts +2 -2
  280. package/templates/runner/src/render/materials.ts +165 -25
  281. package/templates/runner/src/render/palette.ts +17 -28
  282. package/templates/runner/src/render/postprocessing.ts +12 -2
  283. package/templates/runner/src/render/quality.ts +42 -96
  284. package/templates/runner/src/render/shapes.ts +59 -37
  285. package/templates/runner/src/render/sky.ts +32 -41
  286. package/templates/runner/src/render/touch-controls.ts +1 -1
  287. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  288. package/templates/runner/src/scenes/Run.ts +26 -6
  289. package/templates/runner/src/track.ts +6 -1
  290. package/templates/runner/threenative.config.ts +14 -1
  291. package/templates/runner/vite.config.ts +4 -1
  292. package/templates/sailing/AGENTS.md +12 -12
  293. package/templates/sailing/CLAUDE.md +12 -12
  294. package/templates/sailing/assets/ship.glb +0 -0
  295. package/templates/sailing/package.json +13 -7
  296. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  297. package/templates/sailing/playtests/sails.playtest.json +33 -0
  298. package/templates/sailing/playtests/win.playtest.json +156 -8
  299. package/templates/sailing/src/conventions.ts +29 -2
  300. package/templates/sailing/src/entities/Ship.ts +381 -57
  301. package/templates/sailing/src/game.ts +14 -0
  302. package/templates/sailing/src/render/camera.ts +63 -9
  303. package/templates/sailing/src/render/lighting.ts +49 -27
  304. package/templates/sailing/src/render/materials.ts +50 -15
  305. package/templates/sailing/src/render/ocean.ts +647 -60
  306. package/templates/sailing/src/render/palette.ts +16 -12
  307. package/templates/sailing/src/render/postprocessing.ts +12 -2
  308. package/templates/sailing/src/render/props.ts +316 -442
  309. package/templates/sailing/src/render/quality.ts +14 -4
  310. package/templates/sailing/src/render/sky.ts +116 -23
  311. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  312. package/templates/sailing/src/scenes/Boot.ts +21 -0
  313. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  314. package/templates/sailing/src/state.ts +6 -0
  315. package/templates/sailing/src/ui/Hud.tsx +41 -9
  316. package/templates/sailing/threenative.config.ts +14 -1
  317. package/templates/sailing/vite.config.ts +4 -1
  318. package/templates/shooter/AGENTS.md +27 -42
  319. package/templates/shooter/CLAUDE.md +27 -42
  320. package/templates/shooter/index.html +1 -0
  321. package/templates/shooter/package.json +13 -7
  322. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  323. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  324. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  325. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  326. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  327. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  328. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  329. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  330. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  331. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  332. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  333. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  334. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  335. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  336. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  337. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  338. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  339. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  340. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  341. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  342. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  343. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  344. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  345. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  346. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  347. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  348. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  349. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  350. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  351. package/templates/shooter/playtests/performance.playtest.json +62 -26
  352. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  353. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  354. package/templates/shooter/playtests/survives.playtest.json +36 -30
  355. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  356. package/templates/shooter/src/entities/Breakables.ts +412 -0
  357. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  358. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  359. package/templates/shooter/src/entities/Rifle.ts +442 -0
  360. package/templates/shooter/src/entities/Target.ts +199 -83
  361. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  362. package/templates/shooter/src/game.ts +75 -41
  363. package/templates/shooter/src/main.ts +0 -1
  364. package/templates/shooter/src/postPhysics.ts +36 -0
  365. package/templates/shooter/src/render/camera.ts +78 -74
  366. package/templates/shooter/src/render/decals.ts +142 -82
  367. package/templates/shooter/src/render/facade.ts +1373 -0
  368. package/templates/shooter/src/render/gunfx.ts +704 -0
  369. package/templates/shooter/src/render/lighting.ts +52 -38
  370. package/templates/shooter/src/render/loading.ts +2 -2
  371. package/templates/shooter/src/render/materials.ts +100 -88
  372. package/templates/shooter/src/render/occlusion.ts +108 -0
  373. package/templates/shooter/src/render/palette.ts +10 -10
  374. package/templates/shooter/src/render/palm.ts +455 -0
  375. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  376. package/templates/shooter/src/render/postprocessing.ts +15 -3
  377. package/templates/shooter/src/render/quality.ts +40 -82
  378. package/templates/shooter/src/render/scale.ts +148 -15
  379. package/templates/shooter/src/render/shapes.ts +138 -613
  380. package/templates/shooter/src/render/sky.ts +35 -35
  381. package/templates/shooter/src/render/town-schematic.ts +120 -0
  382. package/templates/shooter/src/render/town.ts +986 -0
  383. package/templates/shooter/src/render/townMaterials.ts +160 -0
  384. package/templates/shooter/src/render/vehicles.ts +741 -0
  385. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  386. package/templates/shooter/src/scenes/Play.ts +727 -650
  387. package/templates/shooter/src/state.ts +26 -41
  388. package/templates/shooter/src/style.css +207 -11
  389. package/templates/shooter/src/surfaces.ts +131 -0
  390. package/templates/shooter/src/ui/App.tsx +9 -10
  391. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  392. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  393. package/templates/shooter/src/ui/Hud.tsx +428 -39
  394. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  395. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  396. package/templates/shooter/src/ui/main.tsx +2 -3
  397. package/templates/shooter/threenative.config.ts +14 -1
  398. package/templates/shooter/vite.config.ts +4 -1
  399. package/templates/starter/AGENTS.md +17 -17
  400. package/templates/starter/CLAUDE.md +17 -17
  401. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  402. package/templates/starter/package.json +13 -7
  403. package/templates/starter/playtests/play.playtest.json +2 -1
  404. package/templates/starter/playtests/survives.playtest.json +1 -1
  405. package/templates/starter/src/conventions.ts +6 -3
  406. package/templates/starter/src/entities/Goal.ts +35 -42
  407. package/templates/starter/src/entities/Player.ts +99 -16
  408. package/templates/starter/src/render/arena.ts +131 -0
  409. package/templates/starter/src/render/lighting.ts +27 -44
  410. package/templates/starter/src/render/materials.ts +164 -35
  411. package/templates/starter/src/render/palette.ts +16 -16
  412. package/templates/starter/src/render/postprocessing.ts +6 -7
  413. package/templates/starter/src/render/quality.ts +43 -101
  414. package/templates/starter/src/render/shapes.ts +1 -1
  415. package/templates/starter/src/render/sky.ts +39 -45
  416. package/templates/starter/src/render/touch-controls.ts +3 -1
  417. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  418. package/templates/starter/src/scenes/Play.ts +82 -81
  419. package/templates/starter/threenative.config.ts +14 -1
  420. package/templates/starter/vite.config.ts +4 -1
  421. package/templates/tower-defense/.codex/config.toml +19 -0
  422. package/templates/tower-defense/.cursor/mcp.json +32 -0
  423. package/templates/tower-defense/.gemini/settings.json +32 -0
  424. package/templates/tower-defense/.mcp.json +32 -0
  425. package/templates/tower-defense/.vscode/mcp.json +36 -0
  426. package/templates/tower-defense/.zed/settings.json +36 -0
  427. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  428. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  429. package/templates/tower-defense/README.md +16 -0
  430. package/templates/tower-defense/index.html +12 -0
  431. package/templates/tower-defense/kit.json +7 -0
  432. package/templates/tower-defense/opencode.json +41 -0
  433. package/templates/tower-defense/package.json +56 -0
  434. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  435. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  436. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  437. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  438. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  439. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  440. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  441. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  442. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  443. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  444. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  445. package/templates/tower-defense/src/balance.ts +187 -0
  446. package/templates/tower-defense/src/board/Board.ts +100 -0
  447. package/templates/tower-defense/src/board/Route.ts +84 -0
  448. package/templates/tower-defense/src/camera-rig.ts +62 -0
  449. package/templates/tower-defense/src/economy.ts +64 -0
  450. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  451. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  452. package/templates/tower-defense/src/game.ts +72 -0
  453. package/templates/tower-defense/src/intents.ts +21 -0
  454. package/templates/tower-defense/src/main.ts +15 -0
  455. package/templates/tower-defense/src/physics.ts +6 -0
  456. package/templates/tower-defense/src/render/camera.ts +38 -0
  457. package/templates/tower-defense/src/render/lighting.ts +42 -0
  458. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  459. package/templates/tower-defense/src/render/materials.ts +103 -0
  460. package/templates/tower-defense/src/render/palette.ts +58 -0
  461. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  462. package/templates/tower-defense/src/render/quality.ts +128 -0
  463. package/templates/tower-defense/src/render/shapes.ts +550 -0
  464. package/templates/tower-defense/src/render/sky.ts +27 -0
  465. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  466. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  467. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  468. package/templates/tower-defense/src/state.ts +88 -0
  469. package/templates/tower-defense/src/style.css +137 -0
  470. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  471. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  472. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  473. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  474. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  475. package/templates/tower-defense/src/ui/main.tsx +14 -0
  476. package/templates/tower-defense/src/waves.ts +90 -0
  477. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  478. package/templates/tower-defense/vite.config.ts +41 -0
  479. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  480. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  481. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  482. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  483. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  484. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  485. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  486. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  487. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  488. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  489. package/agent-files/AGENT-ROLES.md +0 -26
  490. package/templates/action-rpg/src/render/shapes.ts +0 -269
  491. package/templates/action-rpg/src/render/types.ts +0 -3
  492. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  493. package/templates/defense/README.md +0 -10
  494. package/templates/defense/kit.json +0 -7
  495. package/templates/defense/playtests/leak.playtest.json +0 -23
  496. package/templates/defense/playtests/placement.playtest.json +0 -40
  497. package/templates/defense/playtests/scan.playtest.json +0 -20
  498. package/templates/defense/playtests/survive.playtest.json +0 -45
  499. package/templates/defense/playtests/survives.playtest.json +0 -36
  500. package/templates/defense/src/attackers/Attacker.ts +0 -120
  501. package/templates/defense/src/board/Route.ts +0 -94
  502. package/templates/defense/src/conventions.ts +0 -18
  503. package/templates/defense/src/economy.ts +0 -36
  504. package/templates/defense/src/entities/Player.ts +0 -52
  505. package/templates/defense/src/game.ts +0 -51
  506. package/templates/defense/src/physics.ts +0 -13
  507. package/templates/defense/src/placement/Buildable.ts +0 -49
  508. package/templates/defense/src/render/camera.ts +0 -16
  509. package/templates/defense/src/render/lighting.ts +0 -37
  510. package/templates/defense/src/render/materials.ts +0 -22
  511. package/templates/defense/src/render/palette.ts +0 -28
  512. package/templates/defense/src/render/quality.ts +0 -170
  513. package/templates/defense/src/render/shapes.ts +0 -246
  514. package/templates/defense/src/render/sky.ts +0 -45
  515. package/templates/defense/src/scenes/Boot.ts +0 -12
  516. package/templates/defense/src/scenes/Defense.ts +0 -231
  517. package/templates/defense/src/state.ts +0 -56
  518. package/templates/defense/src/towers/Tower.ts +0 -95
  519. package/templates/defense/src/towers/targeting.ts +0 -53
  520. package/templates/defense/src/ui/Hud.tsx +0 -62
  521. package/templates/defense/src/ui/Menu.tsx +0 -7
  522. package/templates/defense/src/waves.ts +0 -40
  523. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  524. package/templates/minimal/src/render/hud.ts +0 -69
  525. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  526. package/templates/platformer/playtests/chase.playtest.json +0 -21
  527. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  528. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  529. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  530. package/templates/platformer/playtests/physics.playtest.json +0 -14
  531. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  532. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  533. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  534. package/templates/platformer/src/conventions.ts +0 -18
  535. package/templates/platformer/src/entities/Character.ts +0 -286
  536. package/templates/platformer/src/entities/Chaser.ts +0 -118
  537. package/templates/platformer/src/entities/Patrol.ts +0 -93
  538. package/templates/platformer/src/level/Platform.ts +0 -46
  539. package/templates/platformer/src/render/rig.ts +0 -60
  540. package/templates/platformer/src/render/terrain.ts +0 -31
  541. package/templates/platformer/src/scenes/Level.ts +0 -241
  542. package/templates/puzzle/README.md +0 -43
  543. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  544. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  545. package/templates/puzzle/src/conventions.ts +0 -25
  546. package/templates/puzzle/src/entities/Ball.ts +0 -70
  547. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  548. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  549. package/templates/puzzle/src/physics.ts +0 -19
  550. package/templates/puzzle/src/room.ts +0 -83
  551. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  552. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  553. package/templates/shooter/playtests/combat.playtest.json +0 -48
  554. package/templates/shooter/playtests/fail.playtest.json +0 -31
  555. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  556. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  557. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  558. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  559. package/templates/shooter/src/combat/damage.ts +0 -40
  560. package/templates/shooter/src/conventions.ts +0 -51
  561. package/templates/shooter/src/entities/Pickup.ts +0 -70
  562. package/templates/shooter/src/entities/Player.ts +0 -310
  563. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  564. package/templates/shooter/src/playtest-events.ts +0 -15
  565. package/templates/shooter/src/render/touch-controls.ts +0 -305
  566. package/templates/shooter/src/render/types.ts +0 -3
  567. package/templates/shooter/src/render/ui.css +0 -330
  568. package/templates/shooter/src/render/ui.ts +0 -75
  569. package/templates/shooter/src/render/vfx.ts +0 -215
  570. package/templates/shooter/src/ui/Menu.tsx +0 -41
  571. package/templates/shooter/src/waves.ts +0 -50
  572. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  573. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  574. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  575. package/templates/starter/playtests/assets.playtest.json +0 -65
  576. package/templates/starter/playtests/buffer.playtest.json +0 -79
  577. package/templates/starter/playtests/cloth.playtest.json +0 -113
  578. package/templates/starter/playtests/coyote.playtest.json +0 -87
  579. package/templates/starter/playtests/gameover.playtest.json +0 -66
  580. package/templates/starter/playtests/goal.playtest.json +0 -67
  581. package/templates/starter/playtests/look.playtest.json +0 -175
  582. package/templates/starter/playtests/models-baseline.png +0 -0
  583. package/templates/starter/playtests/models.playtest.json +0 -74
  584. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  585. package/templates/starter/playtests/odometer.playtest.json +0 -54
  586. package/templates/starter/playtests/restart.playtest.json +0 -91
  587. package/templates/starter/playtests/seed.playtest.json +0 -54
  588. package/templates/starter/playtests/textures-baseline.png +0 -0
  589. package/templates/starter/playtests/textures.playtest.json +0 -74
  590. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  591. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  592. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  593. package/templates/starter/src/render/coast.ts +0 -199
  594. package/templates/starter/src/render/hero.ts +0 -88
  595. package/templates/starter/src/render/implicitSurface.ts +0 -199
  596. package/templates/starter/src/render/kuwahara.ts +0 -174
  597. package/templates/starter/src/render/outline.ts +0 -141
  598. package/templates/starter/src/render/painterly.ts +0 -86
  599. package/templates/starter/src/render/rockRidge.ts +0 -198
  600. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  601. package/templates/starter/src/render/scenery.ts +0 -40
  602. package/templates/starter/src/render/textureLifetime.ts +0 -53
  603. package/templates/starter/src/render/water.ts +0 -38
  604. package/templates/starter/src/render/watercolor.ts +0 -85
  605. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  606. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  607. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  608. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  609. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  610. /package/templates/{defense → rts}/.mcp.json +0 -0
  611. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  612. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  613. /package/templates/{defense → rts}/index.html +0 -0
  614. /package/templates/{defense → rts}/opencode.json +0 -0
  615. /package/templates/{defense → rts}/src/main.ts +0 -0
  616. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  617. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  618. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  619. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  620. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  621. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  622. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -1,59 +0,0 @@
1
- ---
2
- name: file-engine-bug
3
- description: File a confirmed @threenative/* engine bug on ThreeNativeHQ/threenative using the user's own gh CLI session. Use when doctor and a minimal repro separate an engine bug from a game or machine problem, and you have pasted output proving it.
4
- ---
5
-
6
- # Filing an engine bug
7
-
8
- A confirmed engine bug is filed upstream in the same turn you proved it — on the user's behalf,
9
- under the user's own `gh` session. Never create an account, never request a token, never open a
10
- browser flow: `gh` is already authenticated as the user, and that is the identity the report
11
- carries. Keep the report factual; it goes out in their name.
12
-
13
- ## 1. Confirm it is an engine bug
14
-
15
- `npx threenative doctor` and `npx @threenative/playtest doctor` separate project, machine, and
16
- engine failures. It is an engine bug when an `@threenative/*` API is broken, missing, or acts
17
- against its contract (capability detail or `AGENTS.md`), and a minimal repro shows it — not a
18
- fix that lives in this game's source, and not a machine problem doctor names.
19
-
20
- Implement the workaround first and continue the game (`AGENTS.md`: never stall on a framework
21
- bug). Filing does not wait for the workaround to be clean.
22
-
23
- ## 2. Search before filing
24
-
25
- ```sh
26
- gh issue list --repo ThreeNativeHQ/threenative --state open --search "<two or three keywords>"
27
- ```
28
-
29
- An open issue already covering it: add your repro and output as a comment
30
- (`gh issue comment <number> --body-file <file>`) instead of a new report.
31
-
32
- ## 3. File it
33
-
34
- Write the body to a file first; quoting goes through `--body-file`, never inline:
35
-
36
- ```sh
37
- gh issue create --repo ThreeNativeHQ/threenative \
38
- --title "<area>: <what is wrong, stated as behaviour>" \
39
- --body-file bug-report.md
40
- ```
41
-
42
- The body carries, in this order:
43
-
44
- - **Expected** — what the capability's contract says happens.
45
- - **Actual** — what happened, with the exact error id (`TN_*`) and the output you ran (doctor,
46
- playtest, perf) pasted, not summarised.
47
- - **Repro** — the smallest game code that shows it, and which template it reproduces in.
48
- - **Environment** — platform and target, browser and adapter for web, `@threenative/*` versions
49
- from the project's `package.json`.
50
- - **Workaround** — what the game shipped with to keep moving.
51
-
52
- ## 4. When not to file
53
-
54
- - `gh auth status` fails or `gh` is missing: do not authenticate for the user and do not stall —
55
- hand them the drafted title and body file and name the one command that files it.
56
- - The bug is real but you cannot prove it with pasted output yet: file nothing. Report it to the
57
- user as suspected, with the repro to run.
58
-
59
- The final summary to the user names the issue URL, or the reason no issue exists.
@@ -1,68 +0,0 @@
1
- ---
2
- name: ponytail
3
- description: >
4
- Force the laziest solution that actually works: smallest, shortest, most minimal.
5
- Use on any coding task in this game — writing, adding, refactoring, fixing,
6
- reviewing, or picking a dependency — and whenever a request smells over-built
7
- ("simplest", "minimal", "yagni", "do less", "shortest path", "too much code",
8
- "bloat", "boilerplate"). Adds YAGNI and reuse to the engine's capability-first
9
- rule: never hand-write what an installed @threenative system already does.
10
- Source: github.com/DietrichGebert/ponytail (MIT). Do NOT use for non-coding
11
- requests (general knowledge, prose, translation, summaries, recipes).
12
- argument-hint: "[off]"
13
- license: MIT
14
- ---
15
-
16
- # Ponytail — lazy senior dev
17
-
18
- You are a lazy senior developer. Lazy means efficient, not careless. The best code
19
- is the code never written. Active every response; this project's hook re-injects the
20
- ruleset every session and prompt, and `PONYTAIL=off` or "stop ponytail" turns it off.
21
-
22
- ## The ladder
23
-
24
- Stop at the first rung that holds. The ladder runs *after* you understand the
25
- problem, not instead of it: read the code the change touches and trace the real
26
- flow end to end, then climb. Two rungs work → take the higher one and move on.
27
-
28
- 1. **Does this need to exist at all?** Speculative need = skip it, say so in one line. (YAGNI)
29
- 2. **Already installed in the engine?** Search `engine_search_capabilities` for the full request and each concrete mechanic, inspect hits with `engine_capability_detail`, and reuse the returned system — a node, convention, helper or subpath that already ships is the answer, not a thing to re-implement. This rung *is* the critical capability gate; never skip it because the task looks small, and never jump to hand-written code while it is unsearched.
30
- 3. **Already in this game?** Reuse a helper, type, or pattern that already lives in `src/`. Re-implementing what sits a few files over is the most common slop.
31
- 4. **Stdlib or engine convention does it?** `loadAll`, `addInSlices`, `GroundSnap`, an input vector, a physics query — reach for those before writing your own loop.
32
- 5. **Already-installed dependency solves it?** Use it; never add a new one for what a few lines can do.
33
- 6. **Can it be one line?** One line.
34
- 7. **Only then:** the minimum code that works, in this game's `src/`.
35
-
36
- ## Rules
37
-
38
- - No unrequested abstractions: no interface with one implementation, no factory for one product, no config for a value that never changes.
39
- - No boilerplate, no scaffolding "for later"; later can scaffold for itself. Deletion over addition. Boring over clever.
40
- - Fewest files possible. Shortest working diff wins — but only once you understand the problem. The smallest change in the wrong place is a second bug.
41
- - Complex request? Ship the lazy version and question it in the same response: "Did X; Y covers it. Need full X? Say so." Never stall on a question you can default.
42
- - Two same-size options? Take the one correct on edge cases — lazy means less code, not the flimsier algorithm.
43
- - Bug fix = root cause, not symptom: grep every caller of the function you touch and fix the shared one. One guard where all callers route through is smaller than a guard per caller, and patching only the path the ticket names leaves a sibling caller broken.
44
- - Mark a deliberate corner cut with a `ponytail:` comment naming the ceiling and the upgrade path.
45
-
46
- ## Output
47
-
48
- Code first. Then at most three short lines: what was skipped, when to add it.
49
- Pattern: `[code] → skipped: [X], add when [Y].` No essays, no feature tours, no
50
- design notes. Explanation the user explicitly asked for (a plan, a report, per-phase
51
- notes) is not debt — give it in full.
52
-
53
- ## When NOT to be lazy
54
-
55
- Never simplify away: understanding the problem (a small diff you do not understand is
56
- just laziness dressed up as efficiency), input validation at trust boundaries, error
57
- handling that prevents data loss, security, accessibility, anything explicitly
58
- requested, and the calibration real hardware needs. Lazy code without its check is
59
- unfinished: non-trivial logic leaves ONE runnable check behind — the smallest thing
60
- that fails if the logic breaks. In this game the proof is a playtest scenario, never a
61
- new test framework; trivial one-liners need no test.
62
-
63
- ## Boundaries
64
-
65
- Ponytail governs what you build, not how you talk. "stop ponytail" / "normal mode" /
66
- `PONYTAIL=off`: revert. Level persists until changed or session end.
67
-
68
- The shortest path to done is the right path.
@@ -1,40 +0,0 @@
1
- ---
2
- name: prd-creator
3
- description: Turn a ThreeNative game idea or change into an approved game plan and implementation tasks before authoring code. Use after threenative-capabilities has recorded a capability or no-match for every mechanic, and before any game source is written.
4
- ---
5
-
6
- # ThreeNative game PRD
7
-
8
- Use this after `threenative-capabilities` has recorded a capability or no-match for the full request
9
- and every concrete mechanic. The outcome is a small, distinctive, playable plan grounded in the
10
- engine surface and explicitly approved by the user, not a generic genre template.
11
-
12
- ## Plan
13
-
14
- 1. Inspect the existing game, its instructions, and the capability discovery record. If discovery
15
- is missing or the requested mechanics changed, invoke `threenative-capabilities` before drafting.
16
- 2. Preserve the request's fantasy. Define the smallest playable loop that depends on its setting,
17
- traversal, combat, or simulation rather than reskinning a generic character game.
18
- 3. Specify controls, camera, core mechanics, win/loss states, game state, progression, visual and
19
- audio direction, asset needs and licences, target platforms, performance risks, and non-goals.
20
- 4. Define fail-closed playtest acceptance criteria for the loop, including observable state and a
21
- real capture for visible changes. Unexecuted platforms remain unverified.
22
- 5. Record prerequisites: required tools/MCPs, service access, test users, and environment variable
23
- names. Use placeholders only; never read or write real secrets into planning artifacts.
24
-
25
- Write the concise plan to `.agent/prd/PRD.md`, its short player-facing summary to
26
- `.agent/prd/SUMMARY.md`, and implementation tasks to `.agent/tasks.json`. Tasks must be ordered,
27
- bounded to about 10 minutes each, carry a concrete pass check, and start with `"passes": false`.
28
- The first task verifies prerequisites; later tasks include implementation, playtest proof, and
29
- visual inspection. Preserve the pre-planning capability decisions in the relevant task checks.
30
-
31
- ## Approval gate
32
-
33
- Present the plan and direct the user to approve it or request changes. Do not edit game source,
34
- download assets, authenticate services, or begin implementation while planning. Revise the plan
35
- when the user gives feedback.
36
-
37
- Start implementation only after explicit approval and a clear execution instruction such as
38
- "execute", "implement", "build it", or an equivalent phrase. One message may contain both. After
39
- that handoff, execute the approved tasks without silently expanding the scope; repeat capability
40
- discovery only when the requested mechanics or target platforms change.
@@ -1,53 +0,0 @@
1
- ---
2
- name: threenative-assets
3
- description: Find, import, license, or sculpt assets for a portable ThreeNative game. Use when the game needs textures, materials, HDRIs, sounds, or models, when importing an owned Fab or Unreal pack, or when sculpting bespoke geometry from a reference image.
4
- ---
5
-
6
- # ThreeNative assets and sculpting
7
-
8
- Use tools for conventional textures, materials, HDRIs, sounds, and models; write bespoke visuals
9
- in `src/render/`. Start the session from the game root so the project-scoped MCP config is read.
10
-
11
- 1. Run `asset_search_sources` to learn what is reachable, then search with
12
- `polyhaven_search_assets`, `ambientcg_search_assets`, or `audio_search_assets`.
13
- 2. List files with `polyhaven_list_files`/`ambientcg_list_files` before downloading; read the
14
- license and choose a sane resolution.
15
- 3. Download with `asset_download_file`/`audio_download_asset` and `acceptLicense: true`; tools
16
- write to the configured project directory.
17
- 4. Add file, source, license, and URL to `CREDITS.md`. Never state a license not returned by a tool.
18
-
19
- Many Fab listings are Unreal-only rather than ready-to-load GLBs. Search with `fab_search_assets`,
20
- check owned listings with `fab_list_owned`, then use `fab_import_asset` to download and convert an
21
- owned listing; use `asset_import_unreal` for an already-downloaded local pack. Both write textured
22
- `.glb` files under `assets/`. If they report `UNREAL_SOURCE_UNCOOKED`, stop: source editor assets
23
- need Unreal Editor export and cannot be recovered by retrying the converter.
24
-
25
- If FabCLI needs a session, proactively run `fabcli auth login`. Use Claude browser, or Codex's
26
- `chrome:control-chrome`, to complete the login with the user's active browser session, then retry
27
- the MCP call. Never read, copy, print, or persist browser cookies or tokens. The MCP checks
28
- entitlement and accepts only Fab Standard or CC-BY; it never claims or buys. Full arguments:
29
- `agent-docs/finding-assets.md`.
30
-
31
- For a bespoke animated creature, follow `agent-docs/creating-creatures.md`. Call the five
32
- `creature_*` tools through the project asset server, keep the editable spec and claims in
33
- `.threenative/creatures/`, compile into the configured `assets/` source, and get independent
34
- visual review before delivery. `creature_status` distinguishes compile-only availability from
35
- optional preview/check dependencies; an unavailable renderer is not approval.
36
-
37
- For a humanoid that needs a skeleton or more motion, follow `agent-docs/rigging-characters.md`.
38
- Inspect first with `asset_inspect_rig` (a local GLB or the pinned `aether-02` sample), auto-rig an
39
- unrigged biped with `asset_auto_rig` (or pass explicit landmarks when it returns a correction
40
- request), select donors with `asset_retarget_animations` (in-place by default; `root_motion` only
41
- from the matching `_RM` donor), and confirm the result with `asset_preview_animation` on a
42
- nonblank contact sheet before cooking. The 18-bone AETHER sample has no fingers or toes; the
43
- tools report those absent roles instead of inventing them.
44
-
45
- Choose the sculpt branch before coding: conventional → asset tools; trivial → portable geometry;
46
- bespoke with a reference → `sculpt_plan`, `sculpt_spec_gate` until every region passes, one
47
- factory per pass in `src/render/`, then `sculpt_compare` and `sculpt_pass_gate` against a real
48
- capture; bespoke without a reference → read `agent-docs/dream-loop.md` and acquire a
49
- user-supplied or explicitly authorized target before sculpting. Use `node scripts/reference.mjs`
50
- only when the user selected its provider/model; never invent a reference or hide a missing key.
51
- `sculpt_grimoire` supplies techniques. `threenative-sculpt-mcp` guides source and never launches
52
- a browser. A missing/blank capture fails; credit the reference before the turn ends. See
53
- `agent-docs/sculpt-from-a-reference.md`.
@@ -1,27 +0,0 @@
1
- ---
2
- name: threenative-capabilities
3
- description: Discover and use the ThreeNative capability surface before writing a game system. Use before prd-creator drafts a plan, and before building or replacing any world, traversal, interaction, simulation, combat, camera, audio, UI, entity, movement, navigation, attachment, particle, terrain, or measurement system.
4
- ---
5
-
6
- # ThreeNative capabilities
7
-
8
- This is a critical planning prerequisite. Use it before `prd-creator` drafts a plan, and before
9
- replacing any world, traversal, interaction, simulation, combat, camera, audio, UI, entity,
10
- movement, navigation, attachment, particle, terrain, or measurement system.
11
-
12
- 1. Infer the concrete mechanics from the request. Preserve its distinctive fantasy with the
13
- smallest characteristic loop; ask one short question only when two core loops remain equally
14
- plausible.
15
- 2. Search the full request with `engine_search_capabilities` using `scope: "request"`, then search
16
- every mechanic with `scope: "mechanic"`. Check each returned `matchedSituation`.
17
- 3. Record a capability or no-match for every mechanic before writing a replacement. Describe
18
- situations plainly, such as *"enemy walks around a wall"*.
19
- 4. Hand the recorded matches, inspected constraints, and no-matches to `prd-creator`; the PRD must
20
- plan against this actual engine surface.
21
-
22
- The manifest is the complete public surface; grep misses subpath exports such as
23
- `@threenative/physics/navigation`. If MCP is unavailable after `npx threenative doctor`, use
24
- `agent-docs/capability-reference.md` and repeat the full-request plus per-mechanic pass manually.
25
- Returned constraints are binding: import navigation from its returned subpath, use `attachToBone`
26
- for held weapons (add a portable `Bone` named `RightHand` when needed), and never invent platform
27
- support. One game rewrote 446 installed lines and ran at 9 FPS; discovery prevents that.
@@ -1,65 +0,0 @@
1
- ---
2
- name: threenative-context
3
- description: Use the portable ThreeNative ctx lifecycle, scheduling, randomness, pointer, and raycast APIs. Use when writing scene changes, timers, tweens, randomness, pointer or drag handling, raycasts, or startup gating rather than hand-rolling them, and when `pnpm budgets` rejects a raw construct.
4
- ---
5
-
6
- # ThreeNative context surface
7
-
8
- These are properties on `ctx`, never imports; use them before writing equivalent game plumbing.
9
- The recipes are in `agent-docs/ctx-cookbook.md` and imports still require
10
- `engine_search_capabilities`.
11
-
12
- | Use | Instead of | Contract |
13
- |---|---|---|
14
- | `ctx.goto("<scene-name>")` | hand reset | async scene rebuild |
15
- | `ctx.tween(...)` | `Math.sin`/`lerp` accumulator | timed interpolation with optional `ease` |
16
- | `ctx.after(...)` / `ctx.every(...)` | timer branches in `update` | disposable schedules |
17
- | `ctx.beforeRender(fn)` | per-frame packing in `update` or an object `onBeforeRender` hook | one dispatch per actual world draw, after the last fixed step and before the projection; cleared like `ctx.afterPhysics` |
18
- | `ctx.random.range(-1, 1)` | `Math.random()` | reproducible when `seed` is configured |
19
- | `ctx.pointer.on(...)` / `ctx.pointer.drag(...)` | hover/press/drag bookkeeping | web/native pointer-id stream |
20
- | `ctx.raycast()` / `ctx.raycastAll()` | `new Raycaster()` | backend-neutral intersections |
21
- | `ctx.startup.hold(label, work)` | a loading screen that waits past `whenReady()` | the game's own launch work joins the readiness gate |
22
-
23
- `ctx.pointer` dispatches entered, exited, pressed, released, tapped, drag-started, dragged, and
24
- drag-ended events. Register a mesh/model root; only registered objects are raycast and events bubble
25
- through parents.
26
-
27
- `ctx.goto(name)` rebuilds the scene without resetting state; values in `ctx.state` survive. From a
28
- frame function, `goto` and then `return` immediately because the old scene is torn down. For a full
29
- restart, `game.goto("<scene-name>")` from React resets declared initial state first. A state reset
30
- uses `ctx.state.set({ /* copy this game's initial-state shape */ })` before the goto. `ctx.random` is
31
- deterministic only when `defineGame({ seed })` is configured.
32
-
33
- `ctx.beforeRender(fn)` runs once per actual world draw, after the frame's last fixed update and
34
- before the projection reconciles, so `fn` reads the frame's final state; a held, loader-only frame
35
- draws no world and dispatches nothing. It is cleared on scene change and stop, like
36
- `ctx.afterPhysics`. Reach for it when the draw itself consumes per-frame CPU work — packing an
37
- instanced batch, rebuilding a buffer — instead of an object `onBeforeRender` hook, which makes the
38
- render projection decline the whole frame.
39
-
40
- `pnpm budgets` rejects superseded raw constructs such as `new Audio(`, `Math.random(`,
41
- `new Raycaster(`, `.visible = false`, and `new Box3().setFromObject(`; use the named capability or
42
- annotate a genuinely necessary line with a non-empty `// engine-override: reason`.
43
-
44
- <!-- generated: superseded-constructs -->
45
-
46
- **Reinvention fails CI.** `pnpm budgets` scans this project's `src/` for these raw
47
- constructs and fails, naming the capability instead. The list and the gate are generated
48
- from the capabilities' own doc tags, so they cannot disagree:
49
-
50
- | Rather than write | Use instead | Import from |
51
- |---|---|---|
52
- | `new Audio(` | `AudioBus` | `@threenative/core` |
53
- | `Math.random(` | `createRandom` | `@threenative/core` |
54
- | `new Box3().setFromObject(` | `normaliseToMetres` | `@threenative/core` |
55
- | `.visible = false` | `prewarm` | `@threenative/core` |
56
- | `new Raycaster(` | `ScenePicker` | `@threenative/core` |
57
-
58
- When the raw construct is genuinely right, annotate that exact line with a non-empty
59
- reason — a bare `// engine-override:` still fails:
60
-
61
- ```ts
62
- const bounds = new Box3().setFromObject(viewmodel); // engine-override: measuring, not scaling
63
- ```
64
-
65
- <!-- /generated -->
@@ -1,58 +0,0 @@
1
- ---
2
- name: threenative-performance
3
- description: Measure ThreeNative frame budgets and report platform evidence without guessing. Use when a frame budget, FPS floor, or platform performance claim is in question, when reading `TN_FRAME_BUDGET`, or when writing a bounded performance assertion.
4
- ---
5
-
6
- # ThreeNative performance evidence
7
-
8
- Pool objects; load static GLBs through `ctx.assets.model()`; never claim Android/iOS from a
9
- desktop proof. `TN_FRAME_BUDGET` reports `fps`, `hostGap`, `update`, `render`, `overlay`,
10
- `residual` and per-pass draws and triangles. `defineGame({ frameBudget: false })` silences
11
- output, never measurement.
12
-
13
- ## When the scene is the problem
14
-
15
- `TN_SCENE_WARNING` fires when the GPU used under a third of a frame whose render phase overran
16
- the display period: move draws and objects, not settings. `npx threenative doctor` and
17
- `DEV_MODE=true` repeat it; `TN_FRAME_SPANS=1` splits that phase.
18
- The largest static win is free — three skips per-object binding updates when nothing changed, so
19
- not writing a transform saved 7.35 ms on 1,561 objects where `markStatic(root)` saved 0.009 ms.
20
-
21
- ## Use the shipped defaults
22
-
23
- The engine prepares transforms, batches, culls, scales resolution and cooks assets;
24
- read `agent-docs/performance-basics.md` before hand-rolling any.
25
- Unexecuted platforms stay unverified; never invent numbers.
26
- Withdraw thermally-confounded Tiers 1–3 comparisons; always report Tier 4. Bounded proof:
27
- `{"performance":{"maxFrameMsP95":33,"minFps":30,"maxPhaseMsP95":{"render":12},"maxPassDrawCalls":{"shadow":400}}}`,
28
- defined in `agent-docs/assertion-reference.md#performance`; pass bounds fail closed without a
29
- per-pass split.
30
-
31
- |Tier|Measure|Floor|Target|
32
- |---|---|---:|---:|
33
- |1|Starter/browser-desktop|60fps|display-refresh|
34
- |1|Starter/browser-Android|30fps|58fps|
35
- |1|Starter/native-desktop|60fps|display-refresh|
36
- |1|Starter/native-Android|55fps|58fps|
37
- |1|Starter/native-iOS|unverified|no-number|
38
- |1|All-platform/hostGap-p95|—|≤4ms|
39
- |1|All-platform/update-p95|—|≤2ms|
40
- |1|All-platform/residual-p95|—|≤0.5ms|
41
- |1|All-platform/overlay-p95|—|≤1ms|
42
- |2|Same-device-fps-parity|.85|.95|
43
- |2|Inverted-render-p95-parity|.80|.95|
44
- |3|Light|55fps|58fps|
45
- |3|Medium|30fps|58fps|
46
- |3|Heavy|30fps|58fps|
47
- |4|Sustained-duration|10min|10min|
48
- |4|Final/opening-fps|.75|.90|
49
- |4|Last-minute-heavy|25fps|50fps|
50
- |4|Peak-battery-temperature|≤45C|≤40C|
51
- |4|Thermal-status|≤2|≤1|
52
- |4|Whole-device-current|—|report;not-gated|
53
-
54
- Android: budget a ~500 MiB driver floor before textures; a dual-use equirectangular
55
- environment adds ~48 MiB: `agent-docs/mobile-memory-budget.md`.
56
-
57
- Name the hot function: `--cpu-prof <file>` (native, or a browser/desktop playtest) writes a
58
- DevTools `.cpuprofile`.
@@ -1,44 +0,0 @@
1
- ---
2
- name: threenative-playtest
3
- description: Diagnose a ThreeNative game, prove behavior, and keep playtests fail-closed. Use for a blank, black, or washed-out frame, a browser, device, or import failure, or when writing or repairing a playtest scenario and its assertions.
4
- ---
5
-
6
- # ThreeNative diagnosis and playtests
7
-
8
- For browser, blank-frame, device, or import failures, run `npx threenative doctor` and
9
- `npx @threenative/playtest doctor` first. For a running game, use:
10
-
11
- ```sh
12
- npx @threenative/playtest doctor --url http://127.0.0.1:5173 --text
13
- npx @threenative/playtest playtests/<name>.playtest.json --browser-recipe webgpu --headed
14
- ```
15
-
16
- Read visibility, scale, draw cost, frame rate, advancing state, and errors. Missing output means
17
- unobserved, never zero.
18
-
19
- **Read the room before you reach for a screenshot.** `doctor --url` also reports three lines named
20
- lighting, materials and camera — how many lights the renderer can see, what materials are mounted,
21
- the background, the fog, and the camera's position and clip planes — and it names the three ways a
22
- frame dies while every other number looks healthy: lit materials with no visible light, a fog far
23
- plane in front of the scene it fogs, and a camera far plane that clips it. A black or washed-out
24
- frame is a question those lines answer and a screenshot cannot.
25
-
26
- Bound the same things in a scenario so the check outlives the session:
27
- `assert.scene` takes `minVisibleLights`, `litMaterialsAreLit`, `fogClearsScene` and
28
- `cameraClearsScene`; `assert.animation[]` takes `maxFootSlide` and `strideSynced`, which catch a
29
- character skating across the floor when the clip and the ground disagree. Both fail closed — a
30
- bridge that reports no scene has not reported a well-lit one. For a relative-placement question, publish a scene probe with derived
31
- `checks`, drive it with Playwright, sweep candidates in one run, and turn the winning check into a
32
- playtest assertion.
33
-
34
- When an `@threenative/*` API is broken, missing, or does not do what you need, replace only that
35
- piece with portable Three.js/plain code. Keep the loop, scenes, input, entity registry, and bridge;
36
- avoid `document`, `window`, `localStorage`, dynamic `import()`, and raw physics handles. **Report
37
- what blocked you**: API, expectation, result, and replacement. Never stall on a framework bug.
38
-
39
- Playtests fail closed: a missing entity, absent observation, or empty assertion set fails. Every
40
- `allowTrivial` waiver needs a 20-character reason; `true` alone is invalid, and all-waived
41
- triviality fails `TN_PLAYTEST_SCENARIO_ASSERTS_NOTHING`. Use `holdTicks`/`waitTicks` for fixed-step
42
- time (`holdFrames`/`waitFrames` are compatibility aliases); `warmupFrames` means RAF warmup.
43
- Read `agent-docs/assertion-reference.md` for assertion fields and `agent-docs/debug-surface.md`
44
- for bridge globals. The JSON-safe bridge resource is `state`; `GameState` is a deprecated alias.
@@ -1,20 +0,0 @@
1
- ---
2
- name: threenative-ui
3
- description: Build a native-safe ThreeNative React UI that communicates through state and intents. Use when adding or changing a HUD, menu, or any React UI that must also run on native, where the layout key set is fixed and CSS does not exist.
4
- ---
5
-
6
- # ThreeNative UI
7
-
8
- Use `View` and `Text` from `@threenative/core/react` for native UI; `react-dom` is web-only.
9
- Native layout is pixel-based and absolute unless `direction` is `row` or `column`. Supported keys
10
- are `left`, `right`, `top`, `bottom`, `centerX`, `centerY`, `width`, `height`, `padding`,
11
- `direction`, `gap`, `align`, `background`, `color`, `opacity`, `fontSize`, `letterSpacing`,
12
- `textAlign`, and `zIndex`; CSS, Tailwind, flex grow/wrap, borders, radius, transforms, images, SVG,
13
- and events do not exist in the native renderer.
14
-
15
- On native, game and UI are separate processes. The UI reads published JSON-safe state and sends
16
- intents; `src/game.ts` decides their meaning. `useUiState<GameState>()` is undefined until the first
17
- snapshot, and `useUiIntent()` sends commands. Mark every touch target `data-tn-interactive`; the
18
- host routes marked pointer-down events to UI and unmarked touches to the game. Share state and
19
- components, but keep appearance in `src/ui/`. The full state, hit-region, and renderer contract is
20
- `agent-docs/webview-ui.md`.
@@ -1,41 +0,0 @@
1
- ---
2
- name: threenative-visuals
3
- description: Capture, inspect, and budget the player-visible look of a ThreeNative game. Use when a player-visible feature needs a real capture before it is called done, when matching a reference image, or when tuning lighting, probe volumes, or resolution scale.
4
- ---
5
-
6
- # Budget real time for the look
7
-
8
- `typecheck`, `lint`, tests, and playtests can all pass on grey boxes and a black screen. A
9
- player-visible feature is done only after opening a real capture and checking silhouettes, depth,
10
- contact shadows, rim light, motion, and the HUD. Spend roughly as much effort on presentation as
11
- mechanics.
12
-
13
- Use browser automation on the user's real Chrome when available; otherwise run
14
- `npx @threenative/playtest <scenario> --browser-recipe webgpu --headed`. The recipe includes
15
- `--enable-features=Vulkan`; without it Chromium may use SwiftShader and the runner reports
16
- `TN_PLAYTEST_SOFTWARE_ADAPTER`. **Do not use `xvfb-run`**: its cleanup can replace the real exit
17
- status. A black headless capture is a capture failure until proven otherwise.
18
-
19
- For reference matching, solve lighting first: search `engine_search_capabilities` before adding
20
- effects, read `TN_RENDER_CHAIN`, and use `agent-docs/visual-baseline.md` and
21
- `agent-docs/capture-the-frame.md` for the per-file baseline and capture recipe.
22
-
23
- For a supplied or explicitly generated target, read `agent-docs/dream-loop.md`. It is the shared
24
- workflow for locking the target, preserving its hash, obtaining a fresh gameplay capture, and
25
- asking the read-only verifier for an independent `PASS`, `REQUEST_CHANGES`, or `NOT_OBSERVED`.
26
- Run `node scripts/visual-loop.mjs --record <run>/run.json` before and after each round; read its
27
- JSON `decision` instead of treating exit 0 as acceptance. If a target must be generated or edited,
28
- use `node scripts/reference.mjs` with a unique `--request-id`, the exact prompt file, and the
29
- user-selected model. A supplied target works without credentials; missing evidence or a provider
30
- failure remains unavailable and never becomes a visual pass.
31
-
32
- For off-screen diffuse light, add `ProbeVolume` after static geometry/lights, bake on demand, and
33
- sample it into a game-owned material before screen-space GI. It owns no look; moving lights need a
34
- new bake. Keep `TN_PROBE_VOLUME`'s stale state, probe count, atlas bytes, progress, and bake cost
35
- visible while tuning bounds, density, and `bakeBudgetMs`.
36
-
37
- `renderer.resolutionScale: "auto"` scales only the 3D drawing buffer to hold `display.maxFps`;
38
- never hand-author a device constant. A `(0, 1]` value pins it; invalid values fail at config load.
39
- Both modes report `TN_FRAME_BUDGET.surface` (`resolutionScale`, `scaleSource`, sample count, and
40
- buffer size), and `display: config.display` must reach `defineGame`. See the pixel-budget details
41
- in `agent-docs/visual-baseline.md` and the engine's measurement skill.
@@ -1,26 +0,0 @@
1
- # ThreeNative agent roles
2
-
3
- `__PROJECT_NAME__` includes two optional, user-owned roles. They are plain files: use them when
4
- they help, edit them when your workflow needs something different, or delete them. There is no
5
- automatic builder-to-verifier chain and no provider is selected for you.
6
-
7
- | Role | Canonical contract | Claude Code adapter | Codex skill |
8
- | --- | --- | --- | --- |
9
- | Builder | `.threenative/agents/builder.md` | `.claude/agents/threenative-builder.md` | `.agents/skills/threenative-builder/SKILL.md` |
10
- | Verifier | `.threenative/agents/verifier.md` | `.claude/agents/threenative-verifier.md` | `.agents/skills/threenative-verifier/SKILL.md` |
11
-
12
- Run commands from the project root. Claude Code selects its adapter explicitly:
13
-
14
- ```sh
15
- claude --agent threenative-builder "Implement one bounded player-visible change and report evidence."
16
- ```
17
-
18
- Codex discovers repository skills under `.agents/skills`; name it in the request:
19
-
20
- ```sh
21
- codex exec "Use the threenative-builder skill for one bounded player-visible change and report evidence."
22
- ```
23
-
24
- Use the matching verifier role after a builder result when an independent check is useful. Both
25
- providers read the same canonical contract, so framework instructions stay in `AGENTS.md` and
26
- role instructions stay in `.threenative/agents/`.