[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75DBRTKD0EWS59Z2QY9Z19M":3,"skill-same:01M75DBRTKD0EWS59Z2QY9Z19M":43},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":28,"install":29,"resources":42},"01M75DBRTKD0EWS59Z2QY9Z19M","verify-changes",null,"Use before claiming any change to this repo is done, fixed, or passing — and when a build fails after tests passed, a color sneaks past lint, or a localStorage test misbehaves.","nathaniel-lyman\u002Fparts-bin","nathaniel-lyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F212639847?v=4","01M75DAXV0KPY2T75ERWJ6HW10","01M75DAXVND673PXPXAQ863WHJ",0,"MIT","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002Fskills\u002Fverify-changes\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: verify-changes\ndescription: Use before claiming any change to this repo is done, fixed, or passing — and when a build fails after tests passed, a color sneaks past lint, or a localStorage test misbehaves.\n---\n\n# Verify Changes\n\n## Overview\n\nGreen tests alone do not prove a change is done in this repo. Vitest does not\ntype-check, and the theme boundary has blind spots. Verification should still\nmatch the risk and blast radius of the change. Start with the smallest test that\ncan fail for the edited surface, then broaden only when the change crosses\ncomponent, theme, public API, package, or behavior boundaries.\n\n## Choose the smallest meaningful gate\n\n| Change type | Run |\n|---|---|---|\n| One component only | `npx vitest run path\u002Fto\u002FComponent.test.tsx` |\n| Component export or catalog metadata changed | Affected component test + `npx vitest run src\u002Fcomponents\u002Fcatalog.test.ts src\u002Fcomponents\u002Fbarrels.test.ts`; add `npm run build` when public props\u002Ftypes changed |\n| Styling or theme-token change | Affected component test + `npm run lint:theme`; add a focused browser check for visible changes |\n| Shared hook\u002Fselector\u002Fhelper | Directly affected test file(s), then broaden only if callers or contracts changed |\n| DataGrid infrastructure, persistence, or package entrypoints | Directly affected DataGrid tests first; add `npm run build`, `npm run test:package`, or focused Playwright when that surface changed |\n| Release, broad refactor, dependency\u002Fconfig change, or user asks for full verification | `npm run lint`, `npm run lint:theme`, `npm run build`, `npm test`; add `npm run test:e2e` for layout\u002Fvisual behavior |\n\nNotes that prevent wasted debugging:\n\n- **Build is the real type-check.** Vitest does not type-check, and\n  `tsconfig` sets `noUnusedLocals`, so a single unused import fails the build\n  even when every test is green. Run `npm run build` when TypeScript contracts,\n  exported props, barrels, package entrypoints, or public APIs changed.\n- **`lint:theme` has a blind spot.** It only matches raw color text. Named Tailwind\n  color utilities (e.g. `bg-black\u002F40`) slip past it — do not introduce new\n  ones; use token-backed utilities instead. Run it when styling or tokens\n  changed.\n- **Vitest depends on `src\u002Ftest-setup.ts`.** It installs an in-memory\n  localStorage polyfill (Node 25 ships a broken experimental global that\n  shadows jsdom's). If localStorage-backed hook tests fail strangely, check\n  that file is intact — and never remove it.\n- **Playwright is self-contained.** Playwright's `webServer` config builds and\n  serves the app itself — don't pre-start a dev server. First run on a\n  fresh clone needs browser binaries: `npx playwright install`.\n\nRun a single test while iterating, and only run broader gates when the table\nabove calls for them:\n\n```bash\nnpx vitest run src\u002Fselectors\u002Fmetrics.test.ts        # one file\nnpx vitest run -t \"totalMrr excludes Churned\"       # one test by name\n```\n\n## Before \"fixing\" a metric or visual behavior\n\n`demo.html` (standalone prototype) is the behavior parity target and\n`THEME-SPEC.md` is the design spec. Some behavior that looks like a bug is\npinned on purpose — e.g. `avgGrowth` in `src\u002Fselectors\u002Fmetrics.ts` includes\nChurned accounts to match the demo. Compare against `demo.html` before\nchanging any metric, KPI, table, or chart behavior. Browsers\u002Ftools can't open\n`file:\u002F\u002F` URLs; serve it first (`python3 -m http.server`).\n\n## Common mistakes\n\n| Mistake | Reality |\n|---|---|\n| \"Tests pass, ship it\" | Build may still fail on types\u002Funused imports. Run `npm run build` when public types\u002Fcontracts changed. |\n| \"lint:theme passed, boundary is clean\" | Named Tailwind colors slip past. Grep your diff: `grep -E 'bg-(white|black|gray|slate|zinc)|text-(white|black|gray)'` |\n| \"This metric is obviously wrong, fixing it\" | Check `demo.html` parity first — it may be pinned by design. |\n| \"Skipping e2e, jsdom covered it\" | Layout-sensitive DataGrid behavior only fails in a real browser. |\n| \"One component changed, so run everything\" | Start with that component's colocated test and broaden only for changed boundaries. |\n","# Verify Changes\n\n## Overview\n\nGreen tests alone do not prove a change is done in this repo. Vitest does not\ntype-check, and the theme boundary has blind spots. Verification should still\nmatch the risk and blast radius of the change. Start with the smallest test that\ncan fail for the edited surface, then broaden only when the change crosses\ncomponent, theme, public API, package, or behavior boundaries.\n\n## Choose the smallest meaningful gate\n\n| Change type | Run |\n|---|---|---|\n| One component only | `npx vitest run path\u002Fto\u002FComponent.test.tsx` |\n| Component export or catalog metadata changed | Affected component test + `npx vitest run src\u002Fcomponents\u002Fcatalog.test.ts src\u002Fcomponents\u002Fbarrels.test.ts`; add `npm run build` when public props\u002Ftypes changed |\n| Styling or theme-token change | Affected component test + `npm run lint:theme`; add a focused browser check for visible changes |\n| Shared hook\u002Fselector\u002Fhelper | Directly affected test file(s), then broaden only if callers or contracts changed |\n| DataGrid infrastructure, persistence, or package entrypoints | Directly affected DataGrid tests first; add `npm run build`, `npm run test:package`, or focused Playwright when that surface changed |\n| Release, broad refactor, dependency\u002Fconfig change, or user asks for full verification | `npm run lint`, `npm run lint:theme`, `npm run build`, `npm test`; add `npm run test:e2e` for layout\u002Fvisual behavior |\n\nNotes that prevent wasted debugging:\n\n- **Build is the real type-check.** Vitest does not type-check, and\n  `tsconfig` sets `noUnusedLocals`, so a single unused import fails the build\n  even when every test is green. Run `npm run build` when TypeScript contracts,\n  exported props, barrels, package entrypoints, or public APIs changed.\n- **`lint:theme` has a blind spot.** It only matches raw color text. Named Tailwind\n  color utilities (e.g. `bg-black\u002F40`) slip past it — do not introduce new\n  ones; use token-backed utilities instead. Run it when styling or tokens\n  changed.\n- **Vitest depends on `src\u002Ftest-setup.ts`.** It installs an in-memory\n  localStorage polyfill (Node 25 ships a broken experimental global that\n  shadows jsdom's). If localStorage-backed hook tests fail strangely, check\n  that file is intact — and never remove it.\n- **Playwright is self-contained.** Playwright's `webServer` config builds and\n  serves the app itself — don't pre-start a dev server. First run on a\n  fresh clone needs browser binaries: `npx playwright install`.\n\nRun a single test while iterating, and only run broader gates when the table\nabove calls for them:\n\n```bash\nnpx vitest run src\u002Fselectors\u002Fmetrics.test.ts        # one file\nnpx vitest run -t \"totalMrr excludes Churned\"       # one test by name\n```\n\n## Before \"fixing\" a metric or visual behavior\n\n`demo.html` (standalone prototype) is the behavior parity target and\n`THEME-SPEC.md` is the design spec. Some behavior that looks like a bug is\npinned on purpose — e.g. `avgGrowth` in `src\u002Fselectors\u002Fmetrics.ts` includes\nChurned accounts to match the demo. Compare against `demo.html` before\nchanging any metric, KPI, table, or chart behavior. Browsers\u002Ftools can't open\n`file:\u002F\u002F` URLs; serve it first (`python3 -m http.server`).\n\n## Common mistakes\n\n| Mistake | Reality |\n|---|---|\n| \"Tests pass, ship it\" | Build may still fail on types\u002Funused imports. Run `npm run build` when public types\u002Fcontracts changed. |\n| \"lint:theme passed, boundary is clean\" | Named Tailwind colors slip past. Grep your diff: `grep -E 'bg-(white|black|gray|slate|zinc)|text-(white|black|gray)'` |\n| \"This metric is obviously wrong, fixing it\" | Check `demo.html` parity first — it may be pinned by design. |\n| \"Skipping e2e, jsdom covered it\" | Layout-sensitive DataGrid behavior only fails in a real browser. |\n| \"One component changed, so run everything\" | Start with that component's colocated test and broaden only for changed boundaries. |\n",{"name":5,"description":7},"main","5dd5fff030a1246374fe1c4b57210cfc13732f9e","skills\u002Fverify-changes","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman","2026-10-29 18:49:15",{"source":8,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add nathaniel-lyman\u002Fparts-bin --skill verify-changes",{"tool":35,"command":36},"bunx","bunx skills add nathaniel-lyman\u002Fparts-bin --skill verify-changes",{"tool":38,"command":39},"pnpm","pnpm dlx skills add nathaniel-lyman\u002Fparts-bin --skill verify-changes","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002Fskills\u002Fverify-changes\u002FSKILL.md",true,[],[44,51,58,65,70,75],{"skillNo":45,"name":46,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":18},"01M75DBPNE1XBCTD5XPJDBQ6D4","swap-data-domain","Use when replacing the demo accounts\u002FMRR data with your own domain — new entity types, seed data, KPIs, chart series, grid columns, or CRUD forms.","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002Fskills\u002Fswap-data-domain\u002FSKILL.md",[],[],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":18},"01M75DBKPNENC9H1MYXN2Y7PBT","retheme","Use when re-skinning this dashboard to a new brand or palette — changing colors, accent, dark mode, radii, fonts, or chart colors, or when asked to \"make it match my brand\".","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002Fskills\u002Fretheme\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":18},"01M75DBHFVBX7ZM9JFPY4KYAB8","add-component","Use when adding or substantially modifying any UI component in this repo — before writing the first line of JSX.","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002Fskills\u002Fadd-component\u002FSKILL.md",[],[],{"skillNo":66,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":18},"01M75DBEKJRMF50NX8GB4494S6","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fverify-changes\u002FSKILL.md",[],[],{"skillNo":71,"name":46,"nameZh":6,"description":47,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M75DBBYPQ61R4R337F30FCZ9","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fswap-data-domain\u002FSKILL.md",[],[],{"skillNo":76,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M75DBA6DGYN01RTY28K712BN","https:\u002F\u002Fgithub.com\u002Fnathaniel-lyman\u002Fparts-bin\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fretheme\u002FSKILL.md",[],[]]