playbooks/build.md
GitHubBuild
- Triage: system installed or not, raw values in occurrences (
build-design-system/scripts/check-system.mjs --no-allowlist --no-self-test --json, counted by rule), duplicate families, surface count. A small app (8 surfaces or fewer) gets one worker and no window. - Frame the complaint in the person's words, pick the pilot flow, accept the taste file.
- Run
build-design-systemsteps 1 to 6 with one writing step at a time. Judge each return fromgit diff, never from its message. - Run the readiness audits. Open rows go in the report, and the playbook ends check-first.
- Triage again with the same command and report both sets of numbers in the same units.
- Offer the migration with its size. Do not start it.
Done when the check exits 0 on a clean clone, the pilot matches its baseline except for listed changes, and the report has the before and after numbers.