buildanything 1.8.0 → 2.1.1

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 (494) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/.claude-plugin/plugin.json +17 -3
  3. package/CHANGELOG.md +57 -0
  4. package/README.md +57 -61
  5. package/agents/a11y-architect.md +168 -0
  6. package/agents/briefing-officer.md +172 -0
  7. package/agents/business-model.md +82 -29
  8. package/agents/code-architect.md +80 -0
  9. package/agents/code-reviewer.md +256 -0
  10. package/agents/code-simplifier.md +72 -0
  11. package/agents/design-brand-guardian.md +312 -53
  12. package/agents/design-critic.md +144 -0
  13. package/agents/design-inclusive-visuals-specialist.md +8 -19
  14. package/agents/design-ui-designer.md +352 -56
  15. package/agents/design-ux-architect.md +418 -55
  16. package/agents/design-ux-researcher.md +359 -49
  17. package/agents/engineering-ai-engineer.md +28 -36
  18. package/agents/engineering-backend-architect.md +187 -36
  19. package/agents/engineering-data-engineer.md +227 -43
  20. package/agents/engineering-devops-automator.md +229 -74
  21. package/agents/engineering-frontend-developer.md +223 -34
  22. package/agents/engineering-mobile-app-builder.md +8 -1
  23. package/agents/engineering-rapid-prototyper.md +45 -11
  24. package/agents/engineering-security-engineer.md +265 -61
  25. package/agents/engineering-senior-developer.md +141 -19
  26. package/agents/engineering-sre.md +86 -0
  27. package/agents/engineering-technical-writer.md +287 -41
  28. package/agents/feature-intel.md +111 -0
  29. package/agents/ios-app-review-guardian.md +21 -2
  30. package/agents/ios-foundation-models-specialist.md +22 -2
  31. package/agents/ios-product-reality-auditor.md +292 -0
  32. package/agents/ios-storekit-specialist.md +11 -2
  33. package/agents/ios-swift-architect.md +29 -1
  34. package/agents/ios-swift-search.md +9 -1
  35. package/agents/ios-swift-ui-design.md +40 -5
  36. package/agents/marketing-app-store-optimizer.md +248 -64
  37. package/agents/planner.md +221 -0
  38. package/agents/pr-test-analyzer.md +64 -0
  39. package/agents/product-feedback-synthesizer.md +70 -2
  40. package/agents/product-owner.md +163 -0
  41. package/agents/product-reality-auditor.md +216 -0
  42. package/agents/product-spec-writer.md +176 -0
  43. package/agents/refactor-cleaner.md +110 -0
  44. package/agents/security-reviewer.md +129 -0
  45. package/agents/silent-failure-hunter.md +55 -0
  46. package/agents/swift-build-resolver.md +121 -0
  47. package/agents/swift-reviewer.md +113 -0
  48. package/agents/tech-feasibility.md +26 -4
  49. package/agents/testing-api-tester.md +238 -59
  50. package/agents/testing-evidence-collector.md +50 -1
  51. package/agents/testing-performance-benchmarker.md +23 -1
  52. package/agents/testing-reality-checker.md +7 -1
  53. package/agents/visual-research.md +118 -0
  54. package/bin/adapters/cycle-counter-tool.ts +155 -0
  55. package/bin/adapters/scribe-tool.ts +73 -0
  56. package/bin/adapters/state-save-tool.ts +130 -0
  57. package/bin/adapters/write-lease-tool.ts +127 -0
  58. package/bin/buildanything-runtime.js +15 -0
  59. package/bin/buildanything-runtime.ts +241 -0
  60. package/bin/graph-index.js +24 -0
  61. package/bin/graph-index.ts +340 -0
  62. package/bin/mcp-servers/graph-mcp.js +26 -0
  63. package/bin/mcp-servers/graph-mcp.ts +481 -0
  64. package/bin/mcp-servers/orchestrator-mcp.js +26 -0
  65. package/bin/mcp-servers/orchestrator-mcp.ts +361 -0
  66. package/bin/setup.js +312 -76
  67. package/commands/add-feature.md +2 -0
  68. package/commands/build.md +994 -265
  69. package/commands/fix.md +1 -1
  70. package/commands/idea-sweep.md +2 -2
  71. package/commands/self-check.md +121 -0
  72. package/commands/setup.md +61 -9
  73. package/commands/ux-review.md +5 -5
  74. package/commands/verify.md +9 -9
  75. package/docs/migration/agents.yaml +729 -0
  76. package/docs/migration/phase-graph.yaml +1504 -0
  77. package/docs/migration/sdk-host-compat.md +18 -0
  78. package/hooks/compile-writer-owner-cache.ts +171 -0
  79. package/hooks/design-md-lint +4 -0
  80. package/hooks/design-md-lint.ts +295 -0
  81. package/hooks/hooks.json +36 -0
  82. package/hooks/pre-tool-use +19 -0
  83. package/hooks/pre-tool-use.ts +807 -0
  84. package/hooks/record-mode-transitions.ts +235 -0
  85. package/hooks/session-start +71 -1
  86. package/hooks/subagent-start +17 -0
  87. package/hooks/subagent-start.ts +472 -0
  88. package/hooks/subagent-stop +17 -0
  89. package/hooks/subagent-stop.ts +153 -0
  90. package/package.json +26 -4
  91. package/protocols/agent-prompt-authoring.md +165 -0
  92. package/protocols/architecture-schema.md +178 -0
  93. package/protocols/cleanup.md +4 -0
  94. package/protocols/decision-log.md +135 -0
  95. package/protocols/design-md-authoring.md +520 -0
  96. package/protocols/design-md-spec.md +362 -0
  97. package/protocols/fake-data-detector.md +1 -1
  98. package/protocols/ios-context.md +10 -11
  99. package/protocols/ios-fake-data-detector.md +65 -0
  100. package/protocols/ios-phase-branches.md +299 -39
  101. package/protocols/launch-readiness.md +262 -0
  102. package/protocols/metric-loop.md +62 -2
  103. package/protocols/page-spec-schema.md +234 -0
  104. package/protocols/product-spec-schema.md +354 -0
  105. package/protocols/smoke-test.md +9 -1
  106. package/protocols/sprint-tasks-schema.md +53 -0
  107. package/protocols/state-schema.json +423 -0
  108. package/protocols/state-schema.md +202 -0
  109. package/protocols/verify.md +91 -3
  110. package/protocols/web-phase-branches.md +395 -75
  111. package/skills/ios/_VENDORED.md +2 -0
  112. package/skills/ios/app-store-connect-metadata/SKILL.md +148 -0
  113. package/skills/ios/asc-privacy-manifest/SKILL.md +350 -0
  114. package/skills/ios/hig-components-content/SKILL.md +86 -0
  115. package/skills/ios/hig-components-content/references/activity-views.md +79 -0
  116. package/skills/ios/hig-components-content/references/charts.md +180 -0
  117. package/skills/ios/hig-components-content/references/collections.md +48 -0
  118. package/skills/ios/hig-components-content/references/color-wells.md +42 -0
  119. package/skills/ios/hig-components-content/references/image-views.md +82 -0
  120. package/skills/ios/hig-components-content/references/image-wells.md +34 -0
  121. package/skills/ios/hig-components-content/references/lockups.md +78 -0
  122. package/skills/ios/hig-components-content/references/web-views.md +36 -0
  123. package/skills/ios/hig-components-controls/SKILL.md +88 -0
  124. package/skills/ios/hig-components-controls/references/combo-boxes.md +40 -0
  125. package/skills/ios/hig-components-controls/references/controls.md +112 -0
  126. package/skills/ios/hig-components-controls/references/gauges.md +74 -0
  127. package/skills/ios/hig-components-controls/references/labels.md +92 -0
  128. package/skills/ios/hig-components-controls/references/pickers.md +128 -0
  129. package/skills/ios/hig-components-controls/references/rating-indicators.md +38 -0
  130. package/skills/ios/hig-components-controls/references/segmented-controls.md +94 -0
  131. package/skills/ios/hig-components-controls/references/sliders.md +92 -0
  132. package/skills/ios/hig-components-controls/references/steppers.md +40 -0
  133. package/skills/ios/hig-components-controls/references/text-fields.md +88 -0
  134. package/skills/ios/hig-components-controls/references/text-views.md +56 -0
  135. package/skills/ios/hig-components-controls/references/toggles.md +127 -0
  136. package/skills/ios/hig-components-controls/references/token-fields.md +48 -0
  137. package/skills/ios/hig-components-controls/references/virtual-keyboards.md +156 -0
  138. package/skills/ios/hig-components-dialogs/SKILL.md +76 -0
  139. package/skills/ios/hig-components-dialogs/references/action-sheets.md +74 -0
  140. package/skills/ios/hig-components-dialogs/references/alerts.md +158 -0
  141. package/skills/ios/hig-components-dialogs/references/digit-entry-views.md +32 -0
  142. package/skills/ios/hig-components-dialogs/references/popovers.md +81 -0
  143. package/skills/ios/hig-components-dialogs/references/sheets.md +157 -0
  144. package/skills/ios/hig-components-layout/SKILL.md +99 -0
  145. package/skills/ios/hig-components-layout/references/boxes.md +48 -0
  146. package/skills/ios/hig-components-layout/references/column-views.md +44 -0
  147. package/skills/ios/hig-components-layout/references/lists-and-tables.md +99 -0
  148. package/skills/ios/hig-components-layout/references/ornaments.md +56 -0
  149. package/skills/ios/hig-components-layout/references/outline-views.md +64 -0
  150. package/skills/ios/hig-components-layout/references/panels.md +75 -0
  151. package/skills/ios/hig-components-layout/references/scroll-views.md +123 -0
  152. package/skills/ios/hig-components-layout/references/sidebars.md +109 -0
  153. package/skills/ios/hig-components-layout/references/split-views.md +110 -0
  154. package/skills/ios/hig-components-layout/references/tab-bars.md +173 -0
  155. package/skills/ios/hig-components-layout/references/tab-views.md +68 -0
  156. package/skills/ios/hig-components-layout/references/windows.md +188 -0
  157. package/skills/ios/hig-components-menus/SKILL.md +81 -0
  158. package/skills/ios/hig-components-menus/references/action-button.md +61 -0
  159. package/skills/ios/hig-components-menus/references/buttons.md +261 -0
  160. package/skills/ios/hig-components-menus/references/context-menus.md +105 -0
  161. package/skills/ios/hig-components-menus/references/disclosure-controls.md +84 -0
  162. package/skills/ios/hig-components-menus/references/dock-menus.md +40 -0
  163. package/skills/ios/hig-components-menus/references/edit-menus.md +88 -0
  164. package/skills/ios/hig-components-menus/references/menus.md +171 -0
  165. package/skills/ios/hig-components-menus/references/pop-up-buttons.md +70 -0
  166. package/skills/ios/hig-components-menus/references/pull-down-buttons.md +77 -0
  167. package/skills/ios/hig-components-menus/references/the-menu-bar.md +303 -0
  168. package/skills/ios/hig-components-menus/references/toolbars.md +256 -0
  169. package/skills/ios/hig-components-search/SKILL.md +68 -0
  170. package/skills/ios/hig-components-search/references/page-controls.md +120 -0
  171. package/skills/ios/hig-components-search/references/path-controls.md +40 -0
  172. package/skills/ios/hig-components-search/references/search-fields.md +189 -0
  173. package/skills/ios/hig-components-status/SKILL.md +80 -0
  174. package/skills/ios/hig-components-status/references/activity-rings.md +105 -0
  175. package/skills/ios/hig-components-status/references/progress-indicators.md +116 -0
  176. package/skills/ios/hig-components-status/references/status-bars.md +38 -0
  177. package/skills/ios/hig-components-system/SKILL.md +88 -0
  178. package/skills/ios/hig-components-system/references/app-clips.md +387 -0
  179. package/skills/ios/hig-components-system/references/app-shortcuts.md +114 -0
  180. package/skills/ios/hig-components-system/references/complications.md +425 -0
  181. package/skills/ios/hig-components-system/references/home-screen-quick-actions.md +42 -0
  182. package/skills/ios/hig-components-system/references/live-activities.md +442 -0
  183. package/skills/ios/hig-components-system/references/notifications.md +153 -0
  184. package/skills/ios/hig-components-system/references/top-shelf.md +135 -0
  185. package/skills/ios/hig-components-system/references/watch-faces.md +40 -0
  186. package/skills/ios/hig-components-system/references/widgets.md +517 -0
  187. package/skills/ios/hig-foundations/SKILL.md +98 -0
  188. package/skills/ios/hig-foundations/references/accessibility.md +291 -0
  189. package/skills/ios/hig-foundations/references/app-icons.md +210 -0
  190. package/skills/ios/hig-foundations/references/branding.md +44 -0
  191. package/skills/ios/hig-foundations/references/color.md +274 -0
  192. package/skills/ios/hig-foundations/references/dark-mode.md +116 -0
  193. package/skills/ios/hig-foundations/references/icons.md +263 -0
  194. package/skills/ios/hig-foundations/references/images.md +176 -0
  195. package/skills/ios/hig-foundations/references/immersive-experiences.md +174 -0
  196. package/skills/ios/hig-foundations/references/inclusion.md +189 -0
  197. package/skills/ios/hig-foundations/references/layout.md +425 -0
  198. package/skills/ios/hig-foundations/references/materials.md +238 -0
  199. package/skills/ios/hig-foundations/references/motion.md +103 -0
  200. package/skills/ios/hig-foundations/references/privacy.md +231 -0
  201. package/skills/ios/hig-foundations/references/right-to-left.md +206 -0
  202. package/skills/ios/hig-foundations/references/sf-symbols.md +310 -0
  203. package/skills/ios/hig-foundations/references/spatial-layout.md +142 -0
  204. package/skills/ios/hig-foundations/references/typography.md +1146 -0
  205. package/skills/ios/hig-foundations/references/writing.md +91 -0
  206. package/skills/ios/hig-inputs/SKILL.md +94 -0
  207. package/skills/ios/hig-inputs/references/apple-pencil-and-scribble.md +148 -0
  208. package/skills/ios/hig-inputs/references/camera-control.md +107 -0
  209. package/skills/ios/hig-inputs/references/digital-crown.md +83 -0
  210. package/skills/ios/hig-inputs/references/eyes.md +120 -0
  211. package/skills/ios/hig-inputs/references/focus-and-selection.md +120 -0
  212. package/skills/ios/hig-inputs/references/game-controls.md +156 -0
  213. package/skills/ios/hig-inputs/references/gestures.md +208 -0
  214. package/skills/ios/hig-inputs/references/gyro-and-accelerometer.md +40 -0
  215. package/skills/ios/hig-inputs/references/keyboards.md +234 -0
  216. package/skills/ios/hig-inputs/references/nearby-interactions.md +70 -0
  217. package/skills/ios/hig-inputs/references/pointing-devices.md +237 -0
  218. package/skills/ios/hig-inputs/references/remotes.md +67 -0
  219. package/skills/ios/hig-inputs/references/spatial-interactions.md +70 -0
  220. package/skills/ios/hig-patterns/SKILL.md +104 -0
  221. package/skills/ios/hig-patterns/references/charting-data.md +81 -0
  222. package/skills/ios/hig-patterns/references/collaboration-and-sharing.md +86 -0
  223. package/skills/ios/hig-patterns/references/drag-and-drop.md +134 -0
  224. package/skills/ios/hig-patterns/references/entering-data.md +69 -0
  225. package/skills/ios/hig-patterns/references/feedback.md +67 -0
  226. package/skills/ios/hig-patterns/references/file-management.md +135 -0
  227. package/skills/ios/hig-patterns/references/going-full-screen.md +79 -0
  228. package/skills/ios/hig-patterns/references/launching.md +81 -0
  229. package/skills/ios/hig-patterns/references/live-viewing-apps.md +79 -0
  230. package/skills/ios/hig-patterns/references/loading.md +59 -0
  231. package/skills/ios/hig-patterns/references/managing-accounts.md +107 -0
  232. package/skills/ios/hig-patterns/references/managing-notifications.md +99 -0
  233. package/skills/ios/hig-patterns/references/modality.md +82 -0
  234. package/skills/ios/hig-patterns/references/multitasking.md +131 -0
  235. package/skills/ios/hig-patterns/references/offering-help.md +117 -0
  236. package/skills/ios/hig-patterns/references/onboarding.md +69 -0
  237. package/skills/ios/hig-patterns/references/playing-audio.md +124 -0
  238. package/skills/ios/hig-patterns/references/playing-haptics.md +280 -0
  239. package/skills/ios/hig-patterns/references/playing-video.md +180 -0
  240. package/skills/ios/hig-patterns/references/printing.md +50 -0
  241. package/skills/ios/hig-patterns/references/ratings-and-reviews.md +48 -0
  242. package/skills/ios/hig-patterns/references/searching.md +70 -0
  243. package/skills/ios/hig-patterns/references/settings.md +84 -0
  244. package/skills/ios/hig-patterns/references/undo-and-redo.md +58 -0
  245. package/skills/ios/hig-patterns/references/workouts.md +76 -0
  246. package/skills/ios/hig-platforms/SKILL.md +84 -0
  247. package/skills/ios/hig-platforms/references/designing-for-games.md +159 -0
  248. package/skills/ios/hig-platforms/references/designing-for-ios.md +66 -0
  249. package/skills/ios/hig-platforms/references/designing-for-ipados.md +64 -0
  250. package/skills/ios/hig-platforms/references/designing-for-macos.md +70 -0
  251. package/skills/ios/hig-platforms/references/designing-for-tvos.md +68 -0
  252. package/skills/ios/hig-platforms/references/designing-for-visionos.md +85 -0
  253. package/skills/ios/hig-platforms/references/designing-for-watchos.md +74 -0
  254. package/skills/ios/hig-project-context/SKILL.md +133 -0
  255. package/skills/ios/hig-technologies/SKILL.md +107 -0
  256. package/skills/ios/hig-technologies/references/airplay.md +125 -0
  257. package/skills/ios/hig-technologies/references/always-on.md +62 -0
  258. package/skills/ios/hig-technologies/references/apple-pay.md +441 -0
  259. package/skills/ios/hig-technologies/references/augmented-reality.md +247 -0
  260. package/skills/ios/hig-technologies/references/carekit.md +224 -0
  261. package/skills/ios/hig-technologies/references/carplay.md +119 -0
  262. package/skills/ios/hig-technologies/references/game-center.md +343 -0
  263. package/skills/ios/hig-technologies/references/generative-ai.md +110 -0
  264. package/skills/ios/hig-technologies/references/healthkit.md +120 -0
  265. package/skills/ios/hig-technologies/references/homekit.md +343 -0
  266. package/skills/ios/hig-technologies/references/icloud.md +52 -0
  267. package/skills/ios/hig-technologies/references/id-verifier.md +73 -0
  268. package/skills/ios/hig-technologies/references/imessage-apps-and-stickers.md +105 -0
  269. package/skills/ios/hig-technologies/references/in-app-purchase.md +263 -0
  270. package/skills/ios/hig-technologies/references/live-photos.md +54 -0
  271. package/skills/ios/hig-technologies/references/mac-catalyst.md +216 -0
  272. package/skills/ios/hig-technologies/references/machine-learning.md +394 -0
  273. package/skills/ios/hig-technologies/references/maps.md +221 -0
  274. package/skills/ios/hig-technologies/references/nfc.md +51 -0
  275. package/skills/ios/hig-technologies/references/photo-editing.md +40 -0
  276. package/skills/ios/hig-technologies/references/researchkit.md +134 -0
  277. package/skills/ios/hig-technologies/references/shareplay.md +142 -0
  278. package/skills/ios/hig-technologies/references/shazamkit.md +47 -0
  279. package/skills/ios/hig-technologies/references/sign-in-with-apple.md +288 -0
  280. package/skills/ios/hig-technologies/references/siri.md +523 -0
  281. package/skills/ios/hig-technologies/references/tap-to-pay-on-iphone.md +208 -0
  282. package/skills/ios/hig-technologies/references/voiceover.md +90 -0
  283. package/skills/ios/hig-technologies/references/wallet.md +420 -0
  284. package/skills/ios/ios-bootstrap/SKILL.md +17 -8
  285. package/skills/ios/swift-actor-persistence/SKILL.md +143 -0
  286. package/skills/ios/swift-concurrency-6-2/SKILL.md +216 -0
  287. package/skills/ios/swift-protocol-di-testing/SKILL.md +190 -0
  288. package/skills/ios/swiftui-design-tokens/SKILL.md +475 -0
  289. package/skills/ios/writing-for-interfaces/SKILL.md +75 -0
  290. package/skills/web/accessibility/SKILL.md +146 -0
  291. package/skills/web/aceternity-ui/SKILL.md +719 -0
  292. package/skills/web/aceternity-ui/metadata.json +10 -0
  293. package/skills/web/api-design/SKILL.md +523 -0
  294. package/skills/web/chart-accessibility/SKILL.md +332 -0
  295. package/skills/web/composition-patterns/AGENTS.md +946 -0
  296. package/skills/web/composition-patterns/README.md +60 -0
  297. package/skills/web/composition-patterns/SKILL.md +89 -0
  298. package/skills/web/composition-patterns/metadata.json +11 -0
  299. package/skills/web/composition-patterns/rules/_sections.md +29 -0
  300. package/skills/web/composition-patterns/rules/_template.md +24 -0
  301. package/skills/web/composition-patterns/rules/architecture-avoid-boolean-props.md +100 -0
  302. package/skills/web/composition-patterns/rules/architecture-compound-components.md +112 -0
  303. package/skills/web/composition-patterns/rules/patterns-children-over-render-props.md +87 -0
  304. package/skills/web/composition-patterns/rules/patterns-explicit-variants.md +100 -0
  305. package/skills/web/composition-patterns/rules/react19-no-forwardref.md +42 -0
  306. package/skills/web/composition-patterns/rules/state-context-interface.md +191 -0
  307. package/skills/web/composition-patterns/rules/state-decouple-implementation.md +113 -0
  308. package/skills/web/composition-patterns/rules/state-lift-state.md +125 -0
  309. package/skills/web/cost-aware-llm-pipeline/SKILL.md +183 -0
  310. package/skills/web/database-migrations/SKILL.md +429 -0
  311. package/skills/web/deployment-patterns/SKILL.md +427 -0
  312. package/skills/web/docker-patterns/SKILL.md +364 -0
  313. package/skills/web/e2e-testing/SKILL.md +326 -0
  314. package/skills/web/lighthouse-ci/SKILL.md +361 -0
  315. package/skills/web/mcp-server-patterns/SKILL.md +69 -0
  316. package/skills/web/next-best-practices/SKILL.md +153 -0
  317. package/skills/web/next-best-practices/async-patterns.md +87 -0
  318. package/skills/web/next-best-practices/bundling.md +180 -0
  319. package/skills/web/next-best-practices/data-patterns.md +297 -0
  320. package/skills/web/next-best-practices/debug-tricks.md +105 -0
  321. package/skills/web/next-best-practices/directives.md +73 -0
  322. package/skills/web/next-best-practices/error-handling.md +227 -0
  323. package/skills/web/next-best-practices/file-conventions.md +140 -0
  324. package/skills/web/next-best-practices/font.md +245 -0
  325. package/skills/web/next-best-practices/functions.md +108 -0
  326. package/skills/web/next-best-practices/hydration-error.md +91 -0
  327. package/skills/web/next-best-practices/image.md +173 -0
  328. package/skills/web/next-best-practices/metadata.md +301 -0
  329. package/skills/web/next-best-practices/parallel-routes.md +287 -0
  330. package/skills/web/next-best-practices/route-handlers.md +146 -0
  331. package/skills/web/next-best-practices/rsc-boundaries.md +159 -0
  332. package/skills/web/next-best-practices/runtime-selection.md +39 -0
  333. package/skills/web/next-best-practices/scripts.md +141 -0
  334. package/skills/web/next-best-practices/self-hosting.md +371 -0
  335. package/skills/web/next-best-practices/suspense-boundaries.md +67 -0
  336. package/skills/web/next-cache-components/SKILL.md +411 -0
  337. package/skills/web/postgres-best-practices/SKILL.md +14 -0
  338. package/skills/web/postgres-best-practices/references/schema-design.md +9 -0
  339. package/skills/web/react-best-practices/AGENTS.md +3810 -0
  340. package/skills/web/react-best-practices/README.md +123 -0
  341. package/skills/web/react-best-practices/SKILL.md +149 -0
  342. package/skills/web/react-best-practices/metadata.json +15 -0
  343. package/skills/web/react-best-practices/rules/_sections.md +46 -0
  344. package/skills/web/react-best-practices/rules/_template.md +28 -0
  345. package/skills/web/react-best-practices/rules/advanced-effect-event-deps.md +56 -0
  346. package/skills/web/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  347. package/skills/web/react-best-practices/rules/advanced-init-once.md +42 -0
  348. package/skills/web/react-best-practices/rules/advanced-use-latest.md +39 -0
  349. package/skills/web/react-best-practices/rules/async-api-routes.md +38 -0
  350. package/skills/web/react-best-practices/rules/async-cheap-condition-before-await.md +37 -0
  351. package/skills/web/react-best-practices/rules/async-defer-await.md +82 -0
  352. package/skills/web/react-best-practices/rules/async-dependencies.md +51 -0
  353. package/skills/web/react-best-practices/rules/async-parallel.md +28 -0
  354. package/skills/web/react-best-practices/rules/async-suspense-boundaries.md +99 -0
  355. package/skills/web/react-best-practices/rules/bundle-analyzable-paths.md +63 -0
  356. package/skills/web/react-best-practices/rules/bundle-barrel-imports.md +60 -0
  357. package/skills/web/react-best-practices/rules/bundle-conditional.md +31 -0
  358. package/skills/web/react-best-practices/rules/bundle-defer-third-party.md +49 -0
  359. package/skills/web/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  360. package/skills/web/react-best-practices/rules/bundle-preload.md +50 -0
  361. package/skills/web/react-best-practices/rules/client-event-listeners.md +74 -0
  362. package/skills/web/react-best-practices/rules/client-localstorage-schema.md +71 -0
  363. package/skills/web/react-best-practices/rules/client-passive-event-listeners.md +48 -0
  364. package/skills/web/react-best-practices/rules/client-swr-dedup.md +56 -0
  365. package/skills/web/react-best-practices/rules/js-batch-dom-css.md +107 -0
  366. package/skills/web/react-best-practices/rules/js-cache-function-results.md +80 -0
  367. package/skills/web/react-best-practices/rules/js-cache-property-access.md +28 -0
  368. package/skills/web/react-best-practices/rules/js-cache-storage.md +70 -0
  369. package/skills/web/react-best-practices/rules/js-combine-iterations.md +32 -0
  370. package/skills/web/react-best-practices/rules/js-early-exit.md +50 -0
  371. package/skills/web/react-best-practices/rules/js-flatmap-filter.md +60 -0
  372. package/skills/web/react-best-practices/rules/js-hoist-regexp.md +45 -0
  373. package/skills/web/react-best-practices/rules/js-index-maps.md +37 -0
  374. package/skills/web/react-best-practices/rules/js-length-check-first.md +49 -0
  375. package/skills/web/react-best-practices/rules/js-min-max-loop.md +82 -0
  376. package/skills/web/react-best-practices/rules/js-request-idle-callback.md +105 -0
  377. package/skills/web/react-best-practices/rules/js-set-map-lookups.md +24 -0
  378. package/skills/web/react-best-practices/rules/js-tosorted-immutable.md +57 -0
  379. package/skills/web/react-best-practices/rules/rendering-activity.md +26 -0
  380. package/skills/web/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  381. package/skills/web/react-best-practices/rules/rendering-conditional-render.md +40 -0
  382. package/skills/web/react-best-practices/rules/rendering-content-visibility.md +38 -0
  383. package/skills/web/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  384. package/skills/web/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  385. package/skills/web/react-best-practices/rules/rendering-hydration-suppress-warning.md +30 -0
  386. package/skills/web/react-best-practices/rules/rendering-resource-hints.md +85 -0
  387. package/skills/web/react-best-practices/rules/rendering-script-defer-async.md +68 -0
  388. package/skills/web/react-best-practices/rules/rendering-svg-precision.md +28 -0
  389. package/skills/web/react-best-practices/rules/rendering-usetransition-loading.md +75 -0
  390. package/skills/web/react-best-practices/rules/rerender-defer-reads.md +39 -0
  391. package/skills/web/react-best-practices/rules/rerender-dependencies.md +45 -0
  392. package/skills/web/react-best-practices/rules/rerender-derived-state-no-effect.md +40 -0
  393. package/skills/web/react-best-practices/rules/rerender-derived-state.md +29 -0
  394. package/skills/web/react-best-practices/rules/rerender-functional-setstate.md +74 -0
  395. package/skills/web/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  396. package/skills/web/react-best-practices/rules/rerender-memo-with-default-value.md +38 -0
  397. package/skills/web/react-best-practices/rules/rerender-memo.md +44 -0
  398. package/skills/web/react-best-practices/rules/rerender-move-effect-to-event.md +45 -0
  399. package/skills/web/react-best-practices/rules/rerender-no-inline-components.md +82 -0
  400. package/skills/web/react-best-practices/rules/rerender-simple-expression-in-memo.md +35 -0
  401. package/skills/web/react-best-practices/rules/rerender-split-combined-hooks.md +64 -0
  402. package/skills/web/react-best-practices/rules/rerender-transitions.md +40 -0
  403. package/skills/web/react-best-practices/rules/rerender-use-deferred-value.md +59 -0
  404. package/skills/web/react-best-practices/rules/rerender-use-ref-transient-values.md +73 -0
  405. package/skills/web/react-best-practices/rules/server-after-nonblocking.md +73 -0
  406. package/skills/web/react-best-practices/rules/server-auth-actions.md +96 -0
  407. package/skills/web/react-best-practices/rules/server-cache-lru.md +41 -0
  408. package/skills/web/react-best-practices/rules/server-cache-react.md +76 -0
  409. package/skills/web/react-best-practices/rules/server-dedup-props.md +65 -0
  410. package/skills/web/react-best-practices/rules/server-hoist-static-io.md +149 -0
  411. package/skills/web/react-best-practices/rules/server-no-shared-module-state.md +50 -0
  412. package/skills/web/react-best-practices/rules/server-parallel-fetching.md +83 -0
  413. package/skills/web/react-best-practices/rules/server-parallel-nested-fetching.md +34 -0
  414. package/skills/web/react-best-practices/rules/server-serialization.md +38 -0
  415. package/skills/web/seo/SKILL.md +154 -0
  416. package/skills/web/web-design-guidelines/SKILL.md +39 -0
  417. package/skills/web/zap-scan-config/SKILL.md +444 -0
  418. package/skills/web/zap-scan-config/assets/.gitkeep +9 -0
  419. package/skills/web/zap-scan-config/assets/github_action.yml +207 -0
  420. package/skills/web/zap-scan-config/assets/gitlab_ci.yml +226 -0
  421. package/skills/web/zap-scan-config/assets/zap_automation.yaml +196 -0
  422. package/skills/web/zap-scan-config/assets/zap_context.xml +192 -0
  423. package/skills/web/zap-scan-config/references/EXAMPLE.md +40 -0
  424. package/skills/web/zap-scan-config/references/api_testing_guide.md +475 -0
  425. package/skills/web/zap-scan-config/references/authentication_guide.md +431 -0
  426. package/skills/web/zap-scan-config/references/false_positive_handling.md +427 -0
  427. package/skills/web/zap-scan-config/references/owasp_mapping.md +255 -0
  428. package/src/graph/ids.ts +86 -0
  429. package/src/graph/index.ts +32 -0
  430. package/src/graph/parser/architecture.ts +603 -0
  431. package/src/graph/parser/component-manifest.ts +268 -0
  432. package/src/graph/parser/decisions-jsonl.ts +407 -0
  433. package/src/graph/parser/design-md-pass2.ts +253 -0
  434. package/src/graph/parser/design-md.ts +477 -0
  435. package/src/graph/parser/page-spec.ts +496 -0
  436. package/src/graph/parser/product-spec.ts +930 -0
  437. package/src/graph/parser/screenshot.ts +342 -0
  438. package/src/graph/parser/sprint-tasks.ts +317 -0
  439. package/src/graph/storage/index.ts +1154 -0
  440. package/src/graph/types.ts +432 -0
  441. package/src/graph/util/dhash.ts +84 -0
  442. package/src/lrr/aggregator.ts +175 -0
  443. package/src/orchestrator/hooks/context-header.ts +119 -0
  444. package/src/orchestrator/hooks/token-accounting-emitter.ts +77 -0
  445. package/src/orchestrator/hooks/token-accounting.ts +112 -0
  446. package/src/orchestrator/mcp/cycle-counter.ts +130 -0
  447. package/src/orchestrator/mcp/scribe.ts +294 -0
  448. package/src/orchestrator/mcp/state-save.ts +149 -0
  449. package/src/orchestrator/mcp/write-lease.ts +184 -0
  450. package/src/orchestrator/phase4-shared-context.ts +57 -0
  451. package/src/orchestrator/schemas/backward-edge.ts +46 -0
  452. package/agents/agentic-identity-trust.md +0 -121
  453. package/agents/data-consolidation-agent.md +0 -39
  454. package/agents/design-image-prompt-engineer.md +0 -105
  455. package/agents/design-visual-storyteller.md +0 -147
  456. package/agents/design-whimsy-injector.md +0 -89
  457. package/agents/engineering-autonomous-optimization-architect.md +0 -105
  458. package/agents/market-intel.md +0 -35
  459. package/agents/marketing-instagram-curator.md +0 -111
  460. package/agents/marketing-reddit-community-builder.md +0 -121
  461. package/agents/marketing-social-media-strategist.md +0 -74
  462. package/agents/marketing-tiktok-strategist.md +0 -123
  463. package/agents/marketing-twitter-engager.md +0 -124
  464. package/agents/marketing-wechat-official-account.md +0 -143
  465. package/agents/marketing-xiaohongshu-specialist.md +0 -136
  466. package/agents/marketing-zhihu-strategist.md +0 -160
  467. package/agents/product-behavioral-nudge-engine.md +0 -78
  468. package/agents/project-management-experiment-tracker.md +0 -102
  469. package/agents/report-distribution-agent.md +0 -43
  470. package/agents/risk-analysis.md +0 -45
  471. package/agents/sales-data-extraction-agent.md +0 -46
  472. package/agents/specialized-cultural-intelligence-strategist.md +0 -65
  473. package/agents/specialized-developer-advocate.md +0 -146
  474. package/agents/support-analytics-reporter.md +0 -133
  475. package/agents/support-executive-summary-generator.md +0 -64
  476. package/agents/support-finance-tracker.md +0 -145
  477. package/agents/support-legal-compliance-checker.md +0 -129
  478. package/agents/support-support-responder.md +0 -91
  479. package/agents/testing-accessibility-auditor.md +0 -110
  480. package/agents/testing-test-results-analyzer.md +0 -97
  481. package/agents/testing-tool-evaluator.md +0 -76
  482. package/agents/testing-workflow-optimizer.md +0 -99
  483. package/agents/user-research.md +0 -40
  484. package/protocols/brainstorm.md +0 -99
  485. package/protocols/design.md +0 -269
  486. package/protocols/planning.md +0 -87
  487. package/skills/ios/ios-hig/SKILL.md +0 -41
  488. package/skills/ios/ios-hig/references/accessibility.md +0 -81
  489. package/skills/ios/ios-hig/references/content.md +0 -142
  490. package/skills/ios/ios-hig/references/feedback.md +0 -123
  491. package/skills/ios/ios-hig/references/interaction.md +0 -199
  492. package/skills/ios/ios-hig/references/performance-platform.md +0 -129
  493. package/skills/ios/ios-hig/references/privacy-permissions.md +0 -181
  494. package/skills/ios/ios-hig/references/visual-design.md +0 -84
