thachvd-kit 1.0.28 → 1.0.30

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 (396) hide show
  1. package/README.md +50 -148
  2. package/bin/cli.js +439 -293
  3. package/package.json +1 -9
  4. package/.agent/agents/backend-specialist.md +0 -263
  5. package/.agent/agents/code-archaeologist.md +0 -106
  6. package/.agent/agents/database-architect.md +0 -226
  7. package/.agent/agents/debugger.md +0 -225
  8. package/.agent/agents/devops-engineer.md +0 -242
  9. package/.agent/agents/documentation-writer.md +0 -104
  10. package/.agent/agents/explorer-agent.md +0 -73
  11. package/.agent/agents/frontend-specialist.md +0 -593
  12. package/.agent/agents/game-developer.md +0 -162
  13. package/.agent/agents/mobile-developer.md +0 -377
  14. package/.agent/agents/orchestrator.md +0 -416
  15. package/.agent/agents/penetration-tester.md +0 -188
  16. package/.agent/agents/performance-optimizer.md +0 -187
  17. package/.agent/agents/product-manager.md +0 -112
  18. package/.agent/agents/product-owner.md +0 -95
  19. package/.agent/agents/project-planner.md +0 -406
  20. package/.agent/agents/qa-automation-engineer.md +0 -103
  21. package/.agent/agents/security-auditor.md +0 -170
  22. package/.agent/agents/seo-specialist.md +0 -111
  23. package/.agent/agents/test-engineer.md +0 -158
  24. package/.agent/docs/architecture.md +0 -15
  25. package/.agent/docs/conventions.md +0 -16
  26. package/.agent/docs/getting-started.md +0 -92
  27. package/.agent/docs/project.md +0 -59
  28. package/.agent/docs/tooling.md +0 -136
  29. package/.agent/docs/workflow.md +0 -78
  30. package/.agent/rules/GEMINI.md +0 -61
  31. package/.agent/skills/api-design/SKILL.md +0 -156
  32. package/.agent/skills/api-patterns/SKILL.md +0 -81
  33. package/.agent/skills/api-patterns/api-style.md +0 -42
  34. package/.agent/skills/api-patterns/auth.md +0 -24
  35. package/.agent/skills/api-patterns/documentation.md +0 -26
  36. package/.agent/skills/api-patterns/graphql.md +0 -41
  37. package/.agent/skills/api-patterns/rate-limiting.md +0 -31
  38. package/.agent/skills/api-patterns/response.md +0 -37
  39. package/.agent/skills/api-patterns/rest.md +0 -40
  40. package/.agent/skills/api-patterns/scripts/api_validator.py +0 -211
  41. package/.agent/skills/api-patterns/security-testing.md +0 -122
  42. package/.agent/skills/api-patterns/trpc.md +0 -41
  43. package/.agent/skills/api-patterns/versioning.md +0 -22
  44. package/.agent/skills/app-builder/SKILL.md +0 -75
  45. package/.agent/skills/app-builder/agent-coordination.md +0 -71
  46. package/.agent/skills/app-builder/feature-building.md +0 -53
  47. package/.agent/skills/app-builder/project-detection.md +0 -34
  48. package/.agent/skills/app-builder/scaffolding.md +0 -118
  49. package/.agent/skills/app-builder/tech-stack.md +0 -40
  50. package/.agent/skills/app-builder/templates/SKILL.md +0 -39
  51. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +0 -76
  52. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +0 -92
  53. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +0 -88
  54. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +0 -88
  55. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +0 -83
  56. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +0 -90
  57. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +0 -90
  58. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +0 -122
  59. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +0 -122
  60. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +0 -169
  61. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +0 -134
  62. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +0 -83
  63. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +0 -119
  64. package/.agent/skills/architecture/SKILL.md +0 -55
  65. package/.agent/skills/architecture/context-discovery.md +0 -43
  66. package/.agent/skills/architecture/examples.md +0 -94
  67. package/.agent/skills/architecture/pattern-selection.md +0 -68
  68. package/.agent/skills/architecture/patterns-reference.md +0 -50
  69. package/.agent/skills/architecture/trade-off-analysis.md +0 -77
  70. package/.agent/skills/bash-linux/SKILL.md +0 -199
  71. package/.agent/skills/behavioral-modes/SKILL.md +0 -242
  72. package/.agent/skills/brainstorming/SKILL.md +0 -163
  73. package/.agent/skills/brainstorming/dynamic-questioning.md +0 -350
  74. package/.agent/skills/clean-code/SKILL.md +0 -201
  75. package/.agent/skills/code-review-checklist/SKILL.md +0 -109
  76. package/.agent/skills/database-design/SKILL.md +0 -52
  77. package/.agent/skills/database-design/database-selection.md +0 -43
  78. package/.agent/skills/database-design/indexing.md +0 -39
  79. package/.agent/skills/database-design/migrations.md +0 -48
  80. package/.agent/skills/database-design/optimization.md +0 -36
  81. package/.agent/skills/database-design/orm-selection.md +0 -30
  82. package/.agent/skills/database-design/schema-design.md +0 -56
  83. package/.agent/skills/database-design/scripts/schema_validator.py +0 -172
  84. package/.agent/skills/deployment-procedures/SKILL.md +0 -241
  85. package/.agent/skills/desktop-design/SKILL.md +0 -25
  86. package/.agent/skills/dispatching-parallel-agents/SKILL.md +0 -112
  87. package/.agent/skills/doc.md +0 -177
  88. package/.agent/skills/docker-patterns/SKILL.md +0 -232
  89. package/.agent/skills/documentation-templates/SKILL.md +0 -194
  90. package/.agent/skills/executing-plans/SKILL.md +0 -61
  91. package/.agent/skills/finishing-a-development-branch/SKILL.md +0 -135
  92. package/.agent/skills/frontend-design/SKILL.md +0 -418
  93. package/.agent/skills/frontend-design/animation-guide.md +0 -331
  94. package/.agent/skills/frontend-design/color-system.md +0 -311
  95. package/.agent/skills/frontend-design/decision-trees.md +0 -418
  96. package/.agent/skills/frontend-design/motion-graphics.md +0 -306
  97. package/.agent/skills/frontend-design/scripts/accessibility_checker.py +0 -183
  98. package/.agent/skills/frontend-design/scripts/ux_audit.py +0 -722
  99. package/.agent/skills/frontend-design/typography-system.md +0 -345
  100. package/.agent/skills/frontend-design/ux-psychology.md +0 -1116
  101. package/.agent/skills/frontend-design/visual-effects.md +0 -383
  102. package/.agent/skills/game-development/2d-games/SKILL.md +0 -119
  103. package/.agent/skills/game-development/3d-games/SKILL.md +0 -135
  104. package/.agent/skills/game-development/SKILL.md +0 -167
  105. package/.agent/skills/game-development/game-art/SKILL.md +0 -185
  106. package/.agent/skills/game-development/game-audio/SKILL.md +0 -190
  107. package/.agent/skills/game-development/game-design/SKILL.md +0 -129
  108. package/.agent/skills/game-development/mobile-games/SKILL.md +0 -108
  109. package/.agent/skills/game-development/multiplayer/SKILL.md +0 -132
  110. package/.agent/skills/game-development/pc-games/SKILL.md +0 -144
  111. package/.agent/skills/game-development/vr-ar/SKILL.md +0 -123
  112. package/.agent/skills/game-development/web-games/SKILL.md +0 -150
  113. package/.agent/skills/geo-fundamentals/SKILL.md +0 -156
  114. package/.agent/skills/geo-fundamentals/scripts/geo_checker.py +0 -289
  115. package/.agent/skills/golang-patterns/SKILL.md +0 -226
  116. package/.agent/skills/golang-testing/SKILL.md +0 -182
  117. package/.agent/skills/i18n-localization/SKILL.md +0 -154
  118. package/.agent/skills/i18n-localization/scripts/i18n_checker.py +0 -241
  119. package/.agent/skills/intelligent-routing/SKILL.md +0 -335
  120. package/.agent/skills/laravel-patterns/SKILL.md +0 -224
  121. package/.agent/skills/laravel-security/SKILL.md +0 -171
  122. package/.agent/skills/laravel-tdd/SKILL.md +0 -149
  123. package/.agent/skills/lint-and-validate/SKILL.md +0 -45
  124. package/.agent/skills/lint-and-validate/scripts/lint_runner.py +0 -184
  125. package/.agent/skills/lint-and-validate/scripts/type_coverage.py +0 -173
  126. package/.agent/skills/mcp-builder/SKILL.md +0 -176
  127. package/.agent/skills/mobile-design/SKILL.md +0 -394
  128. package/.agent/skills/mobile-design/decision-trees.md +0 -516
  129. package/.agent/skills/mobile-design/mobile-backend.md +0 -491
  130. package/.agent/skills/mobile-design/mobile-color-system.md +0 -420
  131. package/.agent/skills/mobile-design/mobile-debugging.md +0 -122
  132. package/.agent/skills/mobile-design/mobile-design-thinking.md +0 -357
  133. package/.agent/skills/mobile-design/mobile-navigation.md +0 -458
  134. package/.agent/skills/mobile-design/mobile-performance.md +0 -767
  135. package/.agent/skills/mobile-design/mobile-testing.md +0 -356
  136. package/.agent/skills/mobile-design/mobile-typography.md +0 -433
  137. package/.agent/skills/mobile-design/platform-android.md +0 -666
  138. package/.agent/skills/mobile-design/platform-ios.md +0 -561
  139. package/.agent/skills/mobile-design/scripts/mobile_audit.py +0 -670
  140. package/.agent/skills/mobile-design/touch-psychology.md +0 -537
  141. package/.agent/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +0 -312
  142. package/.agent/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +0 -240
  143. package/.agent/skills/nextjs-react-expert/3-server-server-side-performance.md +0 -490
  144. package/.agent/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +0 -264
  145. package/.agent/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +0 -581
  146. package/.agent/skills/nextjs-react-expert/6-rendering-rendering-performance.md +0 -432
  147. package/.agent/skills/nextjs-react-expert/7-js-javascript-performance.md +0 -684
  148. package/.agent/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +0 -150
  149. package/.agent/skills/nextjs-react-expert/SKILL.md +0 -286
  150. package/.agent/skills/nextjs-react-expert/scripts/convert_rules.py +0 -222
  151. package/.agent/skills/nextjs-react-expert/scripts/react_performance_checker.py +0 -252
  152. package/.agent/skills/nodejs-best-practices/SKILL.md +0 -333
  153. package/.agent/skills/parallel-agents/SKILL.md +0 -175
  154. package/.agent/skills/performance-profiling/SKILL.md +0 -143
  155. package/.agent/skills/performance-profiling/scripts/lighthouse_audit.py +0 -76
  156. package/.agent/skills/plan-writing/SKILL.md +0 -152
  157. package/.agent/skills/powershell-windows/SKILL.md +0 -167
  158. package/.agent/skills/project-onboarding/SKILL.md +0 -42
  159. package/.agent/skills/python-patterns/SKILL.md +0 -441
  160. package/.agent/skills/react-frontend/SKILL.md +0 -25
  161. package/.agent/skills/receiving-code-review/SKILL.md +0 -120
  162. package/.agent/skills/red-team-tactics/SKILL.md +0 -199
  163. package/.agent/skills/requesting-code-review/SKILL.md +0 -67
  164. package/.agent/skills/rust-pro/SKILL.md +0 -176
  165. package/.agent/skills/seo-fundamentals/SKILL.md +0 -129
  166. package/.agent/skills/seo-fundamentals/scripts/seo_checker.py +0 -219
  167. package/.agent/skills/server-management/SKILL.md +0 -161
  168. package/.agent/skills/subagent-driven-development/SKILL.md +0 -76
  169. package/.agent/skills/systematic-debugging/SKILL.md +0 -109
  170. package/.agent/skills/tailwind-patterns/SKILL.md +0 -269
  171. package/.agent/skills/tdd-workflow/SKILL.md +0 -149
  172. package/.agent/skills/testing-patterns/SKILL.md +0 -178
  173. package/.agent/skills/testing-patterns/scripts/test_runner.py +0 -219
  174. package/.agent/skills/using-git-worktrees/SKILL.md +0 -121
  175. package/.agent/skills/verification-before-completion/SKILL.md +0 -99
  176. package/.agent/skills/vulnerability-scanner/SKILL.md +0 -276
  177. package/.agent/skills/vulnerability-scanner/checklists.md +0 -121
  178. package/.agent/skills/vulnerability-scanner/scripts/security_scan.py +0 -458
  179. package/.agent/skills/web-design-guidelines/SKILL.md +0 -57
  180. package/.agent/skills/webapp-testing/SKILL.md +0 -187
  181. package/.agent/skills/webapp-testing/scripts/playwright_runner.py +0 -173
  182. package/.agent/skills/writing-skills/SKILL.md +0 -170
  183. package/.agent/workflows/brainstorm.md +0 -113
  184. package/.agent/workflows/create.md +0 -59
  185. package/.agent/workflows/debug.md +0 -103
  186. package/.agent/workflows/deploy.md +0 -176
  187. package/.agent/workflows/enhance.md +0 -63
  188. package/.agent/workflows/orchestrate.md +0 -237
  189. package/.agent/workflows/plan.md +0 -89
  190. package/.agent/workflows/preview.md +0 -81
  191. package/.agent/workflows/release.md +0 -42
  192. package/.agent/workflows/review.md +0 -125
  193. package/.agent/workflows/simple.md +0 -42
  194. package/.agent/workflows/spec.md +0 -140
  195. package/.agent/workflows/status.md +0 -86
  196. package/.agent/workflows/task.md +0 -59
  197. package/.agent/workflows/test.md +0 -144
  198. package/.agent/workflows/ui-ux-pro-max.md +0 -296
  199. package/agents/backend-specialist.md +0 -263
  200. package/agents/code-archaeologist.md +0 -106
  201. package/agents/database-architect.md +0 -226
  202. package/agents/debugger.md +0 -225
  203. package/agents/devops-engineer.md +0 -242
  204. package/agents/documentation-writer.md +0 -104
  205. package/agents/explorer-agent.md +0 -73
  206. package/agents/frontend-specialist.md +0 -593
  207. package/agents/game-developer.md +0 -162
  208. package/agents/mobile-developer.md +0 -377
  209. package/agents/orchestrator.md +0 -416
  210. package/agents/penetration-tester.md +0 -188
  211. package/agents/performance-optimizer.md +0 -187
  212. package/agents/product-manager.md +0 -112
  213. package/agents/product-owner.md +0 -95
  214. package/agents/project-planner.md +0 -406
  215. package/agents/qa-automation-engineer.md +0 -103
  216. package/agents/security-auditor.md +0 -170
  217. package/agents/seo-specialist.md +0 -111
  218. package/agents/test-engineer.md +0 -158
  219. package/kit/PROMPT_RECIPE.md +0 -30
  220. package/kit/README.md +0 -30
  221. package/prompts/debug.md +0 -11
  222. package/prompts/release.md +0 -11
  223. package/prompts/simple.md +0 -11
  224. package/prompts/spec.md +0 -11
  225. package/prompts/task.md +0 -12
  226. package/rules/GEMINI.md +0 -45
  227. package/scripts/auto_preview.py +0 -148
  228. package/scripts/checklist.py +0 -217
  229. package/scripts/session_manager.py +0 -120
  230. package/scripts/verify_all.py +0 -327
  231. package/skills/api-design/SKILL.md +0 -156
  232. package/skills/api-patterns/SKILL.md +0 -81
  233. package/skills/api-patterns/api-style.md +0 -42
  234. package/skills/api-patterns/auth.md +0 -24
  235. package/skills/api-patterns/documentation.md +0 -26
  236. package/skills/api-patterns/graphql.md +0 -41
  237. package/skills/api-patterns/rate-limiting.md +0 -31
  238. package/skills/api-patterns/response.md +0 -37
  239. package/skills/api-patterns/rest.md +0 -40
  240. package/skills/api-patterns/scripts/api_validator.py +0 -211
  241. package/skills/api-patterns/security-testing.md +0 -122
  242. package/skills/api-patterns/trpc.md +0 -41
  243. package/skills/api-patterns/versioning.md +0 -22
  244. package/skills/app-builder/SKILL.md +0 -75
  245. package/skills/app-builder/agent-coordination.md +0 -71
  246. package/skills/app-builder/feature-building.md +0 -53
  247. package/skills/app-builder/project-detection.md +0 -34
  248. package/skills/app-builder/scaffolding.md +0 -118
  249. package/skills/app-builder/tech-stack.md +0 -40
  250. package/skills/app-builder/templates/SKILL.md +0 -39
  251. package/skills/app-builder/templates/astro-static/TEMPLATE.md +0 -76
  252. package/skills/app-builder/templates/chrome-extension/TEMPLATE.md +0 -92
  253. package/skills/app-builder/templates/cli-tool/TEMPLATE.md +0 -88
  254. package/skills/app-builder/templates/electron-desktop/TEMPLATE.md +0 -88
  255. package/skills/app-builder/templates/express-api/TEMPLATE.md +0 -83
  256. package/skills/app-builder/templates/flutter-app/TEMPLATE.md +0 -90
  257. package/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +0 -90
  258. package/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +0 -122
  259. package/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +0 -122
  260. package/skills/app-builder/templates/nextjs-static/TEMPLATE.md +0 -169
  261. package/skills/app-builder/templates/nuxt-app/TEMPLATE.md +0 -134
  262. package/skills/app-builder/templates/python-fastapi/TEMPLATE.md +0 -83
  263. package/skills/app-builder/templates/react-native-app/TEMPLATE.md +0 -119
  264. package/skills/architecture/SKILL.md +0 -55
  265. package/skills/architecture/context-discovery.md +0 -43
  266. package/skills/architecture/examples.md +0 -94
  267. package/skills/architecture/pattern-selection.md +0 -68
  268. package/skills/architecture/patterns-reference.md +0 -50
  269. package/skills/architecture/trade-off-analysis.md +0 -77
  270. package/skills/bash-linux/SKILL.md +0 -199
  271. package/skills/behavioral-modes/SKILL.md +0 -242
  272. package/skills/brainstorming/SKILL.md +0 -163
  273. package/skills/brainstorming/dynamic-questioning.md +0 -350
  274. package/skills/clean-code/SKILL.md +0 -201
  275. package/skills/code-review-checklist/SKILL.md +0 -142
  276. package/skills/database-design/SKILL.md +0 -52
  277. package/skills/database-design/database-selection.md +0 -43
  278. package/skills/database-design/indexing.md +0 -39
  279. package/skills/database-design/migrations.md +0 -48
  280. package/skills/database-design/optimization.md +0 -36
  281. package/skills/database-design/orm-selection.md +0 -30
  282. package/skills/database-design/schema-design.md +0 -56
  283. package/skills/database-design/scripts/schema_validator.py +0 -172
  284. package/skills/deployment-procedures/SKILL.md +0 -241
  285. package/skills/desktop-design/SKILL.md +0 -25
  286. package/skills/dispatching-parallel-agents/SKILL.md +0 -112
  287. package/skills/doc.md +0 -177
  288. package/skills/docker-patterns/SKILL.md +0 -232
  289. package/skills/documentation-templates/SKILL.md +0 -194
  290. package/skills/executing-plans/SKILL.md +0 -61
  291. package/skills/finishing-a-development-branch/SKILL.md +0 -135
  292. package/skills/frontend-design/SKILL.md +0 -418
  293. package/skills/frontend-design/animation-guide.md +0 -331
  294. package/skills/frontend-design/color-system.md +0 -311
  295. package/skills/frontend-design/decision-trees.md +0 -418
  296. package/skills/frontend-design/motion-graphics.md +0 -306
  297. package/skills/frontend-design/scripts/accessibility_checker.py +0 -183
  298. package/skills/frontend-design/scripts/ux_audit.py +0 -722
  299. package/skills/frontend-design/typography-system.md +0 -345
  300. package/skills/frontend-design/ux-psychology.md +0 -1116
  301. package/skills/frontend-design/visual-effects.md +0 -383
  302. package/skills/game-development/2d-games/SKILL.md +0 -119
  303. package/skills/game-development/3d-games/SKILL.md +0 -135
  304. package/skills/game-development/SKILL.md +0 -167
  305. package/skills/game-development/game-art/SKILL.md +0 -185
  306. package/skills/game-development/game-audio/SKILL.md +0 -190
  307. package/skills/game-development/game-design/SKILL.md +0 -129
  308. package/skills/game-development/mobile-games/SKILL.md +0 -108
  309. package/skills/game-development/multiplayer/SKILL.md +0 -132
  310. package/skills/game-development/pc-games/SKILL.md +0 -144
  311. package/skills/game-development/vr-ar/SKILL.md +0 -123
  312. package/skills/game-development/web-games/SKILL.md +0 -150
  313. package/skills/geo-fundamentals/SKILL.md +0 -156
  314. package/skills/geo-fundamentals/scripts/geo_checker.py +0 -289
  315. package/skills/golang-patterns/SKILL.md +0 -226
  316. package/skills/golang-testing/SKILL.md +0 -182
  317. package/skills/i18n-localization/SKILL.md +0 -154
  318. package/skills/i18n-localization/scripts/i18n_checker.py +0 -241
  319. package/skills/intelligent-routing/SKILL.md +0 -335
  320. package/skills/laravel-patterns/SKILL.md +0 -224
  321. package/skills/laravel-security/SKILL.md +0 -171
  322. package/skills/laravel-tdd/SKILL.md +0 -149
  323. package/skills/lint-and-validate/SKILL.md +0 -45
  324. package/skills/lint-and-validate/scripts/lint_runner.py +0 -184
  325. package/skills/lint-and-validate/scripts/type_coverage.py +0 -173
  326. package/skills/mcp-builder/SKILL.md +0 -176
  327. package/skills/mobile-design/SKILL.md +0 -394
  328. package/skills/mobile-design/decision-trees.md +0 -516
  329. package/skills/mobile-design/mobile-backend.md +0 -491
  330. package/skills/mobile-design/mobile-color-system.md +0 -420
  331. package/skills/mobile-design/mobile-debugging.md +0 -122
  332. package/skills/mobile-design/mobile-design-thinking.md +0 -357
  333. package/skills/mobile-design/mobile-navigation.md +0 -458
  334. package/skills/mobile-design/mobile-performance.md +0 -767
  335. package/skills/mobile-design/mobile-testing.md +0 -356
  336. package/skills/mobile-design/mobile-typography.md +0 -433
  337. package/skills/mobile-design/platform-android.md +0 -666
  338. package/skills/mobile-design/platform-ios.md +0 -561
  339. package/skills/mobile-design/scripts/mobile_audit.py +0 -670
  340. package/skills/mobile-design/touch-psychology.md +0 -537
  341. package/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +0 -312
  342. package/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +0 -240
  343. package/skills/nextjs-react-expert/3-server-server-side-performance.md +0 -490
  344. package/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +0 -264
  345. package/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +0 -581
  346. package/skills/nextjs-react-expert/6-rendering-rendering-performance.md +0 -432
  347. package/skills/nextjs-react-expert/7-js-javascript-performance.md +0 -684
  348. package/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +0 -150
  349. package/skills/nextjs-react-expert/SKILL.md +0 -286
  350. package/skills/nextjs-react-expert/scripts/convert_rules.py +0 -222
  351. package/skills/nextjs-react-expert/scripts/react_performance_checker.py +0 -252
  352. package/skills/nodejs-best-practices/SKILL.md +0 -333
  353. package/skills/parallel-agents/SKILL.md +0 -175
  354. package/skills/performance-profiling/SKILL.md +0 -143
  355. package/skills/performance-profiling/scripts/lighthouse_audit.py +0 -76
  356. package/skills/plan-writing/SKILL.md +0 -152
  357. package/skills/powershell-windows/SKILL.md +0 -167
  358. package/skills/project-onboarding/SKILL.md +0 -42
  359. package/skills/python-patterns/SKILL.md +0 -441
  360. package/skills/react-frontend/SKILL.md +0 -25
  361. package/skills/receiving-code-review/SKILL.md +0 -120
  362. package/skills/red-team-tactics/SKILL.md +0 -199
  363. package/skills/requesting-code-review/SKILL.md +0 -67
  364. package/skills/rust-pro/SKILL.md +0 -176
  365. package/skills/seo-fundamentals/SKILL.md +0 -129
  366. package/skills/seo-fundamentals/scripts/seo_checker.py +0 -219
  367. package/skills/server-management/SKILL.md +0 -161
  368. package/skills/subagent-driven-development/SKILL.md +0 -76
  369. package/skills/systematic-debugging/SKILL.md +0 -109
  370. package/skills/tailwind-patterns/SKILL.md +0 -269
  371. package/skills/tdd-workflow/SKILL.md +0 -173
  372. package/skills/testing-patterns/SKILL.md +0 -178
  373. package/skills/testing-patterns/scripts/test_runner.py +0 -219
  374. package/skills/using-git-worktrees/SKILL.md +0 -121
  375. package/skills/verification-before-completion/SKILL.md +0 -113
  376. package/skills/vulnerability-scanner/SKILL.md +0 -276
  377. package/skills/vulnerability-scanner/checklists.md +0 -121
  378. package/skills/vulnerability-scanner/scripts/security_scan.py +0 -458
  379. package/skills/web-design-guidelines/SKILL.md +0 -57
  380. package/skills/webapp-testing/SKILL.md +0 -187
  381. package/skills/webapp-testing/scripts/playwright_runner.py +0 -173
  382. package/skills/writing-skills/SKILL.md +0 -170
  383. package/workflows/brainstorm.md +0 -113
  384. package/workflows/create.md +0 -59
  385. package/workflows/debug.md +0 -103
  386. package/workflows/deploy.md +0 -176
  387. package/workflows/enhance.md +0 -63
  388. package/workflows/orchestrate.md +0 -237
  389. package/workflows/plan.md +0 -89
  390. package/workflows/preview.md +0 -81
  391. package/workflows/release.md +0 -42
  392. package/workflows/simple.md +0 -42
  393. package/workflows/status.md +0 -86
  394. package/workflows/task.md +0 -59
  395. package/workflows/test.md +0 -144
  396. package/workflows/ui-ux-pro-max.md +0 -296
