[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B2ZGF5N1XHCWM7KXH6RXFS":3,"skill-same:01M7B2ZGF5N1XHCWM7KXH6RXFS":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":28,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M7B2ZGF5N1XHCWM7KXH6RXFS","mechanics-harness",null,"xirtus\u002F3JSE","xirtus","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F8495145?v=4","01M7B2YY3Y4XFSV4WSG3DQ7DYQ","Andreas Xirtus","01M7B2YY539A2AR3N5MM0ZR93M",2,"GPL-3.0","https:\u002F\u002Fgithub.com\u002Fxirtus\u002F3JSE\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmechanics-harness\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# Mechanics Harness\n\nUse for any gameplay system that has real feel or invariants. Pattern proven by the reference games (3JSURF, ZENDRIVE, DAMN BEAVERS, MANDELHOP, BREAKING WAVES).\n\n## The five tools every project should have\n\n1. **Headless mechanics check** — gameplay logic must run with no renderer, no canvas, no DOM (stub scene\u002Fparticles\u002Fcharacter objects). Assert the numbers: ride length, lap time, sim tick counts. These numbers must match the rendered build. (3jsurf: `tools\u002Fmechcheck.mjs`; zendrive: `npm test`; dambeavers: `tests\u002Fsimulation`.)\n2. **Feel as numbers** — measure the mechanic, don't screenshot it: crossing time, peak speed, drift duration, jump arc. Store the table; it becomes the FeelSpec anchors later. (3jsurf: `tools\u002Ffeel.mjs`.)\n3. **Invariant soak** — script a pilot with a personality (pump\u002Fstall\u002Fair on a cycle), run N seconds, sample the invariants EVERY frame: rider-on-surface, camera-out-of-geometry, no console errors. Count violations as percentages; a stale state flag can zero them. (3jsurf: `tools\u002Fsoak.mjs`.)\n4. **Heuristic player agents** — drive the REAL game with a bot that plays like a person, report deaths\u002Fcompletion\u002Ftime, and classify every death as the player's mistake or an \"unfair\" system\u002Fcamera fault. Unfair deaths are bugs. (mendalhop: `qa\u002Fbot.mjs` with new\u002Fpro skills.)\n5. **Single-term debug isolation** — a debug mask (e.g. `WAVEDBG=1..7`) that renders one shading\u002Fterm layer at a time, answering \"what is painting that?\" with one screenshot instead of ten guesses. A live 2D plot of the key profile beside the viewport is the same idea for geometry. (3jsurf: `WAVEDBG`; breaking-waves: the parametric profile plot.)\n\n## Rules\n\n- A static scene is not a game; a screenshot is not a measurement. Numbers change rarely; screenshots change constantly.\n- Invariants belong to the system, not the level: sample them every frame, not when convenient.\n- Gameplay math and render math must be the same numbers — collision on grid math, attachment by construction, no lookups that can disagree with what you see. (mendalhop's unfairness-free core; 3jsurf's `ridePoint`.)\n- If the mechanic must change with world scale, its parameters must live in the mechanic's own units (surf: wave stations; driving: track distance\u002Flateral), never absolute metres.\n- State bugs are geometry bugs: a flag written in one state and not cleared in another will surface as a physical invariant violation.\n- Deterministic seeds for AI and sim; time powers route through one clock (`worldDt = dt * scale`); replay is 12Hz recorded state, which is enough for ghosts and time-travel debugging.\n- Every phase ends with a written gate sentence and a composed gate test that proves it (dambeavers pattern).\n",{},"main","6e2d3a6a3ae00965b2e0dac39fc7d082a68d8b39",".claude\u002Fskills\u002Fmechanics-harness",0,"https:\u002F\u002Fgithub.com\u002Fxirtus\u002F3JSE","https:\u002F\u002Fgithub.com\u002Fxirtus","metaspace.xirtus.com","https:\u002F\u002FAndreas.me\r\n","2026-10-20 07:07:06",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add xirtus\u002F3JSE --skill mechanics-harness",{"tool":37,"command":38},"bunx","bunx skills add xirtus\u002F3JSE --skill mechanics-harness",{"tool":40,"command":41},"pnpm","pnpm dlx skills add xirtus\u002F3JSE --skill mechanics-harness","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fxirtus\u002F3JSE\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fmechanics-harness\u002FSKILL.md",true,[],[46,52,58,64,70,76],{"skillNo":47,"name":48,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":18},"01M7B33DN3BBGB63JJGB9DFBBN","webgpu","https:\u002F\u002Fgithub.com\u002Fxirtus\u002F3JSE\u002Fblob\u002Fmain\u002F3JSE_Harness_v0.2\u002F.claude\u002Fskills\u002Fwebgpu\u002FSKILL.md",[],[],{"skillNo":53,"name":54,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M7B33APJ9BYZXX0068A1ZB8T","visual-qa","https:\u002F\u002Fgithub.com\u002Fxirtus\u002F3JSE\u002Fblob\u002Fmain\u002F3JSE_Harness_v0.2\u002F.claude\u002Fskills\u002Fvisual-qa\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":18},"01M7B339H7H5JW80G1WHX3R9MV","vendor-router","https:\u002F\u002Fgithub.com\u002Fxirtus\u002F3JSE\u002Fblob\u002Fmain\u002F3JSE_Harness_v0.2\u002F.claude\u002Fskills\u002Fvendor-router\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M7B336MK7S7A3RSBMG8EMAEG","threejs-runtime","https:\u002F\u002Fgithub.com\u002Fxirtus\u002F3JSE\u002Fblob\u002Fmain\u002F3JSE_Harness_v0.2\u002F.claude\u002Fskills\u002Fthreejs-runtime\u002FSKILL.md",[],[],{"skillNo":71,"name":72,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":18},"01M7B335CXS2ZGJY6949KP08Y4","safe-repo-inspector","https:\u002F\u002Fgithub.com\u002Fxirtus\u002F3JSE\u002Fblob\u002Fmain\u002F3JSE_Harness_v0.2\u002F.claude\u002Fskills\u002Fsafe-repo-inspector\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M7B33498PEQ1WR79TS0PFX1M","reference-broker","https:\u002F\u002Fgithub.com\u002Fxirtus\u002F3JSE\u002Fblob\u002Fmain\u002F3JSE_Harness_v0.2\u002F.claude\u002Fskills\u002Freference-broker\u002FSKILL.md",[],[]]