package/skills/web/react-best-practices/rules/rendering-resource-hints.md ADDED
@@ -0,0 +1,85 @@
1
+ ---
2
+ title: Use React DOM Resource Hints
3
+ impact: HIGH
4
+ impactDescription: reduces load time for critical resources
5
+ tags: rendering, preload, preconnect, prefetch, resource-hints
6
+ ---
7
+
8
+ ## Use React DOM Resource Hints
9
+
10
+ **Impact: HIGH (reduces load time for critical resources)**
11
+
12
+ React DOM provides APIs to hint the browser about resources it will need. These are especially useful in server components to start loading resources before the client even receives the HTML.
13
+
14
+ - **`prefetchDNS(href)`**: Resolve DNS for a domain you expect to connect to
15
+ - **`preconnect(href)`**: Establish connection (DNS + TCP + TLS) to a server
16
+ - **`preload(href, options)`**: Fetch a resource (stylesheet, font, script, image) you'll use soon
17
+ - **`preloadModule(href)`**: Fetch an ES module you'll use soon
18
+ - **`preinit(href, options)`**: Fetch and evaluate a stylesheet or script
19
+ - **`preinitModule(href)`**: Fetch and evaluate an ES module
20
+
21
+ **Example (preconnect to third-party APIs):**
22
+
23
+ ```tsx
24
+ import { preconnect, prefetchDNS } from 'react-dom'
25
+
26
+ export default function App() {
27
+ prefetchDNS('https://analytics.example.com')
28
+ preconnect('https://api.example.com')
29
+
30
+ return <main>{/* content */}</main>
31
+ }
32
+ ```
33
+
34
+ **Example (preload critical fonts and styles):**
35
+
36
+ ```tsx
37
+ import { preload, preinit } from 'react-dom'
38
+
39
+ export default function RootLayout({ children }) {
40
+ // Preload font file
41
+ preload('/fonts/inter.woff2', { as: 'font', type: 'font/woff2', crossOrigin: 'anonymous' })
42
+
43
+ // Fetch and apply critical stylesheet immediately
44
+ preinit('/styles/critical.css', { as: 'style' })
45
+
46
+ return (
47
+ <html>
48
+ <body>{children}</body>
49
+ </html>
50
+ )
51
+ }
52
+ ```
53
+
54
+ **Example (preload modules for code-split routes):**
55
+
56
+ ```tsx
57
+ import { preloadModule, preinitModule } from 'react-dom'
58
+
59
+ function Navigation() {
60
+ const preloadDashboard = () => {
61
+ preloadModule('/dashboard.js', { as: 'script' })
62
+ }
63
+
64
+ return (
65
+ <nav>
66
+ <a href="/dashboard" onMouseEnter={preloadDashboard}>
67
+ Dashboard
68
+ </a>
69
+ </nav>
70
+ )
71
+ }
72
+ ```
73
+
74
+ **When to use each:**
75
+
76
+ | API | Use case |
77
+ |-----|----------|
78
+ | `prefetchDNS` | Third-party domains you'll connect to later |
79
+ | `preconnect` | APIs or CDNs you'll fetch from immediately |
80
+ | `preload` | Critical resources needed for current page |
81
+ | `preloadModule` | JS modules for likely next navigation |
82
+ | `preinit` | Stylesheets/scripts that must execute early |
83
+ | `preinitModule` | ES modules that must execute early |
84
+
85
+ Reference: [React DOM Resource Preloading APIs](https://react.dev/reference/react-dom#resource-preloading-apis)
package/skills/web/react-best-practices/rules/rendering-script-defer-async.md ADDED
@@ -0,0 +1,68 @@
1
+ ---
2
+ title: Use defer or async on Script Tags
3
+ impact: HIGH
4
+ impactDescription: eliminates render-blocking
5
+ tags: rendering, script, defer, async, performance
6
+ ---
7
+
8
+ ## Use defer or async on Script Tags
9
+
10
+ **Impact: HIGH (eliminates render-blocking)**
11
+
12
+ Script tags without `defer` or `async` block HTML parsing while the script downloads and executes. This delays First Contentful Paint and Time to Interactive.
13
+
14
+ - **`defer`**: Downloads in parallel, executes after HTML parsing completes, maintains execution order
15
+ - **`async`**: Downloads in parallel, executes immediately when ready, no guaranteed order
16
+
17
+ Use `defer` for scripts that depend on DOM or other scripts. Use `async` for independent scripts like analytics.
18
+
19
+ **Incorrect (blocks rendering):**
20
+
21
+ ```tsx
22
+ export default function Document() {
23
+ return (
24
+ <html>
25
+ <head>
26
+ <script src="https://example.com/analytics.js" />
27
+ <script src="/scripts/utils.js" />
28
+ </head>
29
+ <body>{/* content */}</body>
30
+ </html>
31
+ )
32
+ }
33
+ ```
34
+
35
+ **Correct (non-blocking):**
36
+
37
+ ```tsx
38
+ export default function Document() {
39
+ return (
40
+ <html>
41
+ <head>
42
+ {/* Independent script - use async */}
43
+ <script src="https://example.com/analytics.js" async />
44
+ {/* DOM-dependent script - use defer */}
45
+ <script src="/scripts/utils.js" defer />
46
+ </head>
47
+ <body>{/* content */}</body>
48
+ </html>
49
+ )
50
+ }
51
+ ```
52
+
53
+ **Note:** In Next.js, prefer the `next/script` component with `strategy` prop instead of raw script tags:
54
+
55
+ ```tsx
56
+ import Script from 'next/script'
57
+
58
+ export default function Page() {
59
+ return (
60
+ <>
61
+ <Script src="https://example.com/analytics.js" strategy="afterInteractive" />
62
+ <Script src="/scripts/utils.js" strategy="beforeInteractive" />
63
+ </>
64
+ )
65
+ }
66
+ ```
67
+
68
+ Reference: [MDN - Script element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script#defer)
package/skills/web/react-best-practices/rules/rendering-svg-precision.md ADDED
@@ -0,0 +1,28 @@
1
+ ---
2
+ title: Optimize SVG Precision
3
+ impact: LOW
4
+ impactDescription: reduces file size
5
+ tags: rendering, svg, optimization, svgo
6
+ ---
7
+
8
+ ## Optimize SVG Precision
9
+
10
+ Reduce SVG coordinate precision to decrease file size. The optimal precision depends on the viewBox size, but in general reducing precision should be considered.
11
+
12
+ **Incorrect (excessive precision):**
13
+
14
+ ```svg
15
+ <path d="M 10.293847 20.847362 L 30.938472 40.192837" />
16
+ ```
17
+
18
+ **Correct (1 decimal place):**
19
+
20
+ ```svg
21
+ <path d="M 10.3 20.8 L 30.9 40.2" />
22
+ ```
23
+
24
+ **Automate with SVGO:**
25
+
26
+ ```bash
27
+ npx svgo --precision=1 --multipass icon.svg
28
+ ```
package/skills/web/react-best-practices/rules/rendering-usetransition-loading.md ADDED
@@ -0,0 +1,75 @@
1
+ ---
2
+ title: Use useTransition Over Manual Loading States
3
+ impact: LOW
4
+ impactDescription: reduces re-renders and improves code clarity
5
+ tags: rendering, transitions, useTransition, loading, state
6
+ ---
7
+
8
+ ## Use useTransition Over Manual Loading States
9
+
10
+ Use `useTransition` instead of manual `useState` for loading states. This provides built-in `isPending` state and automatically manages transitions.
11
+
12
+ **Incorrect (manual loading state):**
13
+
14
+ ```tsx
15
+ function SearchResults() {
16
+ const [query, setQuery] = useState('')
17
+ const [results, setResults] = useState([])
18
+ const [isLoading, setIsLoading] = useState(false)
19
+
20
+ const handleSearch = async (value: string) => {
21
+ setIsLoading(true)
22
+ setQuery(value)
23
+ const data = await fetchResults(value)
24
+ setResults(data)
25
+ setIsLoading(false)
26
+ }
27
+
28
+ return (
29
+ <>
30
+ <input onChange={(e) => handleSearch(e.target.value)} />
31
+ {isLoading && <Spinner />}
32
+ <ResultsList results={results} />
33
+ </>
34
+ )
35
+ }
36
+ ```
37
+
38
+ **Correct (useTransition with built-in pending state):**
39
+
40
+ ```tsx
41
+ import { useTransition, useState } from 'react'
42
+
43
+ function SearchResults() {
44
+ const [query, setQuery] = useState('')
45
+ const [results, setResults] = useState([])
46
+ const [isPending, startTransition] = useTransition()
47
+
48
+ const handleSearch = (value: string) => {
49
+ setQuery(value) // Update input immediately
50
+
51
+ startTransition(async () => {
52
+ // Fetch and update results
53
+ const data = await fetchResults(value)
54
+ setResults(data)
55
+ })
56
+ }
57
+
58
+ return (
59
+ <>
60
+ <input onChange={(e) => handleSearch(e.target.value)} />
61
+ {isPending && <Spinner />}
62
+ <ResultsList results={results} />
63
+ </>
64
+ )
65
+ }
66
+ ```
67
+
68
+ **Benefits:**
69
+
70
+ - **Automatic pending state**: No need to manually manage `setIsLoading(true/false)`
71
+ - **Error resilience**: Pending state correctly resets even if the transition throws
72
+ - **Better responsiveness**: Keeps the UI responsive during updates
73
+ - **Interrupt handling**: New transitions automatically cancel pending ones
74
+
75
+ Reference: [useTransition](https://react.dev/reference/react/useTransition)
package/skills/web/react-best-practices/rules/rerender-defer-reads.md ADDED
@@ -0,0 +1,39 @@
1
+ ---
2
+ title: Defer State Reads to Usage Point
3
+ impact: MEDIUM
4
+ impactDescription: avoids unnecessary subscriptions
5
+ tags: rerender, searchParams, localStorage, optimization
6
+ ---
7
+
8
+ ## Defer State Reads to Usage Point
9
+
10
+ Don't subscribe to dynamic state (searchParams, localStorage) if you only read it inside callbacks.
11
+
12
+ **Incorrect (subscribes to all searchParams changes):**
13
+
14
+ ```tsx
15
+ function ShareButton({ chatId }: { chatId: string }) {
16
+ const searchParams = useSearchParams()
17
+
18
+ const handleShare = () => {
19
+ const ref = searchParams.get('ref')
20
+ shareChat(chatId, { ref })
21
+ }
22
+
23
+ return <button onClick={handleShare}>Share</button>
24
+ }
25
+ ```
26
+
27
+ **Correct (reads on demand, no subscription):**
28
+
29
+ ```tsx
30
+ function ShareButton({ chatId }: { chatId: string }) {
31
+ const handleShare = () => {
32
+ const params = new URLSearchParams(window.location.search)
33
+ const ref = params.get('ref')
34
+ shareChat(chatId, { ref })
35
+ }
36
+
37
+ return <button onClick={handleShare}>Share</button>
38
+ }
39
+ ```
package/skills/web/react-best-practices/rules/rerender-dependencies.md ADDED
@@ -0,0 +1,45 @@
1
+ ---
2
+ title: Narrow Effect Dependencies
3
+ impact: LOW
4
+ impactDescription: minimizes effect re-runs
5
+ tags: rerender, useEffect, dependencies, optimization
6
+ ---
7
+
8
+ ## Narrow Effect Dependencies
9
+
10
+ Specify primitive dependencies instead of objects to minimize effect re-runs.
11
+
12
+ **Incorrect (re-runs on any user field change):**
13
+
14
+ ```tsx
15
+ useEffect(() => {
16
+ console.log(user.id)
17
+ }, [user])
18
+ ```
19
+
20
+ **Correct (re-runs only when id changes):**
21
+
22
+ ```tsx
23
+ useEffect(() => {
24
+ console.log(user.id)
25
+ }, [user.id])
26
+ ```
27
+
28
+ **For derived state, compute outside effect:**
29
+
30
+ ```tsx
31
+ // Incorrect: runs on width=767, 766, 765...
32
+ useEffect(() => {
33
+ if (width < 768) {
34
+ enableMobileMode()
35
+ }
36
+ }, [width])
37
+
38
+ // Correct: runs only on boolean transition
39
+ const isMobile = width < 768
40
+ useEffect(() => {
41
+ if (isMobile) {
42
+ enableMobileMode()
43
+ }
44
+ }, [isMobile])
45
+ ```
package/skills/web/react-best-practices/rules/rerender-derived-state-no-effect.md ADDED
@@ -0,0 +1,40 @@
1
+ ---
2
+ title: Calculate Derived State During Rendering
3
+ impact: MEDIUM
4
+ impactDescription: avoids redundant renders and state drift
5
+ tags: rerender, derived-state, useEffect, state
6
+ ---
7
+
8
+ ## Calculate Derived State During Rendering
9
+
10
+ If a value can be computed from current props/state, do not store it in state or update it in an effect. Derive it during render to avoid extra renders and state drift. Do not set state in effects solely in response to prop changes; prefer derived values or keyed resets instead.
11
+
12
+ **Incorrect (redundant state and effect):**
13
+
14
+ ```tsx
15
+ function Form() {
16
+ const [firstName, setFirstName] = useState('First')
17
+ const [lastName, setLastName] = useState('Last')
18
+ const [fullName, setFullName] = useState('')
19
+
20
+ useEffect(() => {
21
+ setFullName(firstName + ' ' + lastName)
22
+ }, [firstName, lastName])
23
+
24
+ return <p>{fullName}</p>
25
+ }
26
+ ```
27
+
28
+ **Correct (derive during render):**
29
+
30
+ ```tsx
31
+ function Form() {
32
+ const [firstName, setFirstName] = useState('First')
33
+ const [lastName, setLastName] = useState('Last')
34
+ const fullName = firstName + ' ' + lastName
35
+
36
+ return <p>{fullName}</p>
37
+ }
38
+ ```
39
+
40
+ References: [You Might Not Need an Effect](https://react.dev/learn/you-might-not-need-an-effect)
package/skills/web/react-best-practices/rules/rerender-derived-state.md ADDED
@@ -0,0 +1,29 @@
1
+ ---
2
+ title: Subscribe to Derived State
3
+ impact: MEDIUM
4
+ impactDescription: reduces re-render frequency
5
+ tags: rerender, derived-state, media-query, optimization
6
+ ---
7
+
8
+ ## Subscribe to Derived State
9
+
10
+ Subscribe to derived boolean state instead of continuous values to reduce re-render frequency.
11
+
12
+ **Incorrect (re-renders on every pixel change):**
13
+
14
+ ```tsx
15
+ function Sidebar() {
16
+ const width = useWindowWidth() // updates continuously
17
+ const isMobile = width < 768
18
+ return <nav className={isMobile ? 'mobile' : 'desktop'} />
19
+ }
20
+ ```
21
+
22
+ **Correct (re-renders only when boolean changes):**
23
+
24
+ ```tsx
25
+ function Sidebar() {
26
+ const isMobile = useMediaQuery('(max-width: 767px)')
27
+ return <nav className={isMobile ? 'mobile' : 'desktop'} />
28
+ }
29
+ ```
package/skills/web/react-best-practices/rules/rerender-functional-setstate.md ADDED
@@ -0,0 +1,74 @@
1
+ ---
2
+ title: Use Functional setState Updates
3
+ impact: MEDIUM
4
+ impactDescription: prevents stale closures and unnecessary callback recreations
5
+ tags: react, hooks, useState, useCallback, callbacks, closures
6
+ ---
7
+
8
+ ## Use Functional setState Updates
9
+
10
+ When updating state based on the current state value, use the functional update form of setState instead of directly referencing the state variable. This prevents stale closures, eliminates unnecessary dependencies, and creates stable callback references.
11
+
12
+ **Incorrect (requires state as dependency):**
13
+
14
+ ```tsx
15
+ function TodoList() {
16
+ const [items, setItems] = useState(initialItems)
17
+
18
+ // Callback must depend on items, recreated on every items change
19
+ const addItems = useCallback((newItems: Item[]) => {
20
+ setItems([...items, ...newItems])
21
+ }, [items]) // ❌ items dependency causes recreations
22
+
23
+ // Risk of stale closure if dependency is forgotten
24
+ const removeItem = useCallback((id: string) => {
25
+ setItems(items.filter(item => item.id !== id))
26
+ }, []) // ❌ Missing items dependency - will use stale items!
27
+
28
+ return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
29
+ }
30
+ ```
31
+
32
+ The first callback is recreated every time `items` changes, which can cause child components to re-render unnecessarily. The second callback has a stale closure bug—it will always reference the initial `items` value.
33
+
34
+ **Correct (stable callbacks, no stale closures):**
35
+
36
+ ```tsx
37
+ function TodoList() {
38
+ const [items, setItems] = useState(initialItems)
39
+
40
+ // Stable callback, never recreated
41
+ const addItems = useCallback((newItems: Item[]) => {
42
+ setItems(curr => [...curr, ...newItems])
43
+ }, []) // ✅ No dependencies needed
44
+
45
+ // Always uses latest state, no stale closure risk
46
+ const removeItem = useCallback((id: string) => {
47
+ setItems(curr => curr.filter(item => item.id !== id))
48
+ }, []) // ✅ Safe and stable
49
+
50
+ return <ItemsEditor items={items} onAdd={addItems} onRemove={removeItem} />
51
+ }
52
+ ```
53
+
54
+ **Benefits:**
55
+
56
+ 1. **Stable callback references** - Callbacks don't need to be recreated when state changes
57
+ 2. **No stale closures** - Always operates on the latest state value
58
+ 3. **Fewer dependencies** - Simplifies dependency arrays and reduces memory leaks
59
+ 4. **Prevents bugs** - Eliminates the most common source of React closure bugs
60
+
61
+ **When to use functional updates:**
62
+
63
+ - Any setState that depends on the current state value
64
+ - Inside useCallback/useMemo when state is needed
65
+ - Event handlers that reference state
66
+ - Async operations that update state
67
+
68
+ **When direct updates are fine:**
69
+
70
+ - Setting state to a static value: `setCount(0)`
71
+ - Setting state from props/arguments only: `setName(newName)`
72
+ - State doesn't depend on previous value
73
+
74
+ **Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, the compiler can automatically optimize some cases, but functional updates are still recommended for correctness and to prevent stale closure bugs.
package/skills/web/react-best-practices/rules/rerender-lazy-state-init.md ADDED
@@ -0,0 +1,58 @@
1
+ ---
2
+ title: Use Lazy State Initialization
3
+ impact: MEDIUM
4
+ impactDescription: wasted computation on every render
5
+ tags: react, hooks, useState, performance, initialization
6
+ ---
7
+
8
+ ## Use Lazy State Initialization
9
+
10
+ Pass a function to `useState` for expensive initial values. Without the function form, the initializer runs on every render even though the value is only used once.
11
+
12
+ **Incorrect (runs on every render):**
13
+
14
+ ```tsx
15
+ function FilteredList({ items }: { items: Item[] }) {
16
+ // buildSearchIndex() runs on EVERY render, even after initialization
17
+ const [searchIndex, setSearchIndex] = useState(buildSearchIndex(items))
18
+ const [query, setQuery] = useState('')
19
+
20
+ // When query changes, buildSearchIndex runs again unnecessarily
21
+ return <SearchResults index={searchIndex} query={query} />
22
+ }
23
+
24
+ function UserProfile() {
25
+ // JSON.parse runs on every render
26
+ const [settings, setSettings] = useState(
27
+ JSON.parse(localStorage.getItem('settings') || '{}')
28
+ )
29
+
30
+ return <SettingsForm settings={settings} onChange={setSettings} />
31
+ }
32
+ ```
33
+
34
+ **Correct (runs only once):**
35
+
36
+ ```tsx
37
+ function FilteredList({ items }: { items: Item[] }) {
38
+ // buildSearchIndex() runs ONLY on initial render
39
+ const [searchIndex, setSearchIndex] = useState(() => buildSearchIndex(items))
40
+ const [query, setQuery] = useState('')
41
+
42
+ return <SearchResults index={searchIndex} query={query} />
43
+ }
44
+
45
+ function UserProfile() {
46
+ // JSON.parse runs only on initial render
47
+ const [settings, setSettings] = useState(() => {
48
+ const stored = localStorage.getItem('settings')
49
+ return stored ? JSON.parse(stored) : {}
50
+ })
51
+
52
+ return <SettingsForm settings={settings} onChange={setSettings} />
53
+ }
54
+ ```
55
+
56
+ Use lazy initialization when computing initial values from localStorage/sessionStorage, building data structures (indexes, maps), reading from the DOM, or performing heavy transformations.
57
+
58
+ For simple primitives (`useState(0)`), direct references (`useState(props.value)`), or cheap literals (`useState({})`), the function form is unnecessary.
package/skills/web/react-best-practices/rules/rerender-memo-with-default-value.md ADDED
@@ -0,0 +1,38 @@
1
+ ---
2
+
3
+ title: Extract Default Non-primitive Parameter Value from Memoized Component to Constant
4
+ impact: MEDIUM
5
+ impactDescription: restores memoization by using a constant for default value
6
+ tags: rerender, memo, optimization
7
+
8
+ ---
9
+
10
+ ## Extract Default Non-primitive Parameter Value from Memoized Component to Constant
11
+
12
+ When memoized component has a default value for some non-primitive optional parameter, such as an array, function, or object, calling the component without that parameter results in broken memoization. This is because new value instances are created on every rerender, and they do not pass strict equality comparison in `memo()`.
13
+
14
+ To address this issue, extract the default value into a constant.
15
+
16
+ **Incorrect (`onClick` has different values on every rerender):**
17
+
18
+ ```tsx
19
+ const UserAvatar = memo(function UserAvatar({ onClick = () => {} }: { onClick?: () => void }) {
20
+ // ...
21
+ })
22
+
23
+ // Used without optional onClick
24
+ <UserAvatar />
25
+ ```
26
+
27
+ **Correct (stable default value):**
28
+
29
+ ```tsx
30
+ const NOOP = () => {};
31
+
32
+ const UserAvatar = memo(function UserAvatar({ onClick = NOOP }: { onClick?: () => void }) {
33
+ // ...
34
+ })
35
+
36
+ // Used without optional onClick
37
+ <UserAvatar />
38
+ ```
package/skills/web/react-best-practices/rules/rerender-memo.md ADDED
@@ -0,0 +1,44 @@
1
+ ---
2
+ title: Extract to Memoized Components
3
+ impact: MEDIUM
4
+ impactDescription: enables early returns
5
+ tags: rerender, memo, useMemo, optimization
6
+ ---
7
+
8
+ ## Extract to Memoized Components
9
+
10
+ Extract expensive work into memoized components to enable early returns before computation.
11
+
12
+ **Incorrect (computes avatar even when loading):**
13
+
14
+ ```tsx
15
+ function Profile({ user, loading }: Props) {
16
+ const avatar = useMemo(() => {
17
+ const id = computeAvatarId(user)
18
+ return <Avatar id={id} />
19
+ }, [user])
20
+
21
+ if (loading) return <Skeleton />
22
+ return <div>{avatar}</div>
23
+ }
24
+ ```
25
+
26
+ **Correct (skips computation when loading):**
27
+
28
+ ```tsx
29
+ const UserAvatar = memo(function UserAvatar({ user }: { user: User }) {
30
+ const id = useMemo(() => computeAvatarId(user), [user])
31
+ return <Avatar id={id} />
32
+ })
33
+
34
+ function Profile({ user, loading }: Props) {
35
+ if (loading) return <Skeleton />
36
+ return (
37
+ <div>
38
+ <UserAvatar user={user} />
39
+ </div>
40
+ )
41
+ }
42
+ ```
43
+
44
+ **Note:** If your project has [React Compiler](https://react.dev/learn/react-compiler) enabled, manual memoization with `memo()` and `useMemo()` is not necessary. The compiler automatically optimizes re-renders.
package/skills/web/react-best-practices/rules/rerender-move-effect-to-event.md ADDED
@@ -0,0 +1,45 @@
1
+ ---
2
+ title: Put Interaction Logic in Event Handlers
3
+ impact: MEDIUM
4
+ impactDescription: avoids effect re-runs and duplicate side effects
5
+ tags: rerender, useEffect, events, side-effects, dependencies
6
+ ---
7
+
8
+ ## Put Interaction Logic in Event Handlers
9
+
10
+ If a side effect is triggered by a specific user action (submit, click, drag), run it in that event handler. Do not model the action as state + effect; it makes effects re-run on unrelated changes and can duplicate the action.
11
+
12
+ **Incorrect (event modeled as state + effect):**
13
+
14
+ ```tsx
15
+ function Form() {
16
+ const [submitted, setSubmitted] = useState(false)
17
+ const theme = useContext(ThemeContext)
18
+
19
+ useEffect(() => {
20
+ if (submitted) {
21
+ post('/api/register')
22
+ showToast('Registered', theme)
23
+ }
24
+ }, [submitted, theme])
25
+
26
+ return <button onClick={() => setSubmitted(true)}>Submit</button>
27
+ }
28
+ ```
29
+
30
+ **Correct (do it in the handler):**
31
+
32
+ ```tsx
33
+ function Form() {
34
+ const theme = useContext(ThemeContext)
35
+
36
+ function handleSubmit() {
37
+ post('/api/register')
38
+ showToast('Registered', theme)
39
+ }
40
+
41
+ return <button onClick={handleSubmit}>Submit</button>
42
+ }
43
+ ```
44
+
45
+ Reference: [Should this code move to an event handler?](https://react.dev/learn/removing-effect-dependencies#should-this-code-move-to-an-event-handler)