kit-adopt
Kit adopt: one app onto the packages, in one pass
One pass is: survey → baseline → budgets → dev tools → studio → quality → prune → verify → report, for one app. The other skills build things; this one takes out what an app copied before the packages existed and puts the package in its place, so the next model pass, mockup round or perf pass starts on the kit. Nothing on screen should change: the play view before and after is the check.
Words used below:
- App: the one the user named when invoking the skill; in a monorepo, one workspace.
- Copy: code the app carries that a package now does: a
?debugswitch with a perf HUD, console helpers wired by hand, a studio or mockups shell (URL parsing, switchers, orbit rig, readout), budgets written into a file, a hard-coded pixel ratio, test helpers that count triangles. - Swap: one copy out, its package in, with the app's own choices kept (HUD placement, storage keys, URL keys, views, numbers).
- Budgets: the app's
defineBudgetsfile (src/budgets.ts, from@zkmake/three-audit/budgets):frameis the target,partsthe ceilings its tests hold. - Style guide: the app's
3D-STYLE.md, as the model-pass skill keeps it. Its Budgets say why each number is what it is. - Play view: what the player sees, at each play position the perf-pass skill names (start, the busiest moment, each level or screen), and the studio's
playview of each area. - Ledger of lines: each copy's files and line count before, and what replaced it after. The report's first table.
The tools are the @zkmake/* packages. This skill names their calls; the installed package's README (node_modules/@zkmake/<name>/README.md, or https://zkmake.github.io/three-kit/llms-full.txt) is the authority on their signatures. Paths below are relative to this skill's directory.
0. Survey
Read the project's and the app's AGENTS.md (or CLAUDE.md) and style guide first: how it installs packages (catalog, exact versions, release-age rules), which scripts it runs and which it never runs by hand, and what other work is uncommitted in the tree (leave it alone).