@zenrick/zenkit 0.0.0-stage → 0.5.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 (355) hide show
  1. package/.claude-plugin/marketplace.json +19 -0
  2. package/.cursor-plugin/marketplace.json +22 -0
  3. package/INSTALL.md +73 -0
  4. package/LICENSE +202 -0
  5. package/NOTICE +5 -0
  6. package/README.md +69 -3
  7. package/TERMS.md +48 -0
  8. package/THIRD-PARTY-NOTICES.md +109 -0
  9. package/kit/agents/backend-specialist.md +263 -0
  10. package/kit/agents/code-archaeologist.md +106 -0
  11. package/kit/agents/database-architect.md +226 -0
  12. package/kit/agents/debugger.md +226 -0
  13. package/kit/agents/devops-engineer.md +242 -0
  14. package/kit/agents/documentation-writer.md +104 -0
  15. package/kit/agents/explorer-agent.md +73 -0
  16. package/kit/agents/frontend-specialist.md +593 -0
  17. package/kit/agents/game-developer.md +162 -0
  18. package/kit/agents/mobile-developer.md +377 -0
  19. package/kit/agents/orchestrator.md +489 -0
  20. package/kit/agents/penetration-tester.md +188 -0
  21. package/kit/agents/performance-optimizer.md +187 -0
  22. package/kit/agents/product-manager.md +112 -0
  23. package/kit/agents/product-owner.md +95 -0
  24. package/kit/agents/project-planner.md +409 -0
  25. package/kit/agents/qa-automation-engineer.md +103 -0
  26. package/kit/agents/security-auditor.md +170 -0
  27. package/kit/agents/seo-specialist.md +111 -0
  28. package/kit/agents/test-engineer.md +158 -0
  29. package/kit/bundles/agent-building.yaml +26 -0
  30. package/kit/bundles/backend-data.yaml +14 -0
  31. package/kit/bundles/base.yaml +10 -0
  32. package/kit/bundles/core.yaml +21 -0
  33. package/kit/bundles/kit-engenharia.yaml +8 -0
  34. package/kit/bundles/kit-lite.yaml +9 -0
  35. package/kit/bundles/security.yaml +11 -0
  36. package/kit/bundles/ship-run.yaml +16 -0
  37. package/kit/bundles/web-ui.yaml +18 -0
  38. package/kit/commands/docs.md +33 -0
  39. package/kit/commands/explain.md +41 -0
  40. package/kit/commands/fix.md +65 -0
  41. package/kit/commands/implement.md +35 -0
  42. package/kit/commands/refactor.md +59 -0
  43. package/kit/commands/review.md +55 -0
  44. package/kit/commands/test.md +63 -0
  45. package/kit/modules/bridge/rules/cross-ide-bridge.mdc +73 -0
  46. package/kit/modules/bridge/zenkit-layer.yaml +1 -0
  47. package/kit/modules/nexuscore/sections/convivencia.md +12 -0
  48. package/kit/modules/nexuscore/sections/memoria.md +9 -0
  49. package/kit/modules/nexuscore/skills/quadro-agentes/SKILL.md +186 -0
  50. package/kit/modules/nexuscore/zenkit-layer.yaml +1 -0
  51. package/kit/rules/ZENKIT.mdc +294 -0
  52. package/kit/rules/git.mdc +51 -0
  53. package/kit/rules/karpathy-guidelines.mdc +70 -0
  54. package/kit/rules/model-routing.mdc +89 -0
  55. package/kit/rules/security-headers.mdc +41 -0
  56. package/kit/rules/social-automation.mdc +69 -0
  57. package/kit/rules/toc.mdc +40 -0
  58. package/kit/skills/api-patterns/SKILL.md +95 -0
  59. package/kit/skills/api-patterns/api-style.md +42 -0
  60. package/kit/skills/api-patterns/auth.md +24 -0
  61. package/kit/skills/api-patterns/documentation.md +26 -0
  62. package/kit/skills/api-patterns/graphql.md +41 -0
  63. package/kit/skills/api-patterns/rate-limiting.md +31 -0
  64. package/kit/skills/api-patterns/references/backend/backend-api-design.md +495 -0
  65. package/kit/skills/api-patterns/references/backend/backend-architecture.md +454 -0
  66. package/kit/skills/api-patterns/references/backend/backend-authentication.md +338 -0
  67. package/kit/skills/api-patterns/references/backend/backend-code-quality.md +659 -0
  68. package/kit/skills/api-patterns/references/backend/backend-debugging.md +904 -0
  69. package/kit/skills/api-patterns/references/backend/backend-devops.md +494 -0
  70. package/kit/skills/api-patterns/references/backend/backend-mindset.md +387 -0
  71. package/kit/skills/api-patterns/references/backend/backend-performance.md +397 -0
  72. package/kit/skills/api-patterns/references/backend/backend-security.md +290 -0
  73. package/kit/skills/api-patterns/references/backend/backend-technologies.md +256 -0
  74. package/kit/skills/api-patterns/references/backend/backend-testing.md +429 -0
  75. package/kit/skills/api-patterns/response.md +37 -0
  76. package/kit/skills/api-patterns/rest.md +40 -0
  77. package/kit/skills/api-patterns/scripts/api_validator.py +211 -0
  78. package/kit/skills/api-patterns/security-testing.md +122 -0
  79. package/kit/skills/api-patterns/trpc.md +41 -0
  80. package/kit/skills/api-patterns/versioning.md +22 -0
  81. package/kit/skills/app-builder/SKILL.md +76 -0
  82. package/kit/skills/app-builder/agent-coordination.md +71 -0
  83. package/kit/skills/app-builder/feature-building.md +53 -0
  84. package/kit/skills/app-builder/project-detection.md +34 -0
  85. package/kit/skills/app-builder/scaffolding.md +118 -0
  86. package/kit/skills/app-builder/tech-stack.md +41 -0
  87. package/kit/skills/app-builder/templates/SKILL.md +39 -0
  88. package/kit/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -0
  89. package/kit/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -0
  90. package/kit/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -0
  91. package/kit/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -0
  92. package/kit/skills/app-builder/templates/express-api/TEMPLATE.md +83 -0
  93. package/kit/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -0
  94. package/kit/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -0
  95. package/kit/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -0
  96. package/kit/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -0
  97. package/kit/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -0
  98. package/kit/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -0
  99. package/kit/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -0
  100. package/kit/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -0
  101. package/kit/skills/architecture/SKILL.md +56 -0
  102. package/kit/skills/architecture/context-discovery.md +43 -0
  103. package/kit/skills/architecture/examples.md +94 -0
  104. package/kit/skills/architecture/pattern-selection.md +68 -0
  105. package/kit/skills/architecture/patterns-reference.md +50 -0
  106. package/kit/skills/architecture/trade-off-analysis.md +77 -0
  107. package/kit/skills/bash-linux/SKILL.md +203 -0
  108. package/kit/skills/batch-operations/SKILL.md +112 -0
  109. package/kit/skills/behavioral-modes/SKILL.md +255 -0
  110. package/kit/skills/brainstorming/SKILL.md +189 -0
  111. package/kit/skills/brainstorming/dynamic-questioning.md +350 -0
  112. package/kit/skills/brainstorming/references/problem-solving/attribution.md +69 -0
  113. package/kit/skills/brainstorming/references/problem-solving/collision-zone-thinking.md +79 -0
  114. package/kit/skills/brainstorming/references/problem-solving/inversion-exercise.md +91 -0
  115. package/kit/skills/brainstorming/references/problem-solving/meta-pattern-recognition.md +87 -0
  116. package/kit/skills/brainstorming/references/problem-solving/scale-game.md +95 -0
  117. package/kit/skills/brainstorming/references/problem-solving/simplification-cascades.md +80 -0
  118. package/kit/skills/brainstorming/references/problem-solving/when-stuck.md +72 -0
  119. package/kit/skills/claude-exec/SKILL.md +185 -0
  120. package/kit/skills/clean-code/SKILL.md +210 -0
  121. package/kit/skills/code-review-checklist/SKILL.md +115 -0
  122. package/kit/skills/code-review-graph/SKILL.md +50 -0
  123. package/kit/skills/code-review-graph/references/alternatives-comparison.md +12 -0
  124. package/kit/skills/code-review-graph/references/best-practices.md +9 -0
  125. package/kit/skills/code-review-graph/references/configuration.md +43 -0
  126. package/kit/skills/code-review-graph/references/core-workflows.md +61 -0
  127. package/kit/skills/code-review-graph/references/how-it-works-4-layers.md +20 -0
  128. package/kit/skills/code-review-graph/references/installation.md +67 -0
  129. package/kit/skills/code-review-graph/references/integration-with-zenkit.md +23 -0
  130. package/kit/skills/code-review-graph/references/known-limitations.md +13 -0
  131. package/kit/skills/code-review-graph/references/when-to-use-vs-when-to-skip.md +21 -0
  132. package/kit/skills/codex-exec/SKILL.md +161 -0
  133. package/kit/skills/context-compression/SKILL.md +145 -0
  134. package/kit/skills/coordinator-mode/SKILL.md +215 -0
  135. package/kit/skills/cursor-exec/SKILL.md +152 -0
  136. package/kit/skills/database-design/SKILL.md +53 -0
  137. package/kit/skills/database-design/database-selection.md +43 -0
  138. package/kit/skills/database-design/indexing.md +39 -0
  139. package/kit/skills/database-design/migrations.md +48 -0
  140. package/kit/skills/database-design/optimization.md +36 -0
  141. package/kit/skills/database-design/orm-selection.md +30 -0
  142. package/kit/skills/database-design/schema-design.md +56 -0
  143. package/kit/skills/database-design/scripts/schema_validator.py +172 -0
  144. package/kit/skills/deployment-procedures/SKILL.md +242 -0
  145. package/kit/skills/deprecation-and-migration/SKILL.md +149 -0
  146. package/kit/skills/documentation-templates/SKILL.md +195 -0
  147. package/kit/skills/entrega-com-agentes/SKILL.md +177 -0
  148. package/kit/skills/frontend-design/NOTICE.md +6 -0
  149. package/kit/skills/frontend-design/SKILL.md +456 -0
  150. package/kit/skills/frontend-design/animation-guide.md +331 -0
  151. package/kit/skills/frontend-design/color-system.md +311 -0
  152. package/kit/skills/frontend-design/decision-trees.md +418 -0
  153. package/kit/skills/frontend-design/motion-graphics.md +306 -0
  154. package/kit/skills/frontend-design/references/aesthetic/design-guideline-template.md +163 -0
  155. package/kit/skills/frontend-design/references/aesthetic/design-principles.md +62 -0
  156. package/kit/skills/frontend-design/references/aesthetic/design-resources.md +75 -0
  157. package/kit/skills/frontend-design/references/aesthetic/design-story-template.md +135 -0
  158. package/kit/skills/frontend-design/references/aesthetic/micro-interactions.md +53 -0
  159. package/kit/skills/frontend-design/references/aesthetic/storytelling-design.md +50 -0
  160. package/kit/skills/frontend-design/scripts/accessibility_checker.py +183 -0
  161. package/kit/skills/frontend-design/scripts/ux_audit.py +722 -0
  162. package/kit/skills/frontend-design/typography-system.md +345 -0
  163. package/kit/skills/frontend-design/ux-psychology.md +1116 -0
  164. package/kit/skills/frontend-design/visual-effects.md +383 -0
  165. package/kit/skills/game-development/2d-games/SKILL.md +119 -0
  166. package/kit/skills/game-development/3d-games/SKILL.md +135 -0
  167. package/kit/skills/game-development/SKILL.md +168 -0
  168. package/kit/skills/game-development/game-art/SKILL.md +185 -0
  169. package/kit/skills/game-development/game-audio/SKILL.md +190 -0
  170. package/kit/skills/game-development/game-design/SKILL.md +129 -0
  171. package/kit/skills/game-development/mobile-games/SKILL.md +108 -0
  172. package/kit/skills/game-development/multiplayer/SKILL.md +132 -0
  173. package/kit/skills/game-development/pc-games/SKILL.md +144 -0
  174. package/kit/skills/game-development/vr-ar/SKILL.md +123 -0
  175. package/kit/skills/game-development/web-games/SKILL.md +150 -0
  176. package/kit/skills/gemini-exec/SKILL.md +80 -0
  177. package/kit/skills/geo-fundamentals/SKILL.md +157 -0
  178. package/kit/skills/geo-fundamentals/scripts/geo_checker.py +289 -0
  179. package/kit/skills/git-worktrees/SKILL.md +107 -0
  180. package/kit/skills/i18n-localization/SKILL.md +145 -0
  181. package/kit/skills/i18n-localization/scripts/i18n_checker.py +241 -0
  182. package/kit/skills/intelligent-routing/SKILL.md +128 -0
  183. package/kit/skills/intelligent-routing/references/4-response-format.md +16 -0
  184. package/kit/skills/intelligent-routing/references/complexity-assessment.md +29 -0
  185. package/kit/skills/intelligent-routing/references/debug-intelligent-routing.md +9 -0
  186. package/kit/skills/intelligent-routing/references/debugging-agent-selection.md +7 -0
  187. package/kit/skills/intelligent-routing/references/domain-detection-rules.md +29 -0
  188. package/kit/skills/intelligent-routing/references/edge-cases.md +29 -0
  189. package/kit/skills/intelligent-routing/references/implementation-rules.md +35 -0
  190. package/kit/skills/intelligent-routing/references/integration-with-existing-workflows.md +21 -0
  191. package/kit/skills/intelligent-routing/references/performance-considerations.md +14 -0
  192. package/kit/skills/intelligent-routing/references/summary.md +16 -0
  193. package/kit/skills/intelligent-routing/references/testing-the-system.md +36 -0
  194. package/kit/skills/intelligent-routing/references/tier-0-automatic-analysis-always-active.md +27 -0
  195. package/kit/skills/intelligent-routing/references/user-education.md +12 -0
  196. package/kit/skills/karpathy-guidelines/SKILL.md +67 -0
  197. package/kit/skills/karpathy-guidelines/references/EXAMPLES.md +522 -0
  198. package/kit/skills/lint-and-validate/SKILL.md +46 -0
  199. package/kit/skills/lint-and-validate/scripts/lint_runner.py +184 -0
  200. package/kit/skills/lint-and-validate/scripts/type_coverage.py +173 -0
  201. package/kit/skills/mcp-atuacao/SKILL.md +238 -0
  202. package/kit/skills/mcp-builder/NOTICE.md +6 -0
  203. package/kit/skills/mcp-builder/SKILL.md +259 -0
  204. package/kit/skills/memory-system/SKILL.md +181 -0
  205. package/kit/skills/mobile-design/SKILL.md +395 -0
  206. package/kit/skills/mobile-design/decision-trees.md +516 -0
  207. package/kit/skills/mobile-design/mobile-backend.md +491 -0
  208. package/kit/skills/mobile-design/mobile-color-system.md +420 -0
  209. package/kit/skills/mobile-design/mobile-debugging.md +122 -0
  210. package/kit/skills/mobile-design/mobile-design-thinking.md +357 -0
  211. package/kit/skills/mobile-design/mobile-navigation.md +458 -0
  212. package/kit/skills/mobile-design/mobile-performance.md +767 -0
  213. package/kit/skills/mobile-design/mobile-testing.md +356 -0
  214. package/kit/skills/mobile-design/mobile-typography.md +433 -0
  215. package/kit/skills/mobile-design/platform-android.md +666 -0
  216. package/kit/skills/mobile-design/platform-ios.md +561 -0
  217. package/kit/skills/mobile-design/scripts/mobile_audit.py +670 -0
  218. package/kit/skills/mobile-design/touch-psychology.md +537 -0
  219. package/kit/skills/negocio-agente-conversa/SKILL.md +168 -0
  220. package/kit/skills/negocio-atendimento/SKILL.md +134 -0
  221. package/kit/skills/negocio-linguagem/SKILL.md +166 -0
  222. package/kit/skills/negocio-preco/SKILL.md +174 -0
  223. package/kit/skills/negocio-preco/scripts/preco.mjs +160 -0
  224. package/kit/skills/negocio-qualificacao/SKILL.md +140 -0
  225. package/kit/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +351 -0
  226. package/kit/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +240 -0
  227. package/kit/skills/nextjs-react-expert/3-server-server-side-performance.md +490 -0
  228. package/kit/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +264 -0
  229. package/kit/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +581 -0
  230. package/kit/skills/nextjs-react-expert/6-rendering-rendering-performance.md +432 -0
  231. package/kit/skills/nextjs-react-expert/7-js-javascript-performance.md +684 -0
  232. package/kit/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +150 -0
  233. package/kit/skills/nextjs-react-expert/9-cache-components.md +103 -0
  234. package/kit/skills/nextjs-react-expert/SKILL.md +308 -0
  235. package/kit/skills/nextjs-react-expert/resources/app-patterns/common-patterns.md +331 -0
  236. package/kit/skills/nextjs-react-expert/resources/app-patterns/complete-examples.md +872 -0
  237. package/kit/skills/nextjs-react-expert/resources/app-patterns/component-patterns.md +502 -0
  238. package/kit/skills/nextjs-react-expert/resources/app-patterns/data-fetching.md +767 -0
  239. package/kit/skills/nextjs-react-expert/resources/app-patterns/file-organization.md +502 -0
  240. package/kit/skills/nextjs-react-expert/resources/app-patterns/loading-and-error-states.md +501 -0
  241. package/kit/skills/nextjs-react-expert/resources/app-patterns/performance.md +406 -0
  242. package/kit/skills/nextjs-react-expert/resources/app-patterns/routing-guide.md +364 -0
  243. package/kit/skills/nextjs-react-expert/resources/app-patterns/styling-guide.md +428 -0
  244. package/kit/skills/nextjs-react-expert/resources/app-patterns/typescript-standards.md +418 -0
  245. package/kit/skills/nextjs-react-expert/scripts/convert_rules.py +222 -0
  246. package/kit/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -0
  247. package/kit/skills/nodejs-best-practices/SKILL.md +78 -0
  248. package/kit/skills/nodejs-best-practices/references/10-anti-patterns-to-avoid.md +21 -0
  249. package/kit/skills/nodejs-best-practices/references/11-decision-checklist.md +14 -0
  250. package/kit/skills/nodejs-best-practices/references/2-runtime-considerations-2025.md +36 -0
  251. package/kit/skills/nodejs-best-practices/references/3-architecture-principles.md +35 -0
  252. package/kit/skills/nodejs-best-practices/references/4-error-handling-principles.md +42 -0
  253. package/kit/skills/nodejs-best-practices/references/5-async-patterns-principles.md +35 -0
  254. package/kit/skills/nodejs-best-practices/references/6-validation-principles.md +29 -0
  255. package/kit/skills/nodejs-best-practices/references/7-security-principles.md +29 -0
  256. package/kit/skills/nodejs-best-practices/references/8-testing-principles.md +28 -0
  257. package/kit/skills/observability-and-instrumentation/SKILL.md +150 -0
  258. package/kit/skills/opencode-go-exec/SKILL.md +101 -0
  259. package/kit/skills/parallel-agents/SKILL.md +184 -0
  260. package/kit/skills/performance-profiling/SKILL.md +145 -0
  261. package/kit/skills/performance-profiling/scripts/lighthouse_audit.py +76 -0
  262. package/kit/skills/plan-writing/SKILL.md +213 -0
  263. package/kit/skills/powershell-windows/SKILL.md +196 -0
  264. package/kit/skills/provider-orchestration/SKILL.md +269 -0
  265. package/kit/skills/python-patterns/SKILL.md +80 -0
  266. package/kit/skills/python-patterns/references/10-decision-checklist.md +14 -0
  267. package/kit/skills/python-patterns/references/11-anti-patterns-to-avoid.md +20 -0
  268. package/kit/skills/python-patterns/references/2-async-vs-sync-decision.md +44 -0
  269. package/kit/skills/python-patterns/references/3-type-hints-strategy.md +56 -0
  270. package/kit/skills/python-patterns/references/4-project-structure-principles.md +56 -0
  271. package/kit/skills/python-patterns/references/5-django-principles-2025.md +40 -0
  272. package/kit/skills/python-patterns/references/6-fastapi-principles.md +50 -0
  273. package/kit/skills/python-patterns/references/7-background-tasks.md +31 -0
  274. package/kit/skills/python-patterns/references/8-error-handling-principles.md +29 -0
  275. package/kit/skills/python-patterns/references/9-testing-principles.md +37 -0
  276. package/kit/skills/red-team-tactics/SKILL.md +201 -0
  277. package/kit/skills/research/SKILL.md +166 -0
  278. package/kit/skills/rust-pro/SKILL.md +177 -0
  279. package/kit/skills/seo-fundamentals/SKILL.md +130 -0
  280. package/kit/skills/seo-fundamentals/scripts/seo_checker.py +219 -0
  281. package/kit/skills/sequential-thinking/.env.example +8 -0
  282. package/kit/skills/sequential-thinking/README.md +183 -0
  283. package/kit/skills/sequential-thinking/SKILL.md +95 -0
  284. package/kit/skills/sequential-thinking/package.json +31 -0
  285. package/kit/skills/sequential-thinking/references/advanced-strategies.md +79 -0
  286. package/kit/skills/sequential-thinking/references/advanced-techniques.md +76 -0
  287. package/kit/skills/sequential-thinking/references/core-patterns.md +95 -0
  288. package/kit/skills/sequential-thinking/references/examples-api.md +88 -0
  289. package/kit/skills/sequential-thinking/references/examples-architecture.md +94 -0
  290. package/kit/skills/sequential-thinking/references/examples-debug.md +90 -0
  291. package/kit/skills/sequential-thinking/scripts/format-thought.js +159 -0
  292. package/kit/skills/sequential-thinking/scripts/process-thought.js +236 -0
  293. package/kit/skills/server-management/SKILL.md +162 -0
  294. package/kit/skills/simplify-code/SKILL.md +133 -0
  295. package/kit/skills/skillify/SKILL.md +116 -0
  296. package/kit/skills/system-design-interview/SKILL.md +268 -0
  297. package/kit/skills/systematic-debugging/SKILL.md +110 -0
  298. package/kit/skills/tailwind-patterns/SKILL.md +283 -0
  299. package/kit/skills/tailwind-patterns/references/shadcn-ui/canvas-design-system.md +320 -0
  300. package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-accessibility.md +471 -0
  301. package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-components.md +424 -0
  302. package/kit/skills/tailwind-patterns/references/shadcn-ui/shadcn-theming.md +373 -0
  303. package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-customization.md +483 -0
  304. package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-responsive.md +382 -0
  305. package/kit/skills/tailwind-patterns/references/shadcn-ui/tailwind-utilities.md +455 -0
  306. package/kit/skills/tdd-workflow/SKILL.md +150 -0
  307. package/kit/skills/testing-patterns/SKILL.md +196 -0
  308. package/kit/skills/testing-patterns/scripts/test_runner.py +219 -0
  309. package/kit/skills/ui-ux-pro-max/SKILL.md +135 -0
  310. package/kit/skills/verify-changes/SKILL.md +125 -0
  311. package/kit/skills/vulnerability-scanner/SKILL.md +278 -0
  312. package/kit/skills/vulnerability-scanner/checklists.md +121 -0
  313. package/kit/skills/vulnerability-scanner/scripts/security_scan.py +458 -0
  314. package/kit/skills/web-design-guidelines/SKILL.md +58 -0
  315. package/kit/skills/webapp-testing/NOTICE.md +6 -0
  316. package/kit/skills/webapp-testing/SKILL.md +188 -0
  317. package/kit/skills/webapp-testing/scripts/playwright_runner.py +173 -0
  318. package/kit/workflows/brainstorm.md +113 -0
  319. package/kit/workflows/coordinate.md +72 -0
  320. package/kit/workflows/create.md +59 -0
  321. package/kit/workflows/debug.md +103 -0
  322. package/kit/workflows/deploy.md +176 -0
  323. package/kit/workflows/enhance.md +63 -0
  324. package/kit/workflows/orchestrate.md +237 -0
  325. package/kit/workflows/plan.md +89 -0
  326. package/kit/workflows/preview.md +81 -0
  327. package/kit/workflows/remember.md +67 -0
  328. package/kit/workflows/status.md +86 -0
  329. package/kit/workflows/test.md +144 -0
  330. package/kit/workflows/ui-ux-pro-max.md +296 -0
  331. package/kit/workflows/verify.md +72 -0
  332. package/licenses/Apache-2.0.txt +202 -0
  333. package/package.json +60 -6
  334. package/scripts/archive-codex-rollouts.ps1 +35 -0
  335. package/scripts/avaliar-vigilancia-mandato.mjs +38 -0
  336. package/scripts/bundle.mjs +170 -0
  337. package/scripts/check-deps.mjs +178 -0
  338. package/scripts/check-models.mjs +150 -0
  339. package/scripts/cli.mjs +313 -0
  340. package/scripts/content-checks.mjs +18 -0
  341. package/scripts/continuidade-mandato.mjs +47 -0
  342. package/scripts/discriminar-turno.mjs +191 -0
  343. package/scripts/doctor.mjs +611 -0
  344. package/scripts/generate.mjs +688 -0
  345. package/scripts/install.mjs +11 -0
  346. package/scripts/layer-remote.mjs +407 -0
  347. package/scripts/layers.mjs +208 -0
  348. package/scripts/marketplace.mjs +77 -0
  349. package/scripts/product.mjs +32 -0
  350. package/scripts/ruleset-core.mjs +68 -0
  351. package/scripts/social-hooks.mjs +293 -0
  352. package/scripts/social-pacer.mjs +219 -0
  353. package/scripts/validate-bundles.mjs +14 -0
  354. package/scripts/validate-skills.mjs +174 -0
  355. package/scripts/zenkit-daemon-task.cmd +3 -0