@@ -1,350 +0,0 @@
1
- # Dynamic Question Generation
2
-
3
- > **PRINCIPLE:** Questions are not about gathering data—they are about **revealing architectural consequences**.
4
- >
5
- > Every question must connect to a concrete implementation decision that affects cost, complexity, or timeline.
6
-
7
- ---
8
-
9
- ## 🧠 Core Principles
10
-
11
- ### 1. Questions Reveal Consequences
12
-
13
- A good question is not "What color do you want?" but:
14
-
15
- ```markdown
16
- ❌ BAD: "What authentication method?"
17
- ✅ GOOD: "Should users sign up with email/password or social login?
18
-
19
- Impact:
20
- - Email/Pass → Need password reset, hashing, 2FA infrastructure
21
- - Social → OAuth providers, user profile mapping, less control
22
-
23
- Trade-off: Security vs. Development time vs. User friction"
24
- ```
25
-
26
- ### 2. Context Before Content
27
-
28
- First understand **where** this request fits:
29
-
30
- | Context | Question Focus |
31
- |---------|----------------|
32
- | **Greenfield** (new project) | Foundation decisions: stack, hosting, scale |
33
- | **Feature Addition** | Integration points, existing patterns, breaking changes |
34
- | **Refactor** | Why refactor? Performance? Maintainability? What's broken? |
35
- | **Debug** | Symptoms → Root cause → Reproduction path |
36
-
37
- ### 3. Minimum Viable Questions
38
-
39
- **PRINCIPLE:** Each question must eliminate a fork in the implementation road.
40
-
41
- ```
42
- Before Question:
43
- ├── Path A: Do X (5 min)
44
- ├── Path B: Do Y (15 min)
45
- └── Path C: Do Z (1 hour)
46
-
47
- After Question:
48
- └── Path Confirmed: Do X (5 min)
49
- ```
50
-
51
- If a question doesn't reduce implementation paths → **DELETE IT**.
52
-
53
- ### 4. Questions Generate Data, Not Assumptions
54
-
55
- ```markdown
56
- ❌ ASSUMPTION: "User probably wants Stripe for payments"
57
- ✅ QUESTION: "Which payment provider fits your needs?
58
-
59
- Stripe → Best documentation, 2.9% + $0.30, US-centric
60
- LemonSqueezy → Merchant of Record, 5% + $0.50, global taxes
61
- Paddle → Complex pricing, handles EU VAT, enterprise focus"
62
- ```
63
-
64
- ---
65
-
66
- ## 📋 Question Generation Algorithm
67
-
68
- ```
69
- INPUT: User request + Context (greenfield/feature/refactor/debug)
70
- │
71
- ├── STEP 1: Parse Request
72
- │ ├── Extract domain (ecommerce, auth, realtime, cms, etc.)
73
- │ ├── Extract features (explicit and implied)
74
- │ └── Extract scale indicators (users, data volume, frequency)
75
- │
76
- ├── STEP 2: Identify Decision Points
77
- │ ├── What MUST be decided before coding? (blocking)
78
- │ ├── What COULD be decided later? (deferable)
79
- │ └── What has ARCHITECTURAL impact? (high-leverage)
80
- │
81
- ├── STEP 3: Generate Questions (Priority Order)
82
- │ ├── P0: Blocking decisions (cannot proceed without answer)
83
- │ ├── P1: High-leverage (affects >30% of implementation)
84
- │ ├── P2: Medium-leverage (affects specific features)
85
- │ └── P3: Nice-to-have (edge cases, optimization)
86
- │
87
- └── STEP 4: Format Each Question
88
- ├── What: Clear question
89
- ├── Why: Impact on implementation
90
- ├── Options: Trade-offs (not just A vs B)
91
- └── Default: What happens if user doesn't answer
92
- ```
93
-
94
- ---
95
-
96
- ## 🎯 Domain-Specific Question Banks
97
-
98
- ### E-Commerce
99
-
100
- | Question | Why It Matters | Trade-offs |
101
- |----------|----------------|------------|
102
- | **Single or Multi-vendor?** | Multi-vendor → Commission logic, vendor dashboards, split payments | +Revenue, -Complexity |
103
- | **Inventory Tracking?** | Needs stock tables, reservation logic, low-stock alerts | +Accuracy, -Development time |
104
- | **Digital or Physical Products?** | Digital → Download links, no shipping | Physical → Shipping APIs, tracking |
105
- | **Subscription or One-time?** | Subscription → Recurring billing, dunning, proration | +Revenue, -Complexity |
106
-
107
- ### Authentication
108
-
109
- | Question | Why It Matters | Trade-offs |
110
- |----------|----------------|------------|
111
- | **Social Login Needed?** | OAuth providers vs. password reset infrastructure | +UX, -Control |
112
- | **Role-Based Permissions?** | RBAC tables, policy enforcement, admin UI | +Security, -Development time |
113
- | **2FA Required?** | TOTP/SMI infrastructure, backup codes, recovery flow | +Security, -UX friction |
114
- | **Email Verification?** | Verification tokens, email service, resend logic | +Security, -Sign-up friction |
115
-
116
- ### Real-time
117
-
118
- | Question | Why It Matters | Trade-offs |
119
- |----------|----------------|------------|
120
- | **WebSocket or Polling?** | WS → Server scaling, connection management | Polling → Simpler, higher latency |
121
- | **Expected Concurrent Users?** | <100 → Single server, >1000 → Redis pub/sub, >10k → specialized infra | +Scale, -Complexity |
122
- | **Message Persistence?** | History tables, storage costs, pagination | +UX, -Storage |
123
- | **Ephemeral or Durable?** | Ephemeral → In-memory, Durable → Database write before emit | +Reliability, -Latency |
124
-
125
- ### Content/CMS
126
-
127
- | Question | Why It Matters | Trade-offs |
128
- |----------|----------------|------------|
129
- | **Rich Text or Markdown?** | Rich Text → Sanitization, XSS risks | Markdown → Simple, no WYSIWYG |
130
- | **Draft/Publish Workflow?** | Status field, scheduled jobs, versioning | +Control, -Complexity |
131
- | **Media Handling?** | Upload endpoints, storage, optimization | +Features, -Development time |
132
- | **Multi-language?** | i18n tables, translation UI, fallback logic | +Reach, -Complexity |
133
-
134
- ---
135
-
136
- ## 📐 Dynamic Question Template
137
-
138
- ```markdown
139
- Based on your request for [DOMAIN] [FEATURE]:
140
-
141
- ## 🔴 CRITICAL (Blocking Decisions)
142
-
143
- ### 1. **[DECISION POINT]**
144
-
145
- **Question:** [Clear, specific question]
146
-
147
- **Why This Matters:**
148
- - [Explain architectural consequence]
149
- - [Affects: cost / complexity / timeline / scale]
150
-
151
- **Options:**
152
- | Option | Pros | Cons | Best For |
153
- |--------|------|------|----------|
154
- | A | [Advantage] | [Disadvantage] | [Use case] |
155
- | B | [Advantage] | [Disadvantage] | [Use case] |
156
-
157
- **If Not Specified:** [Default choice + rationale]
158
-
159
- ---
160
-
161
- ## 🟡 HIGH-LEVERAGE (Affects Implementation)
162
-
163
- ### 2. **[DECISION POINT]**
164
- [Same format]
165
-
166
- ---
167
-
168
- ## 🟢 NICE-TO-HAVE (Edge Cases)
169
-
170
- ### 3. **[DECISION POINT]**
171
- [Same format]
172
- ```
173
-
174
- ---
175
-
176
- ## 🔄 Iterative Questioning
177
-
178
- ### First Pass (3-5 Questions)
179
- Focus on **blocking decisions**. Don't proceed without answers.
180
-
181
- ### Second Pass (After Initial Implementation)
182
- As patterns emerge, ask:
183
- - "This feature implies [X]. Should we handle [edge case] now or defer?"
184
- - "We're using [Pattern A]. Should [Feature B] follow the same pattern?"
185
-
186
- ### Third Pass (Optimization)
187
- When functionality works:
188
- - "Performance bottleneck at [X]. Optimize now or acceptable for now?"
189
- - "Refactor [Y] for maintainability or ship as-is?"
190
-
191
- ---
192
-
193
- ## 🎭 Example: Full Question Generation
194
-
195
- ```
196
- USER REQUEST: "Build an Instagram clone"
197
-
198
- STEP 1: Parse
199
- ├── Domain: Social Media
200
- ├── Features: Photo sharing, engagement (likes/comments), user profiles
201
- ├── Implied: Feed, following, authentication
202
- └── Scale: Potentially high (social apps go viral)
203
-
204
- STEP 2: Decision Points
205
- ├── Blocking: Storage strategy, authentication method, feed type
206
- ├── High-leverage: Real-time notifications, data model complexity
207
- └── Deferable: Analytics, advanced search, reels/video
208
-
209
- STEP 3: Generate Questions (Priority)
210
-
211
- P0 (Blocking):
212
- 1. Storage Strategy → Affects architecture, cost, speed
213
- 2. Feed Algorithm → Affects database queries, complexity
214
- 3. Auth Method → Affects dev time, UX, security
215
-
216
- P1 (High-leverage):
217
- 4. Real-time Notifications → WebSocket vs polling
218
- 5. Media Processing → Client-side vs server-side optimization
219
-
220
- P2 (Deferable):
221
- 6. Story/Reels → Major feature creep, defer to v2
222
- 7. DM/Chat → Separate subsystem, defer to v2
223
-
224
- STEP 4: Format Output
225
- ```
226
-
227
- ---
228
-
229
- ## 📊 Generated Output (Example)
230
-
231
- ```
232
- Based on your Instagram clone request:
233
-
234
- ## 🔴 CRITICAL DECISIONS (Cannot Proceed Without Answers)
235
-
236
- ### 1. **Photo Storage Strategy**
237
-
238
- **Question:** Where will user photos be stored and served?
239
-
240
- **Why This Matters:**
241
- - Affects: Monthly hosting costs, page load speed, CDN complexity
242
- - High-volume social apps: 1000 users × 10 photos × 2MB = 20GB storage
243
-
244
- **Options:**
245
- | Option | Cost | Speed | Complexity | Best For |
246
- |--------|------|-------|------------|----------|
247
- | **Cloudinary** | $89/mo (25GB) | Fast (CDN) | Low | MVP, rapid launch |
248
- | **AWS S3 + CloudFront** | $0.023/GB | Fast (CDN) | Medium | Production, cost-optimized |
249
- | **Supabase Storage** | Free tier 1GB | Medium | Low | Small scale, simple |
250
- | **Local Storage** | Server cost | Slow | Low | Development only |
251
-
252
- **If Not Specified:** Cloudinary (balanced for MVP)
253
-
254
- ---
255
-
256
- ### 2. **Feed Algorithm Choice**
257
-
258
- **Question:** How should the main feed work?
259
-
260
- **Why This Matters:**
261
- - Affects: Database query complexity, caching strategy, development time
262
- - Algorithmic feeds require ML infrastructure, ranking signals
263
-
264
- **Options:**
265
- | Option | Complexity | Database Impact | Best For |
266
- |--------|------------|-----------------|----------|
267
- | **Chronological** | Low | Simple query | Early stage, transparency |
268
- | **Follow-Only** | Medium | JOIN with pagination | Most social apps |
269
- | **Algorithmic** | High | Pre-computed feed tables | Instagram competitor |
270
-
271
- **If Not Specified:** Follow-Only (balanced for social app)
272
-
273
- ---
274
-
275
- ### 3. **Authentication Approach**
276
-
277
- **Question:** How do users sign up and login?
278
-
279
- **Why This Matters:**
280
- - Affects: Development time (2-5 hours), security posture, UX friction
281
-
282
- **Options:**
283
- | Option | Dev Time | Security | UX | Best For |
284
- |--------|----------|----------|-----|----------|
285
- | **Email/Password** | 4-5 hrs | High (if 2FA) | Medium | Full control needed |
286
- | **Social Only** | 1-2 hrs | Provider-dependent | Smooth | B2C, rapid launch |
287
- | **Magic Link** | 2-3 hrs | Medium | Very smooth | Security-focused |
288
- | **Clerk/Auth0** | 1 hr | High | Smooth | Fastest to market |
289
-
290
- **If Not Specified:** Clerk (fastest for MVP)
291
-
292
- ---
293
-
294
- ## 🟡 HIGH-LEVERAGE (Affects Architecture)
295
-
296
- ### 4. **Real-time Notifications**
297
-
298
- **Question:** Do users need instant notifications for likes/comments?
299
-
300
- **Why This Matters:**
301
- - WebSocket adds infrastructure complexity (Redis pub/sub for scaling)
302
- - Polling is simpler but higher latency
303
-
304
- **Options:**
305
- | Option | Complexity | Scale Cost | Best For |
306
- |--------|------------|------------|----------|
307
- | **WebSocket + Redis** | High | $10+/mo | >1000 concurrent users |
308
- | **Polling (30s)** | Low | DB queries | <1000 users |
309
- | **No Real-time** | None | None | MVP, validate first |
310
-
311
- **If Not Specified:** Polling for MVP (defer WebSocket until validated)
312
-
313
- ---
314
-
315
- ## 🟢 NICE-TO-HAVE (Defer to v2)
316
-
317
- ### 5. **Video/Reels Support**
318
- - Major complexity (video processing, streaming infrastructure)
319
- - Recommendation: Launch with photos only, add video after validation
320
-
321
- ### 6. **Direct Messaging**
322
- - Separate subsystem (chat infrastructure different from feed)
323
- - Recommendation: Use Pusher/Stream for real-time or defer entirely
324
-
325
- ---
326
-
327
- ## 📋 Summary
328
-
329
- | Decision | Recommendation | If Changed |
330
- |----------|----------------|------------|
331
- | Storage | Cloudinary | +3 hrs setup |
332
- | Feed | Follow-only | +2 hrs query optimization |
333
- | Auth | Clerk | -3 hrs dev time |
334
- | Real-time | Polling | +5 hrs WebSocket setup |
335
- | Video | Defer to v2 | N/A |
336
- | DM | Defer to v2 | N/A |
337
-
338
- **Total Estimated MVP Time:** 15-20 hours with recommendations above
339
- ```
340
-
341
- ---
342
-
343
- ## 🎯 Principles Recap
344
-
345
- 1. **Every question = Architectural decision** → Not data gathering
346
- 2. **Show trade-offs** → User understands consequences
347
- 3. **Prioritize blocking decisions** → Cannot proceed without
348
- 4. **Provide defaults** → If user doesn't answer, we proceed anyway
349
- 5. **Domain-aware** → Ecommerce questions ≠ Auth questions ≠ Real-time questions
350
- 6. **Iterative** → More questions as patterns emerge during implementation
@@ -1,201 +0,0 @@
1
- ---
2
- name: clean-code
3
- description: Pragmatic coding standards - concise, direct, no over-engineering, no unnecessary comments
4
- allowed-tools: Read, Write, Edit
5
- version: 2.0
6
- priority: CRITICAL
7
- ---
8
-
9
- # Clean Code - Pragmatic AI Coding Standards
10
-
11
- > **CRITICAL SKILL** - Be **concise, direct, and solution-focused**.
12
-
13
- ---
14
-
15
- ## Core Principles
16
-
17
- | Principle | Rule |
18
- |-----------|------|
19
- | **SRP** | Single Responsibility - each function/class does ONE thing |
20
- | **DRY** | Don't Repeat Yourself - extract duplicates, reuse |
21
- | **KISS** | Keep It Simple - simplest solution that works |
22
- | **YAGNI** | You Aren't Gonna Need It - don't build unused features |
23
- | **Boy Scout** | Leave code cleaner than you found it |
24
-
25
- ---
26
-
27
- ## Naming Rules
28
-
29
- | Element | Convention |
30
- |---------|------------|
31
- | **Variables** | Reveal intent: `userCount` not `n` |
32
- | **Functions** | Verb + noun: `getUserById()` not `user()` |
33
- | **Booleans** | Question form: `isActive`, `hasPermission`, `canEdit` |
34
- | **Constants** | SCREAMING_SNAKE: `MAX_RETRY_COUNT` |
35
-
36
- > **Rule:** If you need a comment to explain a name, rename it.
37
-
38
- ---
39
-
40
- ## Function Rules
41
-
42
- | Rule | Description |
43
- |------|-------------|
44
- | **Small** | Max 20 lines, ideally 5-10 |
45
- | **One Thing** | Does one thing, does it well |
46
- | **One Level** | One level of abstraction per function |
47
- | **Few Args** | Max 3 arguments, prefer 0-2 |
48
- | **No Side Effects** | Don't mutate inputs unexpectedly |
49
-
50
- ---
51
-
52
- ## Code Structure
53
-
54
- | Pattern | Apply |
55
- |---------|-------|
56
- | **Guard Clauses** | Early returns for edge cases |
57
- | **Flat > Nested** | Avoid deep nesting (max 2 levels) |
58
- | **Composition** | Small functions composed together |
59
- | **Colocation** | Keep related code close |
60
-
61
- ---
62
-
63
- ## AI Coding Style
64
-
65
- | Situation | Action |
66
- |-----------|--------|
67
- | User asks for feature | Write it directly |
68
- | User reports bug | Fix it, don't explain |
69
- | No clear requirement | Ask, don't assume |
70
-
71
- ---
72
-
73
- ## Anti-Patterns (DON'T)
74
-
75
- | ❌ Pattern | ✅ Fix |
76
- |-----------|-------|
77
- | Comment every line | Delete obvious comments |
78
- | Helper for one-liner | Inline the code |
79
- | Factory for 2 objects | Direct instantiation |
80
- | utils.ts with 1 function | Put code where used |
81
- | "First we import..." | Just write code |
82
- | Deep nesting | Guard clauses |
83
- | Magic numbers | Named constants |
84
- | God functions | Split by responsibility |
85
-
86
- ---
87
-
88
- ## 🔴 Before Editing ANY File (THINK FIRST!)
89
-
90
- **Before changing a file, ask yourself:**
91
-
92
- | Question | Why |
93
- |----------|-----|
94
- | **What imports this file?** | They might break |
95
- | **What does this file import?** | Interface changes |
96
- | **What tests cover this?** | Tests might fail |
97
- | **Is this a shared component?** | Multiple places affected |
98
-
99
- **Quick Check:**
100
- ```
101
- File to edit: UserService.ts
102
- └── Who imports this? → UserController.ts, AuthController.ts
103
- └── Do they need changes too? → Check function signatures
104
- ```
105
-
106
- > 🔴 **Rule:** Edit the file + all dependent files in the SAME task.
107
- > 🔴 **Never leave broken imports or missing updates.**
108
-
109
- ---
110
-
111
- ## Summary
112
-
113
- | Do | Don't |
114
- |----|-------|
115
- | Write code directly | Write tutorials |
116
- | Let code self-document | Add obvious comments |
117
- | Fix bugs immediately | Explain the fix first |
118
- | Inline small things | Create unnecessary files |
119
- | Name things clearly | Use abbreviations |
120
- | Keep functions small | Write 100+ line functions |
121
-
122
- > **Remember: The user wants working code, not a programming lesson.**
123
-
124
- ---
125
-
126
- ## 🔴 Self-Check Before Completing (MANDATORY)
127
-
128
- **Before saying "task complete", verify:**
129
-
130
- | Check | Question |
131
- |-------|----------|
132
- | ✅ **Goal met?** | Did I do exactly what user asked? |
133
- | ✅ **Files edited?** | Did I modify all necessary files? |
134
- | ✅ **Code works?** | Did I test/verify the change? |
135
- | ✅ **No errors?** | Lint and TypeScript pass? |
136
- | ✅ **Nothing forgotten?** | Any edge cases missed? |
137
-
138
- > 🔴 **Rule:** If ANY check fails, fix it before completing.
139
-
140
- ---
141
-
142
- ## Verification Scripts (MANDATORY)
143
-
144
- > 🔴 **CRITICAL:** Each agent runs ONLY their own skill's scripts after completing work.
145
-
146
- ### Agent → Script Mapping
147
-
148
- | Agent | Script | Command |
149
- |-------|--------|---------|
150
- | **frontend-specialist** | UX Audit | `python .agent/skills/frontend-design/scripts/ux_audit.py .` |
151
- | **frontend-specialist** | A11y Check | `python .agent/skills/frontend-design/scripts/accessibility_checker.py .` |
152
- | **backend-specialist** | API Validator | `python .agent/skills/api-patterns/scripts/api_validator.py .` |
153
- | **mobile-developer** | Mobile Audit | `python .agent/skills/mobile-design/scripts/mobile_audit.py .` |
154
- | **database-architect** | Schema Validate | `python .agent/skills/database-design/scripts/schema_validator.py .` |
155
- | **security-auditor** | Security Scan | `python .agent/skills/vulnerability-scanner/scripts/security_scan.py .` |
156
- | **seo-specialist** | SEO Check | `python .agent/skills/seo-fundamentals/scripts/seo_checker.py .` |
157
- | **seo-specialist** | GEO Check | `python .agent/skills/geo-fundamentals/scripts/geo_checker.py .` |
158
- | **performance-optimizer** | Lighthouse | `python .agent/skills/performance-profiling/scripts/lighthouse_audit.py <url>` |
159
- | **test-engineer** | Test Runner | `python .agent/skills/testing-patterns/scripts/test_runner.py .` |
160
- | **test-engineer** | Playwright | `python .agent/skills/webapp-testing/scripts/playwright_runner.py <url>` |
161
- | **Any agent** | Lint Check | `python .agent/skills/lint-and-validate/scripts/lint_runner.py .` |
162
- | **Any agent** | Type Coverage | `python .agent/skills/lint-and-validate/scripts/type_coverage.py .` |
163
- | **Any agent** | i18n Check | `python .agent/skills/i18n-localization/scripts/i18n_checker.py .` |
164
-
165
- > ❌ **WRONG:** `test-engineer` running `ux_audit.py`
166
- > ✅ **CORRECT:** `frontend-specialist` running `ux_audit.py`
167
-
168
- ---
169
-
170
- ### 🔴 Script Output Handling (READ → SUMMARIZE → ASK)
171
-
172
- **When running a validation script, you MUST:**
173
-
174
- 1. **Run the script** and capture ALL output
175
- 2. **Parse the output** - identify errors, warnings, and passes
176
- 3. **Summarize to user** in this format:
177
-
178
- ```markdown
179
- ## Script Results: [script_name.py]
180
-
181
- ### ❌ Errors Found (X items)
182
- - [File:Line] Error description 1
183
- - [File:Line] Error description 2
184
-
185
- ### ⚠️ Warnings (Y items)
186
- - [File:Line] Warning description
187
-
188
- ### ✅ Passed (Z items)
189
- - Check 1 passed
190
- - Check 2 passed
191
-
192
- **Should I fix the X errors?**
193
- ```
194
-
195
- 4. **Wait for user confirmation** before fixing
196
- 5. **After fixing** → Re-run script to confirm
197
-
198
- > 🔴 **VIOLATION:** Running script and ignoring output = FAILED task.
199
- > 🔴 **VIOLATION:** Auto-fixing without asking = Not allowed.
200
- > 🔴 **Rule:** Always READ output → SUMMARIZE → ASK → then fix.
201
-
@@ -1,109 +0,0 @@
1
- ---
2
- name: code-review-checklist
3
- description: Code review guidelines covering code quality, security, and best practices.
4
- allowed-tools: Read, Glob, Grep
5
- ---
6
-
7
- # Code Review Checklist
8
-
9
- ## Quick Review Checklist
10
-
11
- ### Correctness
12
- - [ ] Code does what it's supposed to do
13
- - [ ] Edge cases handled
14
- - [ ] Error handling in place
15
- - [ ] No obvious bugs
16
-
17
- ### Security
18
- - [ ] Input validated and sanitized
19
- - [ ] No SQL/NoSQL injection vulnerabilities
20
- - [ ] No XSS or CSRF vulnerabilities
21
- - [ ] No hardcoded secrets or sensitive credentials
22
- - [ ] **AI-Specific:** Protection against Prompt Injection (if applicable)
23
- - [ ] **AI-Specific:** Outputs are sanitized before being used in critical sinks
24
-
25
- ### Performance
26
- - [ ] No N+1 queries
27
- - [ ] No unnecessary loops
28
- - [ ] Appropriate caching
29
- - [ ] Bundle size impact considered
30
-
31
- ### Code Quality
32
- - [ ] Clear naming
33
- - [ ] DRY - no duplicate code
34
- - [ ] SOLID principles followed
35
- - [ ] Appropriate abstraction level
36
-
37
- ### Testing
38
- - [ ] Unit tests for new code
39
- - [ ] Edge cases tested
40
- - [ ] Tests readable and maintainable
41
-
42
- ### Documentation
43
- - [ ] Complex logic commented
44
- - [ ] Public APIs documented
45
- - [ ] README updated if needed
46
-
47
- ## AI & LLM Review Patterns (2025)
48
-
49
- ### Logic & Hallucinations
50
- - [ ] **Chain of Thought:** Does the logic follow a verifiable path?
51
- - [ ] **Edge Cases:** Did the AI account for empty states, timeouts, and partial failures?
52
- - [ ] **External State:** Is the code making safe assumptions about file systems or networks?
53
-
54
- ### Prompt Engineering Review
55
- ```markdown
56
- // ❌ Vague prompt in code
57
- const response = await ai.generate(userInput);
58
-
59
- // ✅ Structured & Safe prompt
60
- const response = await ai.generate({
61
- system: "You are a specialized parser...",
62
- input: sanitize(userInput),
63
- schema: ResponseSchema
64
- });
65
- ```
66
-
67
- ## Anti-Patterns to Flag
68
-
69
- ```typescript
70
- // ❌ Magic numbers
71
- if (status === 3) { ... }
72
-
73
- // ✅ Named constants
74
- if (status === Status.ACTIVE) { ... }
75
-
76
- // ❌ Deep nesting
77
- if (a) { if (b) { if (c) { ... } } }
78
-
79
- // ✅ Early returns
80
- if (!a) return;
81
- if (!b) return;
82
- if (!c) return;
83
- // do work
84
-
85
- // ❌ Long functions (100+ lines)
86
- // ✅ Small, focused functions
87
-
88
- // ❌ any type
89
- const data: any = ...
90
-
91
- // ✅ Proper types
92
- const data: UserData = ...
93
- ```
94
-
95
- ## Review Comments Guide
96
-
97
- ```
98
- // Blocking issues use 🔴
99
- 🔴 BLOCKING: SQL injection vulnerability here
100
-
101
- // Important suggestions use 🟡
102
- 🟡 SUGGESTION: Consider using useMemo for performance
103
-
104
- // Minor nits use 🟢
105
- 🟢 NIT: Prefer const over let for immutable variable
106
-
107
- // Questions use ❓
108
- ❓ QUESTION: What happens if user is null here?
109
- ```
@@ -1,52 +0,0 @@
1
- ---
2
- name: database-design
3
- description: Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- ---
6
-
7
- # Database Design
8
-
9
- > **Learn to THINK, not copy SQL patterns.**
10
-
11
- ## 🎯 Selective Reading Rule
12
-
13
- **Read ONLY files relevant to the request!** Check the content map, find what you need.
14
-
15
- | File | Description | When to Read |
16
- |------|-------------|--------------|
17
- | `database-selection.md` | PostgreSQL vs Neon vs Turso vs SQLite | Choosing database |
18
- | `orm-selection.md` | Drizzle vs Prisma vs Kysely | Choosing ORM |
19
- | `schema-design.md` | Normalization, PKs, relationships | Designing schema |
20
- | `indexing.md` | Index types, composite indexes | Performance tuning |
21
- | `optimization.md` | N+1, EXPLAIN ANALYZE | Query optimization |
22
- | `migrations.md` | Safe migrations, serverless DBs | Schema changes |
23
-
24
- ---
25
-
26
- ## ⚠️ Core Principle
27
-
28
- - ASK user for database preferences when unclear
29
- - Choose database/ORM based on CONTEXT
30
- - Don't default to PostgreSQL for everything
31
-
32
- ---
33
-
34
- ## Decision Checklist
35
-
36
- Before designing schema:
37
-
38
- - [ ] Asked user about database preference?
39
- - [ ] Chosen database for THIS context?
40
- - [ ] Considered deployment environment?
41
- - [ ] Planned index strategy?
42
- - [ ] Defined relationship types?
43
-
44
- ---
45
-
46
- ## Anti-Patterns
47
-
48
- ❌ Default to PostgreSQL for simple apps (SQLite may suffice)
49
- ❌ Skip indexing
50
- ❌ Use SELECT * in production
51
- ❌ Store JSON when structured data is better
52
- ❌ Ignore N+1 queries