@zenrick/zenkit 0.0.0-stage → 0.5.0

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 (353) 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/avaliar-vigilancia-mandato.mjs +38 -0
  335. package/scripts/bundle.mjs +158 -0
  336. package/scripts/check-deps.mjs +178 -0
  337. package/scripts/check-models.mjs +150 -0
  338. package/scripts/cli.mjs +295 -0
  339. package/scripts/continuidade-mandato.mjs +47 -0
  340. package/scripts/discriminar-turno.mjs +191 -0
  341. package/scripts/doctor.mjs +615 -0
  342. package/scripts/generate.mjs +676 -0
  343. package/scripts/install.mjs +11 -0
  344. package/scripts/layer-remote.mjs +344 -0
  345. package/scripts/layers.mjs +208 -0
  346. package/scripts/marketplace.mjs +77 -0
  347. package/scripts/product.mjs +32 -0
  348. package/scripts/ruleset-core.mjs +68 -0
  349. package/scripts/social-hooks.mjs +293 -0
  350. package/scripts/social-pacer.mjs +219 -0
  351. package/scripts/validate-bundles.mjs +14 -0
  352. package/scripts/validate-skills.mjs +174 -0
  353. package/scripts/zenkit-daemon-task.cmd +3 -0
@@ -0,0 +1,188 @@
1
+ ---
2
+ name: webapp-testing
3
+ description: Web application testing principles. E2E, Playwright, deep audit strategies.
4
+ when_to_use: "When writing E2E tests with Playwright, performing deep web app audits, or testing user flows. Use with /test workflow."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
6
+ ---
7
+
8
+ # Web App Testing
9
+
10
+ > Discover and test everything. Leave no route untested.
11
+
12
+ ## 🔧 Runtime Scripts
13
+
14
+ **Execute these for automated browser testing:**
15
+
16
+ | Script | Purpose | Usage |
17
+ |--------|---------|-------|
18
+ | `scripts/playwright_runner.py` | Basic browser test | `python scripts/playwright_runner.py https://example.com` |
19
+ | | With screenshot | `python scripts/playwright_runner.py <url> --screenshot` |
20
+ | | Accessibility check | `python scripts/playwright_runner.py <url> --a11y` |
21
+
22
+ **Requires:** `pip install playwright && playwright install chromium`
23
+
24
+ ---
25
+
26
+ ## 1. Deep Audit Approach
27
+
28
+ ### Discovery First
29
+
30
+ | Target | How to Find |
31
+ |--------|-------------|
32
+ | Routes | Scan app/, pages/, router files |
33
+ | API endpoints | Grep for HTTP methods |
34
+ | Components | Find component directories |
35
+ | Features | Read documentation |
36
+
37
+ ### Systematic Testing
38
+
39
+ 1. **Map** - List all routes/APIs
40
+ 2. **Scan** - Verify they respond
41
+ 3. **Test** - Cover critical paths
42
+
43
+ ---
44
+
45
+ ## 2. Testing Pyramid for Web
46
+
47
+ ```
48
+ /\ E2E (Few)
49
+ / \ Critical user flows
50
+ /----\
51
+ / \ Integration (Some)
52
+ /--------\ API, data flow
53
+ / \
54
+ /------------\ Component (Many)
55
+ Individual UI pieces
56
+ ```
57
+
58
+ ---
59
+
60
+ ## 3. E2E Test Principles
61
+
62
+ ### What to Test
63
+
64
+ | Priority | Tests |
65
+ |----------|-------|
66
+ | 1 | Happy path user flows |
67
+ | 2 | Authentication flows |
68
+ | 3 | Critical business actions |
69
+ | 4 | Error handling |
70
+
71
+ ### E2E Best Practices
72
+
73
+ | Practice | Why |
74
+ |----------|-----|
75
+ | Use data-testid | Stable selectors |
76
+ | Wait for elements | Avoid flaky tests |
77
+ | Clean state | Independent tests |
78
+ | Avoid implementation details | Test user behavior |
79
+
80
+ ---
81
+
82
+ ## 4. Playwright Principles
83
+
84
+ ### Core Concepts
85
+
86
+ | Concept | Use |
87
+ |---------|-----|
88
+ | Page Object Model | Encapsulate page logic |
89
+ | Fixtures | Reusable test setup |
90
+ | Assertions | Built-in auto-wait |
91
+ | Trace Viewer | Debug failures |
92
+
93
+ ### Configuration
94
+
95
+ | Setting | Recommendation |
96
+ |---------|----------------|
97
+ | Retries | 2 on CI |
98
+ | Trace | on-first-retry |
99
+ | Screenshots | on-failure |
100
+ | Video | retain-on-failure |
101
+
102
+ ---
103
+
104
+ ## 5. Visual Testing
105
+
106
+ ### When to Use
107
+
108
+ | Scenario | Value |
109
+ |----------|-------|
110
+ | Design system | High |
111
+ | Marketing pages | High |
112
+ | Component library | Medium |
113
+ | Dynamic content | Lower |
114
+
115
+ ### Strategy
116
+
117
+ - Baseline screenshots
118
+ - Compare on changes
119
+ - Review visual diffs
120
+ - Update intentional changes
121
+
122
+ ---
123
+
124
+ ## 6. API Testing Principles
125
+
126
+ ### Coverage Areas
127
+
128
+ | Area | Tests |
129
+ |------|-------|
130
+ | Status codes | 200, 400, 404, 500 |
131
+ | Response shape | Matches schema |
132
+ | Error messages | User-friendly |
133
+ | Edge cases | Empty, large, special chars |
134
+
135
+ ---
136
+
137
+ ## 7. Test Organization
138
+
139
+ ### File Structure
140
+
141
+ ```
142
+ tests/
143
+ ├── e2e/ # Full user flows
144
+ ├── integration/ # API, data
145
+ ├── component/ # UI units
146
+ └── fixtures/ # Shared data
147
+ ```
148
+
149
+ ### Naming Convention
150
+
151
+ | Pattern | Example |
152
+ |---------|---------|
153
+ | Feature-based | `login.spec.ts` |
154
+ | Descriptive | `user-can-checkout.spec.ts` |
155
+
156
+ ---
157
+
158
+ ## 8. CI Integration
159
+
160
+ ### Pipeline Steps
161
+
162
+ 1. Install dependencies
163
+ 2. Install browsers
164
+ 3. Run tests
165
+ 4. Upload artifacts (traces, screenshots)
166
+
167
+ ### Parallelization
168
+
169
+ | Strategy | Use |
170
+ |----------|-----|
171
+ | Per file | Playwright default |
172
+ | Sharding | Large suites |
173
+ | Workers | Multiple browsers |
174
+
175
+ ---
176
+
177
+ ## 9. Anti-Patterns
178
+
179
+ | ❌ Don't | ✅ Do |
180
+ |----------|-------|
181
+ | Test implementation | Test behavior |
182
+ | Hardcode waits | Use auto-wait |
183
+ | Skip cleanup | Isolate tests |
184
+ | Ignore flaky tests | Fix root cause |
185
+
186
+ ---
187
+
188
+ > **Remember:** E2E tests are expensive. Use them for critical paths only.
@@ -0,0 +1,173 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ Skill: webapp-testing
4
+ Script: playwright_runner.py
5
+ Purpose: Run basic Playwright browser tests
6
+ Usage: python playwright_runner.py <url> [--screenshot]
7
+ Output: JSON with page info, health status, and optional screenshot path
8
+ Note: Requires playwright (pip install playwright && playwright install chromium)
9
+ Screenshots: Saved to system temp directory (auto-cleaned by OS)
10
+ """
11
+ import sys
12
+ import json
13
+ import os
14
+ import tempfile
15
+ from datetime import datetime
16
+
17
+ # Fix Windows console encoding for Unicode output
18
+ try:
19
+ sys.stdout.reconfigure(encoding='utf-8', errors='replace')
20
+ sys.stderr.reconfigure(encoding='utf-8', errors='replace')
21
+ except AttributeError:
22
+ pass # Python < 3.7
23
+
24
+ try:
25
+ from playwright.sync_api import sync_playwright
26
+ PLAYWRIGHT_AVAILABLE = True
27
+ except ImportError:
28
+ PLAYWRIGHT_AVAILABLE = False
29
+
30
+
31
+ def run_basic_test(url: str, take_screenshot: bool = False) -> dict:
32
+ """Run basic browser test on URL."""
33
+ if not PLAYWRIGHT_AVAILABLE:
34
+ return {
35
+ "error": "Playwright not installed",
36
+ "fix": "pip install playwright && playwright install chromium"
37
+ }
38
+
39
+ result = {
40
+ "url": url,
41
+ "timestamp": datetime.now().isoformat(),
42
+ "status": "pending"
43
+ }
44
+
45
+ try:
46
+ with sync_playwright() as p:
47
+ browser = p.chromium.launch(headless=True)
48
+ context = browser.new_context(
49
+ viewport={"width": 1280, "height": 720},
50
+ user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
51
+ )
52
+ page = context.new_page()
53
+
54
+ # Navigate
55
+ response = page.goto(url, wait_until="networkidle", timeout=30000)
56
+
57
+ # Basic info
58
+ result["page"] = {
59
+ "title": page.title(),
60
+ "url": page.url,
61
+ "status_code": response.status if response else None
62
+ }
63
+
64
+ # Health checks
65
+ result["health"] = {
66
+ "loaded": response.ok if response else False,
67
+ "has_title": bool(page.title()),
68
+ "has_h1": page.locator("h1").count() > 0,
69
+ "has_links": page.locator("a").count() > 0,
70
+ "has_images": page.locator("img").count() > 0
71
+ }
72
+
73
+ # Console errors
74
+ console_errors = []
75
+ page.on("console", lambda msg: console_errors.append(msg.text) if msg.type == "error" else None)
76
+
77
+ # Performance metrics
78
+ result["performance"] = {
79
+ "dom_content_loaded": page.evaluate("window.performance.timing.domContentLoadedEventEnd - window.performance.timing.navigationStart"),
80
+ "load_complete": page.evaluate("window.performance.timing.loadEventEnd - window.performance.timing.navigationStart")
81
+ }
82
+
83
+ # Screenshot - uses system temp directory (cross-platform, auto-cleaned)
84
+ if take_screenshot:
85
+ # Cross-platform: Windows=%TEMP%, Linux/macOS=/tmp
86
+ screenshot_dir = os.path.join(tempfile.gettempdir(), "maestro_screenshots")
87
+ os.makedirs(screenshot_dir, exist_ok=True)
88
+ screenshot_path = os.path.join(screenshot_dir, f"screenshot_{datetime.now().strftime('%Y%m%d_%H%M%S')}.png")
89
+ page.screenshot(path=screenshot_path, full_page=True)
90
+ result["screenshot"] = screenshot_path
91
+ result["screenshot_note"] = "Saved to temp directory (auto-cleaned by OS)"
92
+
93
+ # Element counts
94
+ result["elements"] = {
95
+ "links": page.locator("a").count(),
96
+ "buttons": page.locator("button").count(),
97
+ "inputs": page.locator("input").count(),
98
+ "images": page.locator("img").count(),
99
+ "forms": page.locator("form").count()
100
+ }
101
+
102
+ browser.close()
103
+
104
+ result["status"] = "success" if result["health"]["loaded"] else "failed"
105
+ result["summary"] = "[OK] Page loaded successfully" if result["status"] == "success" else "[X] Page failed to load"
106
+
107
+ except Exception as e:
108
+ result["status"] = "error"
109
+ result["error"] = str(e)
110
+ result["summary"] = f"[X] Error: {str(e)[:100]}"
111
+
112
+ return result
113
+
114
+
115
+ def run_accessibility_check(url: str) -> dict:
116
+ """Run basic accessibility check."""
117
+ if not PLAYWRIGHT_AVAILABLE:
118
+ return {"error": "Playwright not installed"}
119
+
120
+ result = {"url": url, "accessibility": {}}
121
+
122
+ try:
123
+ with sync_playwright() as p:
124
+ browser = p.chromium.launch(headless=True)
125
+ page = browser.new_page()
126
+ page.goto(url, wait_until="networkidle", timeout=30000)
127
+
128
+ # Basic a11y checks
129
+ result["accessibility"] = {
130
+ "images_with_alt": page.locator("img[alt]").count(),
131
+ "images_without_alt": page.locator("img:not([alt])").count(),
132
+ "buttons_with_label": page.locator("button[aria-label], button:has-text('')").count(),
133
+ "links_with_text": page.locator("a:has-text('')").count(),
134
+ "form_labels": page.locator("label").count(),
135
+ "headings": {
136
+ "h1": page.locator("h1").count(),
137
+ "h2": page.locator("h2").count(),
138
+ "h3": page.locator("h3").count()
139
+ }
140
+ }
141
+
142
+ browser.close()
143
+ result["status"] = "success"
144
+
145
+ except Exception as e:
146
+ result["status"] = "error"
147
+ result["error"] = str(e)
148
+
149
+ return result
150
+
151
+
152
+ if __name__ == "__main__":
153
+ if len(sys.argv) < 2:
154
+ print(json.dumps({
155
+ "error": "Usage: python playwright_runner.py <url> [--screenshot] [--a11y]",
156
+ "examples": [
157
+ "python playwright_runner.py https://example.com",
158
+ "python playwright_runner.py https://example.com --screenshot",
159
+ "python playwright_runner.py https://example.com --a11y"
160
+ ]
161
+ }, indent=2))
162
+ sys.exit(1)
163
+
164
+ url = sys.argv[1]
165
+ take_screenshot = "--screenshot" in sys.argv
166
+ check_a11y = "--a11y" in sys.argv
167
+
168
+ if check_a11y:
169
+ result = run_accessibility_check(url)
170
+ else:
171
+ result = run_basic_test(url, take_screenshot)
172
+
173
+ print(json.dumps(result, indent=2))
@@ -0,0 +1,113 @@
1
+ ---
2
+ description: Structured brainstorming for projects and features. Explores multiple options before implementation.
3
+ ---
4
+
5
+ # /brainstorm - Structured Idea Exploration
6
+
7
+ $ARGUMENTS
8
+
9
+ ---
10
+
11
+ ## Purpose
12
+
13
+ This command activates BRAINSTORM mode for structured idea exploration. Use when you need to explore options before committing to an implementation.
14
+
15
+ ---
16
+
17
+ ## Behavior
18
+
19
+ When `/brainstorm` is triggered:
20
+
21
+ 1. **Understand the goal**
22
+ - What problem are we solving?
23
+ - Who is the user?
24
+ - What constraints exist?
25
+
26
+ 2. **Generate options**
27
+ - Provide at least 3 different approaches
28
+ - Each with pros and cons
29
+ - Consider unconventional solutions
30
+
31
+ 3. **Compare and recommend**
32
+ - Summarize tradeoffs
33
+ - Give a recommendation with reasoning
34
+
35
+ ---
36
+
37
+ ## Output Format
38
+
39
+ ```markdown
40
+ ## 🧠 Brainstorm: [Topic]
41
+
42
+ ### Context
43
+ [Brief problem statement]
44
+
45
+ ---
46
+
47
+ ### Option A: [Name]
48
+ [Description]
49
+
50
+ ✅ **Pros:**
51
+ - [benefit 1]
52
+ - [benefit 2]
53
+
54
+ ❌ **Cons:**
55
+ - [drawback 1]
56
+
57
+ 📊 **Effort:** Low | Medium | High
58
+
59
+ ---
60
+
61
+ ### Option B: [Name]
62
+ [Description]
63
+
64
+ ✅ **Pros:**
65
+ - [benefit 1]
66
+
67
+ ❌ **Cons:**
68
+ - [drawback 1]
69
+ - [drawback 2]
70
+
71
+ 📊 **Effort:** Low | Medium | High
72
+
73
+ ---
74
+
75
+ ### Option C: [Name]
76
+ [Description]
77
+
78
+ ✅ **Pros:**
79
+ - [benefit 1]
80
+
81
+ ❌ **Cons:**
82
+ - [drawback 1]
83
+
84
+ 📊 **Effort:** Low | Medium | High
85
+
86
+ ---
87
+
88
+ ## 💡 Recommendation
89
+
90
+ **Option [X]** because [reasoning].
91
+
92
+ What direction would you like to explore?
93
+ ```
94
+
95
+ ---
96
+
97
+ ## Examples
98
+
99
+ ```
100
+ /brainstorm authentication system
101
+ /brainstorm state management for complex form
102
+ /brainstorm database schema for social app
103
+ /brainstorm caching strategy
104
+ ```
105
+
106
+ ---
107
+
108
+ ## Key Principles
109
+
110
+ - **No code** - this is about ideas, not implementation
111
+ - **Visual when helpful** - use diagrams for architecture
112
+ - **Honest tradeoffs** - don't hide complexity
113
+ - **Defer to user** - present options, let them decide
@@ -0,0 +1,72 @@
1
+ ---
2
+ description: Advanced multi-agent coordination with parallel dispatch and synthesis. Use for complex tasks requiring multiple specialist perspectives.
3
+ ---
4
+
5
+ # /coordinate — Advanced Multi-Agent Coordination
6
+
7
+ $ARGUMENTS
8
+
9
+ ---
10
+
11
+ ## 🔴 CRITICAL RULES
12
+
13
+ 1. **Load coordinator-mode skill** — Read `.cursor/skills/coordinator-mode/SKILL.md` first
14
+ 2. **Phase-based execution** — Research → Synthesis → Implementation → Verification
15
+ 3. **Never delegate understanding** — Write specific prompts, not vague instructions
16
+ 4. **Parallel reads, sequential writes** — Read-only tasks can run in parallel
17
+
18
+ ---
19
+
20
+ ## Task
21
+
22
+ Use the `orchestrator` agent with this context:
23
+
24
+ ```
25
+ CONTEXT:
26
+ - User Request: $ARGUMENTS
27
+ - Mode: COORDINATOR (advanced orchestration)
28
+ - Skill: Load coordinator-mode skill for patterns
29
+
30
+ WORKFLOW:
31
+ 1. DECOMPOSE the request into worker subtasks
32
+ 2. CLASSIFY each subtask: Research | Implementation | Verification
33
+ 3. DISPATCH workers (parallel for reads, sequential for writes)
34
+ 4. SYNTHESIZE results — don't copy-paste, add insight
35
+ 5. VERIFY completeness before reporting to user
36
+
37
+ RULES:
38
+ 1. Follow coordinator-mode/SKILL.md protocol
39
+ 2. Brief workers like smart colleagues — full context, specific scope
40
+ 3. Never write "based on your findings, fix it" — prove YOU understood
41
+ 4. Start with 2-3 workers, add more after synthesis if needed
42
+ 5. Research before implementation — ALWAYS
43
+ ```
44
+
45
+ ---
46
+
47
+ ## Expected Output
48
+
49
+ | Deliverable | Description |
50
+ |-------------|-------------|
51
+ | Worker Dispatch | List of agents invoked with task descriptions |
52
+ | Synthesis Report | Consolidated findings with YOUR analysis |
53
+ | Action Items | Specific next steps with file paths |
54
+
55
+ ---
56
+
57
+ ## After Coordination
58
+
59
+ ```
60
+ [OK] Coordination complete
61
+
62
+ Agents dispatched: [count]
63
+ Phases completed: Research → Synthesis → [Implementation] → [Verification]
64
+
65
+ Key findings:
66
+ - [Finding 1]
67
+ - [Finding 2]
68
+
69
+ Next steps:
70
+ - [ ] [Action item 1]
71
+ - [ ] [Action item 2]
72
+ ```
@@ -0,0 +1,59 @@
1
+ ---
2
+ description: Create new application command. Triggers App Builder skill and starts interactive dialogue with user.
3
+ ---
4
+
5
+ # /create - Create Application
6
+
7
+ $ARGUMENTS
8
+
9
+ ---
10
+
11
+ ## Task
12
+
13
+ This command starts a new application creation process.
14
+
15
+ ### Steps:
16
+
17
+ 1. **Request Analysis**
18
+ - Understand what the user wants
19
+ - If information is missing, use `conversation-manager` skill to ask
20
+
21
+ 2. **Project Planning**
22
+ - Use `project-planner` agent for task breakdown
23
+ - Determine tech stack
24
+ - Plan file structure
25
+ - Create plan file and proceed to building
26
+
27
+ 3. **Application Building (After Approval)**
28
+ - Orchestrate with `app-builder` skill
29
+ - Coordinate expert agents:
30
+ - `database-architect` → Schema
31
+ - `backend-specialist` → API
32
+ - `frontend-specialist` → UI
33
+
34
+ 4. **Preview**
35
+ - Start with `auto_preview.py` when complete
36
+ - Present URL to user
37
+
38
+ ---
39
+
40
+ ## Usage Examples
41
+
42
+ ```
43
+ /create blog site
44
+ /create e-commerce app with product listing and cart
45
+ /create todo app
46
+ /create Instagram clone
47
+ /create crm system with customer management
48
+ ```
49
+
50
+ ---
51
+
52
+ ## Before Starting
53
+
54
+ If request is unclear, ask these questions:
55
+ - What type of application?
56
+ - What are the basic features?
57
+ - Who will use it?
58
+
59
+ Use defaults, add details later.
@@ -0,0 +1,103 @@
1
+ ---
2
+ description: Debugging command. Activates DEBUG mode for systematic problem investigation.
3
+ ---
4
+
5
+ # /debug - Systematic Problem Investigation
6
+
7
+ $ARGUMENTS
8
+
9
+ ---
10
+
11
+ ## Purpose
12
+
13
+ This command activates DEBUG mode for systematic investigation of issues, errors, or unexpected behavior.
14
+
15
+ ---
16
+
17
+ ## Behavior
18
+
19
+ When `/debug` is triggered:
20
+
21
+ 1. **Gather information**
22
+ - Error message
23
+ - Reproduction steps
24
+ - Expected vs actual behavior
25
+ - Recent changes
26
+
27
+ 2. **Form hypotheses**
28
+ - List possible causes
29
+ - Order by likelihood
30
+
31
+ 3. **Investigate systematically**
32
+ - Test each hypothesis
33
+ - Check logs, data flow
34
+ - Use elimination method
35
+
36
+ 4. **Fix and prevent**
37
+ - Apply fix
38
+ - Explain root cause
39
+ - Add prevention measures
40
+
41
+ ---
42
+
43
+ ## Output Format
44
+
45
+ ```markdown
46
+ ## 🔍 Debug: [Issue]
47
+
48
+ ### 1. Symptom
49
+ [What's happening]
50
+
51
+ ### 2. Information Gathered
52
+ - Error: `[error message]`
53
+ - File: `[filepath]`
54
+ - Line: [line number]
55
+
56
+ ### 3. Hypotheses
57
+ 1. ❓ [Most likely cause]
58
+ 2. ❓ [Second possibility]
59
+ 3. ❓ [Less likely cause]
60
+
61
+ ### 4. Investigation
62
+
63
+ **Testing hypothesis 1:**
64
+ [What I checked] → [Result]
65
+
66
+ **Testing hypothesis 2:**
67
+ [What I checked] → [Result]
68
+
69
+ ### 5. Root Cause
70
+ 🎯 **[Explanation of why this happened]**
71
+
72
+ ### 6. Fix
73
+ ```[language]
74
+ // Before
75
+ [broken code]
76
+
77
+ // After
78
+ [fixed code]
79
+ ```
80
+
81
+ ### 7. Prevention
82
+ 🛡️ [How to prevent this in the future]
83
+ ```
84
+
85
+ ---
86
+
87
+ ## Examples
88
+
89
+ ```
90
+ /debug login not working
91
+ /debug API returns 500
92
+ /debug form doesn't submit
93
+ /debug data not saving
94
+ ```
95
+
96
+ ---
97
+
98
+ ## Key Principles
99
+
100
+ - **Ask before assuming** - get full error context
101
+ - **Test hypotheses** - don't guess randomly
102
+ - **Explain why** - not just what to fix
103
+ - **Prevent recurrence** - add tests, validation