@@ -0,0 +1,196 @@
1
+ ---
2
+ name: testing-patterns
3
+ description: Testing patterns and principles. Unit, integration, mocking strategies.
4
+ when_to_use: "When writing unit tests, integration tests, choosing testing frameworks, or implementing mocking strategies."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
6
+ ---
7
+
8
+ # Testing Patterns
9
+
10
+ > Principles for reliable test suites.
11
+
12
+ ---
13
+
14
+ ## 1. Testing Pyramid
15
+
16
+ ```
17
+ /\ E2E (Few)
18
+ / \ Critical flows
19
+ /----\
20
+ / \ Integration (Some)
21
+ /--------\ API, DB queries
22
+ / \
23
+ /------------\ Unit (Many)
24
+ Functions, classes
25
+ ```
26
+
27
+ ---
28
+
29
+ ## 2. AAA Pattern
30
+
31
+ | Step | Purpose |
32
+ |------|---------|
33
+ | **Arrange** | Set up test data |
34
+ | **Act** | Execute code under test |
35
+ | **Assert** | Verify outcome |
36
+
37
+ ---
38
+
39
+ ## 3. Test Type Selection
40
+
41
+ ### When to Use Each
42
+
43
+ | Type | Best For | Speed |
44
+ |------|----------|-------|
45
+ | **Unit** | Pure functions, logic | Fast (<50ms) |
46
+ | **Integration** | API, DB, services | Medium |
47
+ | **E2E** | Critical user flows | Slow |
48
+
49
+ ---
50
+
51
+ ## 4. Unit Test Principles
52
+
53
+ ### Good Unit Tests
54
+
55
+ | Principle | Meaning |
56
+ |-----------|---------|
57
+ | Fast | < 100ms each |
58
+ | Isolated | No external deps |
59
+ | Repeatable | Same result always |
60
+ | Self-checking | No manual verification |
61
+ | Timely | Written with code |
62
+
63
+ ### What to Unit Test
64
+
65
+ | Test | Don't Test |
66
+ |------|------------|
67
+ | Business logic | Framework code |
68
+ | Edge cases | Third-party libs |
69
+ | Error handling | Simple getters |
70
+
71
+ ---
72
+
73
+ ## 5. Integration Test Principles
74
+
75
+ ### What to Test
76
+
77
+ | Area | Focus |
78
+ |------|-------|
79
+ | API endpoints | Request/response |
80
+ | Database | Queries, transactions |
81
+ | External services | Contracts |
82
+
83
+ ### Setup/Teardown
84
+
85
+ | Phase | Action |
86
+ |-------|--------|
87
+ | Before All | Connect resources |
88
+ | Before Each | Reset state |
89
+ | After Each | Clean up |
90
+ | After All | Disconnect |
91
+
92
+ ---
93
+
94
+ ## 6. Mocking Principles
95
+
96
+ ### When to Mock
97
+
98
+ | Mock | Don't Mock |
99
+ |------|------------|
100
+ | External third-party APIs | The code under test |
101
+ | Slow I/O (in unit tests) | In-memory fakes / domain logic |
102
+ | Time/clock | Pure functions |
103
+ | Unreliable network | Deterministic adapters |
104
+
105
+ ### Mock Types
106
+
107
+ | Type | Use |
108
+ |------|-----|
109
+ | Stub | Return fixed values |
110
+ | Spy | Track calls |
111
+ | Mock | Set expectations |
112
+ | Fake | Simplified implementation |
113
+
114
+ ---
115
+
116
+ ## 7. Test Organization
117
+
118
+ ### Naming
119
+
120
+ | Pattern | Example |
121
+ |---------|---------|
122
+ | Should behavior | "should return error when..." |
123
+ | When condition | "when user not found..." |
124
+ | Given-when-then | "given X, when Y, then Z" |
125
+
126
+ ### Grouping
127
+
128
+ | Level | Use |
129
+ |-------|-----|
130
+ | describe | Group related tests |
131
+ | it/test | Individual case |
132
+ | beforeEach | Common setup |
133
+
134
+ ---
135
+
136
+ ## 8. Test Data
137
+
138
+ ### Strategies
139
+
140
+ | Approach | Use |
141
+ |----------|-----|
142
+ | Factories | Generate test data |
143
+ | Fixtures | Predefined datasets |
144
+ | Builders | Fluent object creation |
145
+
146
+ ### Principles
147
+
148
+ - Use realistic, deterministic data
149
+ - Use fixed seeds if using generators (fuzzing/property tests only)
150
+ - Avoid unseeded random values (causes flaky CI runs)
151
+ - Share common fixtures
152
+ - Keep data minimal
153
+
154
+ ---
155
+
156
+ ## 9. Best Practices
157
+
158
+ | Practice | Why |
159
+ |----------|-----|
160
+ | One logical concept per test | Clear failure reason without artificial assert line limits |
161
+ | Independent tests | No order dependency |
162
+ | Fast tests | Run frequently |
163
+ | Descriptive names | Self-documenting |
164
+ | Clean up | Avoid side effects |
165
+
166
+ ---
167
+
168
+ ## 10. Anti-Patterns
169
+
170
+ | ❌ Don't | ✅ Do |
171
+ |----------|-------|
172
+ | Test implementation | Test behavior |
173
+ | Duplicate test code | Use factories |
174
+ | Complex test setup | Simplify or split |
175
+ | Ignore flaky tests | Fix root cause |
176
+ | Skip cleanup | Reset state |
177
+
178
+ ---
179
+
180
+ > **Remember:** Tests are documentation. If someone can't understand what the code does from the tests, rewrite them.
181
+
182
+ ---
183
+
184
+ ## Receita Node: três níveis
185
+
186
+ Exemplo executável em [`examples/node-testing-recipe`](../../../examples/node-testing-recipe/README.md) (fora dos workspaces `packages/*`).
187
+
188
+ | Nível | Pasta / artefato | Runner / ferramenta | O que valida |
189
+ |-------|------------------|---------------------|--------------|
190
+ | Unitário | `test/unit/*.test.js` | `node --test` + `node:assert/strict` | Validação e domínio sem I/O externo |
191
+ | Integração | `test/integration/*.test.js` | `node --test` + supertest + Postgres (`DATABASE_URL`) | HTTP + SQL real; skip explícito sem banco |
192
+ | Carga | `load/payments.k6.js` | k6 (20 VUs, 30s) | Latência e taxa de erro sob carga |
193
+
194
+ Pirâmide do exemplo: **muitos** testes unitários rápidos, **alguns** de integração com infraestrutura real, **poucos** scripts de carga para SLO.
195
+
196
+ O exemplo usa o runner nativo **`node --test`**. No vídeo de referência a transcrição automática registrou o nome **"Poco"**; **Poku** é citado como alternativa de runner Node, mas o **nome não foi confirmado no vídeo** (não afirmar confirmação).
@@ -0,0 +1,219 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Test Runner - Unified test execution and coverage reporting
4
+ Runs tests and generates coverage report based on project type.
5
+
6
+ Usage:
7
+ python test_runner.py <project_path> [--coverage]
8
+
9
+ Supports:
10
+ - Node.js: npm test, jest, vitest
11
+ - Python: pytest, unittest
12
+ """
13
+
14
+ import subprocess
15
+ import sys
16
+ import json
17
+ from pathlib import Path
18
+ from datetime import datetime
19
+
20
+ # Fix Windows console encoding
21
+ try:
22
+ sys.stdout.reconfigure(encoding='utf-8', errors='replace')
23
+ except:
24
+ pass
25
+
26
+
27
+ def detect_test_framework(project_path: Path) -> dict:
28
+ """Detect test framework and commands."""
29
+ result = {
30
+ "type": "unknown",
31
+ "framework": None,
32
+ "cmd": None,
33
+ "coverage_cmd": None
34
+ }
35
+
36
+ # Node.js project
37
+ package_json = project_path / "package.json"
38
+ if package_json.exists():
39
+ result["type"] = "node"
40
+ try:
41
+ pkg = json.loads(package_json.read_text(encoding='utf-8'))
42
+ scripts = pkg.get("scripts", {})
43
+ deps = {**pkg.get("dependencies", {}), **pkg.get("devDependencies", {})}
44
+
45
+ # Check for test script
46
+ if "test" in scripts:
47
+ result["framework"] = "npm test"
48
+ result["cmd"] = ["npm", "test"]
49
+
50
+ # Try to detect specific framework for coverage
51
+ if "vitest" in deps:
52
+ result["framework"] = "vitest"
53
+ result["coverage_cmd"] = ["npx", "vitest", "run", "--coverage"]
54
+ elif "jest" in deps:
55
+ result["framework"] = "jest"
56
+ result["coverage_cmd"] = ["npx", "jest", "--coverage"]
57
+ elif "vitest" in deps:
58
+ result["framework"] = "vitest"
59
+ result["cmd"] = ["npx", "vitest", "run"]
60
+ result["coverage_cmd"] = ["npx", "vitest", "run", "--coverage"]
61
+ elif "jest" in deps:
62
+ result["framework"] = "jest"
63
+ result["cmd"] = ["npx", "jest"]
64
+ result["coverage_cmd"] = ["npx", "jest", "--coverage"]
65
+
66
+ except:
67
+ pass
68
+
69
+ # Python project
70
+ if (project_path / "pyproject.toml").exists() or (project_path / "requirements.txt").exists():
71
+ result["type"] = "python"
72
+ result["framework"] = "pytest"
73
+ result["cmd"] = ["python", "-m", "pytest", "-v"]
74
+ result["coverage_cmd"] = ["python", "-m", "pytest", "--cov", "--cov-report=term-missing"]
75
+
76
+ return result
77
+
78
+
79
+ def run_tests(cmd: list, cwd: Path) -> dict:
80
+ """Run tests and return results."""
81
+ result = {
82
+ "passed": False,
83
+ "output": "",
84
+ "error": "",
85
+ "tests_run": 0,
86
+ "tests_passed": 0,
87
+ "tests_failed": 0
88
+ }
89
+
90
+ try:
91
+ proc = subprocess.run(
92
+ cmd,
93
+ cwd=str(cwd),
94
+ capture_output=True,
95
+ text=True,
96
+ encoding='utf-8',
97
+ errors='replace',
98
+ timeout=300 # 5 min timeout for tests
99
+ )
100
+
101
+ result["output"] = proc.stdout[:3000] if proc.stdout else ""
102
+ result["error"] = proc.stderr[:500] if proc.stderr else ""
103
+ result["passed"] = proc.returncode == 0
104
+
105
+ # Try to parse test counts from output
106
+ output = proc.stdout or ""
107
+
108
+ # Jest/Vitest pattern: "Tests: X passed, Y failed, Z total"
109
+ if "passed" in output.lower() and "failed" in output.lower():
110
+ import re
111
+ match = re.search(r'(\d+)\s+passed', output, re.IGNORECASE)
112
+ if match:
113
+ result["tests_passed"] = int(match.group(1))
114
+ match = re.search(r'(\d+)\s+failed', output, re.IGNORECASE)
115
+ if match:
116
+ result["tests_failed"] = int(match.group(1))
117
+ result["tests_run"] = result["tests_passed"] + result["tests_failed"]
118
+
119
+ # Pytest pattern: "X passed, Y failed"
120
+ if "pytest" in str(cmd):
121
+ import re
122
+ match = re.search(r'(\d+)\s+passed', output)
123
+ if match:
124
+ result["tests_passed"] = int(match.group(1))
125
+ match = re.search(r'(\d+)\s+failed', output)
126
+ if match:
127
+ result["tests_failed"] = int(match.group(1))
128
+ result["tests_run"] = result["tests_passed"] + result["tests_failed"]
129
+
130
+ except FileNotFoundError:
131
+ result["error"] = f"Command not found: {cmd[0]}"
132
+ except subprocess.TimeoutExpired:
133
+ result["error"] = "Timeout after 300s"
134
+ except Exception as e:
135
+ result["error"] = str(e)
136
+
137
+ return result
138
+
139
+
140
+ def main():
141
+ project_path = Path(sys.argv[1] if len(sys.argv) > 1 else ".").resolve()
142
+ with_coverage = "--coverage" in sys.argv
143
+
144
+ print(f"\n{'='*60}")
145
+ print(f"[TEST RUNNER] Unified Test Execution")
146
+ print(f"{'='*60}")
147
+ print(f"Project: {project_path}")
148
+ print(f"Coverage: {'enabled' if with_coverage else 'disabled'}")
149
+ print(f"Time: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
150
+
151
+ # Detect test framework
152
+ test_info = detect_test_framework(project_path)
153
+ print(f"Type: {test_info['type']}")
154
+ print(f"Framework: {test_info['framework']}")
155
+ print("-"*60)
156
+
157
+ if not test_info["cmd"]:
158
+ print("No test framework found for this project.")
159
+ output = {
160
+ "script": "test_runner",
161
+ "project": str(project_path),
162
+ "type": test_info["type"],
163
+ "framework": None,
164
+ "passed": True,
165
+ "message": "No tests configured"
166
+ }
167
+ print(json.dumps(output, indent=2))
168
+ sys.exit(0)
169
+
170
+ # Choose command
171
+ cmd = test_info["coverage_cmd"] if with_coverage and test_info["coverage_cmd"] else test_info["cmd"]
172
+
173
+ print(f"Running: {' '.join(cmd)}")
174
+ print("-"*60)
175
+
176
+ # Run tests
177
+ result = run_tests(cmd, project_path)
178
+
179
+ # Print output (truncated)
180
+ if result["output"]:
181
+ lines = result["output"].split("\n")
182
+ for line in lines[:30]:
183
+ print(line)
184
+ if len(lines) > 30:
185
+ print(f"... ({len(lines) - 30} more lines)")
186
+
187
+ # Summary
188
+ print("\n" + "="*60)
189
+ print("SUMMARY")
190
+ print("="*60)
191
+
192
+ if result["passed"]:
193
+ print("[PASS] All tests passed")
194
+ else:
195
+ print("[FAIL] Some tests failed")
196
+ if result["error"]:
197
+ print(f"Error: {result['error'][:200]}")
198
+
199
+ if result["tests_run"] > 0:
200
+ print(f"Tests: {result['tests_run']} total, {result['tests_passed']} passed, {result['tests_failed']} failed")
201
+
202
+ output = {
203
+ "script": "test_runner",
204
+ "project": str(project_path),
205
+ "type": test_info["type"],
206
+ "framework": test_info["framework"],
207
+ "tests_run": result["tests_run"],
208
+ "tests_passed": result["tests_passed"],
209
+ "tests_failed": result["tests_failed"],
210
+ "passed": result["passed"]
211
+ }
212
+
213
+ print("\n" + json.dumps(output, indent=2))
214
+
215
+ sys.exit(0 if result["passed"] else 1)
216
+
217
+
218
+ if __name__ == "__main__":
219
+ main()
@@ -0,0 +1,135 @@
1
+ ---
2
+ name: ui-ux-pro-max
3
+ description: Native UI/UX design intelligence skill with design-system generation, style/palette/typography search, and stack-specific implementation guidance.
4
+ when_to_use: "When the user asks to design, improve, review, modernize, or implement UI/UX for web/mobile screens and components. Use for layout, visual hierarchy, colors, typography, interaction polish, and responsive refinements."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
6
+ version: 1.0.0
7
+ ---
8
+
9
+ # UI/UX Pro Max (Native Skill)
10
+
11
+ Use this skill to apply the `ui-ux-pro-max` workflow as a first-class native skill in Cursor.
12
+
13
+ ## Source of truth
14
+
15
+ - Workflow reference: `.cursor/workflows/ui-ux-pro-max.md`
16
+ - Runtime engine: `.cursor/.shared/ui-ux-pro-max/scripts/search.py`
17
+
18
+ If this skill and workflow diverge, prioritize the workflow file and keep this skill updated.
19
+
20
+ ---
21
+
22
+ ## Prerequisites
23
+
24
+ Verify Python availability before running searches:
25
+
26
+ ```bash
27
+ python3 --version || python --version
28
+ ```
29
+
30
+ If Python is unavailable on Windows:
31
+
32
+ ```powershell
33
+ winget install Python.Python.3.12
34
+ ```
35
+
36
+ ---
37
+
38
+ ## Mandatory execution flow
39
+
40
+ For any UI/UX request, follow this sequence:
41
+
42
+ 1. **Classify request**
43
+ - Product type (SaaS, dashboard, CRM, landing, e-commerce, etc.)
44
+ - Industry/context
45
+ - Desired style keywords (minimal, premium, playful, dark, etc.)
46
+ - Target stack (if not provided, default to `html-tailwind`)
47
+
48
+ 2. **Generate design system first (required)**
49
+
50
+ ```bash
51
+ python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system -p "<Project Name>"
52
+ ```
53
+
54
+ 3. **Optional persistence for cross-session consistency**
55
+
56
+ ```bash
57
+ python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "<Project Name>"
58
+ ```
59
+
60
+ With page overrides:
61
+
62
+ ```bash
63
+ python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "<Project Name>" --page "<page-name>"
64
+ ```
65
+
66
+ 4. **Supplementary domain searches (as needed)**
67
+
68
+ ```bash
69
+ python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
70
+ ```
71
+
72
+ Domains:
73
+ - `product`, `style`, `typography`, `color`, `landing`, `chart`, `ux`, `react`, `web`, `prompt`
74
+
75
+ 5. **Stack-specific guidance**
76
+
77
+ ```bash
78
+ python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "<keyword>" --stack <stack>
79
+ ```
80
+
81
+ Stacks:
82
+ - `html-tailwind` (default), `react`, `nextjs`, `vue`, `svelte`, `swiftui`, `react-native`, `flutter`, `shadcn`, `jetpack-compose`
83
+
84
+ 6. **Implement and validate**
85
+ - Apply design tokens, spacing system, hierarchy, and interaction feedback.
86
+ - Ensure responsive behavior and accessibility states.
87
+ - Run project lint/type/build checks after changes.
88
+
89
+ ---
90
+
91
+ ## Core quality guardrails
92
+
93
+ - No emoji as UI icon; use SVG icon sets consistently.
94
+ - Clear hover/focus states without layout shift.
95
+ - High contrast in light mode text and borders.
96
+ - Respect `prefers-reduced-motion`.
97
+ - Keep component spacing and container widths consistent.
98
+
99
+ ---
100
+
101
+ ## Recommended command templates
102
+
103
+ ### Full design-system (default terminal format)
104
+
105
+ ```bash
106
+ python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "crm dashboard support operations modern professional" --design-system -p "SaaS Dashboard"
107
+ ```
108
+
109
+ ### Markdown output
110
+
111
+ ```bash
112
+ python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "crm dashboard support operations modern professional" --design-system -f markdown -p "SaaS Dashboard"
113
+ ```
114
+
115
+ ### UX deep dive
116
+
117
+ ```bash
118
+ python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "animation accessibility focus states loading feedback" --domain ux
119
+ ```
120
+
121
+ ### React stack recommendations
122
+
123
+ ```bash
124
+ python3 .cursor/.shared/ui-ux-pro-max/scripts/search.py "layout responsive forms stateful lists" --stack react
125
+ ```
126
+
127
+ ---
128
+
129
+ ## Integration note
130
+
131
+ This skill is intentionally thin and operational. It delegates detailed design intelligence to:
132
+ - `.cursor/workflows/ui-ux-pro-max.md`
133
+ - `.cursor/.shared/ui-ux-pro-max/*`
134
+
135
+ Keep these paths stable so Cursor can use `ui-ux-pro-max` natively through this skill.
@@ -0,0 +1,125 @@
1
+ ---
2
+ name: verify-changes
3
+ description: Prove code works by running it, not just checking it exists. Verification through execution rather than inspection. Use after writing or modifying code to ensure it actually functions correctly.
4
+ when_to_use: "After writing code, completing a feature, or fixing a bug. When the user says 'does this work?', 'test this', 'verify', or when /verify workflow is invoked. NOT for writing new code — for proving existing code works."
5
+ allowed-tools: Read, Bash, Grep, Glob
6
+ effort: medium
7
+ ---
8
+
9
+ # Verify Changes — Prove Code Works
10
+
11
+ > "Code that exists" ≠ "Code that works." This skill ensures changes are verified through execution.
12
+
13
+ ## Core Principle
14
+
15
+ ```
16
+ ❌ Verification by inspection: "I can see the function exists, it should work"
17
+ ❌ Verification by assumption: "The types check out, so it's correct"
18
+ ✅ Verification by execution: "I ran it, here's the output, it works because [evidence]"
19
+ ```
20
+
21
+ ---
22
+
23
+ ## Verification Protocol
24
+
25
+ ### Step 1: Identify What Changed
26
+ ```
27
+ - Which files were modified?
28
+ - What behavior should be different now?
29
+ - What was the original bug/requirement?
30
+ ```
31
+
32
+ ### Step 2: Determine Verification Method
33
+
34
+ | Change Type | Verification Method |
35
+ |---|---|
36
+ | **Bug fix** | Reproduce the original bug scenario → confirm it no longer occurs |
37
+ | **New feature** | Run the feature → confirm expected output |
38
+ | **Refactor** | Run existing tests → confirm nothing broke |
39
+ | **API change** | Call the endpoint → confirm response shape |
40
+ | **UI change** | Render the component → confirm visual output |
41
+ | **Config change** | Load the config → confirm values applied |
42
+ | **Build/infra** | Run build command → confirm success |
43
+
44
+ ### Step 3: Execute Verification
45
+
46
+ Execute automated commands and capture actual exit codes and output:
47
+ ```bash
48
+ # Compile and typecheck
49
+ npm run build # Must exit 0
50
+
51
+ # Test suites
52
+ npm run test # All tests must pass (exit 0)
53
+
54
+ # Targeted component/unit validation
55
+ npx vitest run path/to/changed.test.ts
56
+
57
+ # API contract check (assert status and body)
58
+ curl -sS -f http://localhost:3000/api/endpoint
59
+ ```
60
+
61
+ ### Step 4: Report Evidence
62
+
63
+ Tie every verification claim to an immutable Git SHA and raw command evidence:
64
+
65
+ ```markdown
66
+ ## Verification Report
67
+
68
+ ### Target Context
69
+ - Repository / Worktree: [Path or isolated worktree]
70
+ - Commit / Head SHA: `[git rev-parse --short HEAD]`
71
+
72
+ ### Executed Commands & Exit Codes
73
+ - Build: `npm run build` → exit code 0
74
+ - Unit/E2E: `npm run test` → exit code 0 (42/42 passed)
75
+ - API/Runtime: `curl -f ...` → HTTP 200 OK with expected JSON payload
76
+
77
+ ### Non-Verifiable Items & Escalation
78
+ - [List any gaps requiring manual user testing or external credentials]
79
+ ```
80
+
81
+ ---
82
+
83
+ ## Verification Checklist by Project Type
84
+
85
+ ### Web Application
86
+ - [ ] `npm run build` — compiles without errors
87
+ - [ ] `npm run lint` — no linting errors
88
+ - [ ] `npm run test` — all tests pass
89
+ - [ ] Dev server starts successfully
90
+ - [ ] Changed pages render correctly
91
+ - [ ] No console errors in browser
92
+
93
+ ### API / Backend
94
+ - [ ] Server starts without errors
95
+ - [ ] Changed endpoints respond correctly
96
+ - [ ] Error cases return appropriate status codes
97
+ - [ ] Database queries execute successfully
98
+
99
+ ### CLI / Script
100
+ - [ ] Script runs without errors
101
+ - [ ] Expected output matches actual output
102
+ - [ ] Error handling works (bad input test)
103
+ - [ ] Help/usage text is correct
104
+
105
+ ---
106
+
107
+ ## Anti-Patterns
108
+
109
+ | Anti-Pattern | Why It's Bad | Fix |
110
+ |---|---|---|
111
+ | "It should work" | No evidence | Run it and show output |
112
+ | Only checking happy path | Bugs hide in edge cases | Test error paths too |
113
+ | Verifying only compilation | Compiles ≠ correct | Test runtime behavior |
114
+ | Skipping verification for "trivial" changes | Trivial changes cause real bugs | Verify everything |
115
+
116
+ ---
117
+
118
+ ## Integration with Other Skills
119
+
120
+ | After Using | Verify With |
121
+ |---|---|
122
+ | `frontend-design` → UI changes | Render in browser, check console |
123
+ | `backend-specialist` → API changes | curl endpoints, check responses |
124
+ | `database-design` → Schema changes | Run migrations, query data |
125
+ | `testing-patterns` → New tests | Run test suite, check coverage |