@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,145 @@
1
+ ---
2
+ name: i18n-localization
3
+ description: Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.
4
+ when_to_use: "When internationalizing an app, managing translations, detecting hardcoded strings, or adding RTL support."
5
+ allowed-tools: Read, Glob, Grep
6
+ ---
7
+
8
+ # i18n & Localization
9
+
10
+ > Internationalization (i18n) and Localization (L10n) best practices.
11
+
12
+ ---
13
+
14
+ ## 1. Core Concepts
15
+
16
+ | Term | Meaning |
17
+ |------|---------|
18
+ | **i18n** | Internationalization - making app translatable |
19
+ | **L10n** | Localization - actual translations |
20
+ | **Locale** | Language + Region (en-US, tr-TR) |
21
+ | **RTL** | Right-to-left languages (Arabic, Hebrew) |
22
+
23
+ ---
24
+
25
+ ## 2. When to Use i18n
26
+
27
+ | Project Type | i18n Needed? |
28
+ |--------------|--------------|
29
+ | Public web app | ✅ Yes |
30
+ | SaaS product | ✅ Yes |
31
+ | Internal tool | ⚠️ Maybe |
32
+ | Single-region app | ⚠️ Consider future |
33
+ | Personal project | ❌ Optional |
34
+
35
+ ---
36
+
37
+ ## 3. Implementation Patterns
38
+
39
+ ### React (react-i18next)
40
+
41
+ ```tsx
42
+ import { useTranslations } from 'next-intl';
43
+
44
+ // In Next.js App Router, ensure messages are preloaded on the server to prevent SSR hydration mismatch:
45
+ export default function Page() {
46
+ const t = useTranslations('Home');
47
+ return <h1>{t('title')}</h1>;
48
+ }
49
+ ```
50
+
51
+ ### Python (gettext)
52
+
53
+ ```python
54
+ from gettext import gettext as _
55
+
56
+ print(_("Welcome to our app"))
57
+ ```
58
+
59
+ ---
60
+
61
+ ## 4. File Structure
62
+
63
+ ```
64
+ locales/
65
+ ├── en/
66
+ │ ├── common.json
67
+ │ ├── auth.json
68
+ │ └── errors.json
69
+ ├── tr/
70
+ │ ├── common.json
71
+ │ ├── auth.json
72
+ │ └── errors.json
73
+ └── ar/ # RTL
74
+ └── ...
75
+ ```
76
+
77
+ ---
78
+
79
+ ## 5. Best Practices
80
+
81
+ ### DO ✅
82
+
83
+ - Use translation keys, not raw text
84
+ - Namespace translations by feature and split dynamically (avoid monolingual dictionary bundles)
85
+ - Support pluralization via ICU message format (CLDR plural rules: zero, one, few, many, other)
86
+ - Cache / memoize `Intl.DateTimeFormat` and `Intl.NumberFormat` instances to prevent render loop jank
87
+ - Plan for RTL from the start (mirror layout, but preserve direction on media controls/numbers)
88
+ - Configure hreflang and localized routing (`/en`, `/pt-BR`) for public multilingual SEO
89
+
90
+ ### DON'T ❌
91
+
92
+ - Hardcode strings in components
93
+ - Concatenate translated strings
94
+ - Assume text length (German is 30% longer)
95
+ - Forget about RTL layout
96
+ - Mix languages in same file
97
+
98
+ ---
99
+
100
+ ## 6. Common Issues
101
+
102
+ | Issue | Solution |
103
+ |-------|----------|
104
+ | Missing translation | Fallback to default language |
105
+ | Hardcoded strings | Use linter/checker script |
106
+ | Date format | Use Intl.DateTimeFormat |
107
+ | Number format | Use Intl.NumberFormat |
108
+ | Pluralization | Use ICU message format |
109
+
110
+ ---
111
+
112
+ ## 7. RTL Support
113
+
114
+ ```css
115
+ /* CSS Logical Properties */
116
+ .container {
117
+ margin-inline-start: 1rem; /* Not margin-left */
118
+ padding-inline-end: 1rem; /* Not padding-right */
119
+ }
120
+
121
+ [dir="rtl"] .icon {
122
+ transform: scaleX(-1);
123
+ }
124
+ ```
125
+
126
+ ---
127
+
128
+ ## 8. Checklist
129
+
130
+ Before shipping:
131
+
132
+ - [ ] All user-facing strings use translation keys
133
+ - [ ] Locale files exist for all supported languages
134
+ - [ ] Date/number formatting uses Intl API
135
+ - [ ] RTL layout tested (if applicable)
136
+ - [ ] Fallback language configured
137
+ - [ ] No hardcoded strings in components
138
+
139
+ ---
140
+
141
+ ## Script
142
+
143
+ | Script | Purpose | Command |
144
+ |--------|---------|---------|
145
+ | `scripts/i18n_checker.py` | Detect hardcoded strings & missing translations | `python scripts/i18n_checker.py <project_path>` |
@@ -0,0 +1,241 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ i18n Checker - Detects hardcoded strings and missing translations.
4
+ Scans for untranslated text in React, Vue, and Python files.
5
+ """
6
+ import sys
7
+ import re
8
+ import json
9
+ from pathlib import Path
10
+
11
+ # Fix Windows console encoding for Unicode output
12
+ try:
13
+ sys.stdout.reconfigure(encoding='utf-8', errors='replace')
14
+ sys.stderr.reconfigure(encoding='utf-8', errors='replace')
15
+ except AttributeError:
16
+ pass # Python < 3.7
17
+
18
+ # Patterns that indicate hardcoded strings (should be translated)
19
+ HARDCODED_PATTERNS = {
20
+ 'jsx': [
21
+ # Text directly in JSX: <div>Hello World</div>
22
+ r'>\s*[A-Z][a-zA-Z\s]{3,30}\s*</',
23
+ # JSX attribute strings: title="Welcome"
24
+ r'(title|placeholder|label|alt|aria-label)="[A-Z][a-zA-Z\s]{2,}"',
25
+ # Button/heading text
26
+ r'<(button|h[1-6]|p|span|label)[^>]*>\s*[A-Z][a-zA-Z\s!?.,]{3,}\s*</',
27
+ ],
28
+ 'vue': [
29
+ # Vue template text
30
+ r'>\s*[A-Z][a-zA-Z\s]{3,30}\s*</',
31
+ r'(placeholder|label|title)="[A-Z][a-zA-Z\s]{2,}"',
32
+ ],
33
+ 'python': [
34
+ # print/raise with string literals
35
+ r'(print|raise\s+\w+)\s*\(\s*["\'][A-Z][^"\']{5,}["\']',
36
+ # Flask flash messages
37
+ r'flash\s*\(\s*["\'][A-Z][^"\']{5,}["\']',
38
+ ]
39
+ }
40
+
41
+ # Patterns that indicate proper i18n usage
42
+ I18N_PATTERNS = [
43
+ r't\(["\']', # t('key') - react-i18next
44
+ r'useTranslation', # React hook
45
+ r'\$t\(', # Vue i18n
46
+ r'_\(["\']', # Python gettext
47
+ r'gettext\(', # Python gettext
48
+ r'useTranslations', # next-intl
49
+ r'FormattedMessage', # react-intl
50
+ r'i18n\.', # Generic i18n
51
+ ]
52
+
53
+ def find_locale_files(project_path: Path) -> list:
54
+ """Find translation/locale files."""
55
+ patterns = [
56
+ "**/locales/**/*.json",
57
+ "**/translations/**/*.json",
58
+ "**/lang/**/*.json",
59
+ "**/i18n/**/*.json",
60
+ "**/messages/*.json",
61
+ "**/*.po", # gettext
62
+ ]
63
+
64
+ files = []
65
+ for pattern in patterns:
66
+ files.extend(project_path.glob(pattern))
67
+
68
+ return [f for f in files if 'node_modules' not in str(f)]
69
+
70
+ def check_locale_completeness(locale_files: list) -> dict:
71
+ """Check if all locales have the same keys."""
72
+ issues = []
73
+ passed = []
74
+
75
+ if not locale_files:
76
+ return {'passed': [], 'issues': ["[!] No locale files found"]}
77
+
78
+ # Group by parent folder (language)
79
+ locales = {}
80
+ for f in locale_files:
81
+ if f.suffix == '.json':
82
+ try:
83
+ lang = f.parent.name
84
+ content = json.loads(f.read_text(encoding='utf-8'))
85
+ if lang not in locales:
86
+ locales[lang] = {}
87
+ locales[lang][f.stem] = set(flatten_keys(content))
88
+ except:
89
+ continue
90
+
91
+ if len(locales) < 2:
92
+ passed.append(f"[OK] Found {len(locale_files)} locale file(s)")
93
+ return {'passed': passed, 'issues': issues}
94
+
95
+ passed.append(f"[OK] Found {len(locales)} language(s): {', '.join(locales.keys())}")
96
+
97
+ # Compare keys across locales
98
+ all_langs = list(locales.keys())
99
+ base_lang = all_langs[0]
100
+
101
+ for namespace in locales.get(base_lang, {}):
102
+ base_keys = locales[base_lang].get(namespace, set())
103
+
104
+ for lang in all_langs[1:]:
105
+ other_keys = locales.get(lang, {}).get(namespace, set())
106
+
107
+ missing = base_keys - other_keys
108
+ if missing:
109
+ issues.append(f"[X] {lang}/{namespace}: Missing {len(missing)} keys")
110
+
111
+ extra = other_keys - base_keys
112
+ if extra:
113
+ issues.append(f"[!] {lang}/{namespace}: {len(extra)} extra keys")
114
+
115
+ if not issues:
116
+ passed.append("[OK] All locales have matching keys")
117
+
118
+ return {'passed': passed, 'issues': issues}
119
+
120
+ def flatten_keys(d, prefix=''):
121
+ """Flatten nested dict keys."""
122
+ keys = set()
123
+ for k, v in d.items():
124
+ new_key = f"{prefix}.{k}" if prefix else k
125
+ if isinstance(v, dict):
126
+ keys.update(flatten_keys(v, new_key))
127
+ else:
128
+ keys.add(new_key)
129
+ return keys
130
+
131
+ def check_hardcoded_strings(project_path: Path) -> dict:
132
+ """Check for hardcoded strings in code files."""
133
+ issues = []
134
+ passed = []
135
+
136
+ # Find code files
137
+ extensions = {
138
+ '.tsx': 'jsx', '.jsx': 'jsx', '.ts': 'jsx', '.js': 'jsx',
139
+ '.vue': 'vue',
140
+ '.py': 'python'
141
+ }
142
+
143
+ code_files = []
144
+ for ext in extensions:
145
+ code_files.extend(project_path.rglob(f"*{ext}"))
146
+
147
+ code_files = [f for f in code_files if not any(x in str(f) for x in
148
+ ['node_modules', '.git', 'dist', 'build', '__pycache__', 'venv', 'test', 'spec'])]
149
+
150
+ if not code_files:
151
+ return {'passed': ["[!] No code files found"], 'issues': []}
152
+
153
+ files_with_i18n = 0
154
+ files_with_hardcoded = 0
155
+ hardcoded_examples = []
156
+
157
+ for file_path in code_files[:50]: # Limit
158
+ try:
159
+ content = file_path.read_text(encoding='utf-8', errors='ignore')
160
+ ext = file_path.suffix
161
+ file_type = extensions.get(ext, 'jsx')
162
+
163
+ # Check for i18n usage
164
+ has_i18n = any(re.search(p, content) for p in I18N_PATTERNS)
165
+ if has_i18n:
166
+ files_with_i18n += 1
167
+
168
+ # Check for hardcoded strings
169
+ patterns = HARDCODED_PATTERNS.get(file_type, [])
170
+ hardcoded_found = False
171
+
172
+ for pattern in patterns:
173
+ matches = re.findall(pattern, content)
174
+ if matches and not has_i18n:
175
+ hardcoded_found = True
176
+ if len(hardcoded_examples) < 5:
177
+ hardcoded_examples.append(f"{file_path.name}: {str(matches[0])[:40]}...")
178
+
179
+ if hardcoded_found:
180
+ files_with_hardcoded += 1
181
+
182
+ except:
183
+ continue
184
+
185
+ passed.append(f"[OK] Analyzed {len(code_files)} code files")
186
+
187
+ if files_with_i18n > 0:
188
+ passed.append(f"[OK] {files_with_i18n} files use i18n")
189
+
190
+ if files_with_hardcoded > 0:
191
+ issues.append(f"[X] {files_with_hardcoded} files may have hardcoded strings")
192
+ for ex in hardcoded_examples:
193
+ issues.append(f" → {ex}")
194
+ else:
195
+ passed.append("[OK] No obvious hardcoded strings detected")
196
+
197
+ return {'passed': passed, 'issues': issues}
198
+
199
+ def main():
200
+ target = sys.argv[1] if len(sys.argv) > 1 else "."
201
+ project_path = Path(target)
202
+
203
+ print("\n" + "=" * 60)
204
+ print(" i18n CHECKER - Internationalization Audit")
205
+ print("=" * 60 + "\n")
206
+
207
+ # Check locale files
208
+ locale_files = find_locale_files(project_path)
209
+ locale_result = check_locale_completeness(locale_files)
210
+
211
+ # Check hardcoded strings
212
+ code_result = check_hardcoded_strings(project_path)
213
+
214
+ # Print results
215
+ print("[LOCALE FILES]")
216
+ print("-" * 40)
217
+ for item in locale_result['passed']:
218
+ print(f" {item}")
219
+ for item in locale_result['issues']:
220
+ print(f" {item}")
221
+
222
+ print("\n[CODE ANALYSIS]")
223
+ print("-" * 40)
224
+ for item in code_result['passed']:
225
+ print(f" {item}")
226
+ for item in code_result['issues']:
227
+ print(f" {item}")
228
+
229
+ # Summary
230
+ critical_issues = sum(1 for i in locale_result['issues'] + code_result['issues'] if i.startswith("[X]"))
231
+
232
+ print("\n" + "=" * 60)
233
+ if critical_issues == 0:
234
+ print("[OK] i18n CHECK: PASSED")
235
+ sys.exit(0)
236
+ else:
237
+ print(f"[X] i18n CHECK: {critical_issues} issues found")
238
+ sys.exit(1)
239
+
240
+ if __name__ == "__main__":
241
+ main()
@@ -0,0 +1,128 @@
1
+ ---
2
+ name: intelligent-routing
3
+ description: Automatic agent selection and intelligent task routing. Analyzes user requests and automatically selects the best specialist agent(s) without requiring explicit user mentions.
4
+ when_to_use: "Always active. Automatically selects the best specialist agent for each user request without explicit user mentions."
5
+ version: 1.0.0
6
+ ---
7
+
8
+ # Intelligent Agent Routing
9
+
10
+ **Purpose**: Automatically analyze user requests and route them to the most appropriate specialist agent(s) without requiring explicit user mentions.
11
+
12
+ ## Core Principle
13
+
14
+ > **The AI should act as an intelligent Project Manager**, analyzing each request and automatically selecting the best specialist(s) for the job.
15
+
16
+ ## How It Works
17
+
18
+ ### 1. Request Analysis
19
+
20
+ Before responding to non-trivial user requests, evaluate intent and token cost:
21
+
22
+ ```mermaid
23
+ graph TD
24
+ A[User Request: Add login] --> B[Fast Local Match]
25
+ B -->|Trivial/Factual| C[Direct Answer / Low Tier]
26
+ B -->|Non-Trivial| D[SELECT SPECIALIST & MODEL TIER]
27
+ D --> E[Single Specialist]
28
+ D -->|Explicit Complex/Multi-domain| F[Orchestrator - Plan First]
29
+ ```
30
+
31
+ ### 2. Agent Selection Matrix
32
+
33
+ #### Fork 0 — who is going to READ the answer?
34
+
35
+ **Decide this before anything else.** It is not a technical-domain question, and
36
+ getting it wrong is not a small miss: it produces "I opened a PR with the fix"
37
+ delivered to a shop owner.
38
+
39
+ | Reader | Signal | Route |
40
+ |--------|--------|-------|
41
+ | **Someone who decides** — owner, CEO, marketing, front desk, **or a person deciding about their own life** | Asks about something they must choose or act on: money, customer, campaign, **a course of study, a career move, a business they want to start**. Uses no technical vocabulary, and is not asking for a change to a codebase. | **`negocio-*` skills.** Load `negocio-linguagem` FIRST — it is the base and the others assume it — then the specific one below. Do **not** route to an engineering agent. |
42
+ | **Someone who builds** | Asks for a change to code, infra, schema, tests, deploy | The matrix below |
43
+
44
+ Judge by **who reads the answer and what they will do with it** — not by matching
45
+ words. "Esse erro" from a shop owner is a mistake they made with a customer;
46
+ "esse erro" from a developer is a stack trace. Same word, opposite routes.
47
+
48
+ When the reader is someone who decides:
49
+
50
+ | What they want | Skill |
51
+ |----------------|-------|
52
+ | Answer this review, customer, complaint, e-mail | `negocio-atendimento` |
53
+ | How much to charge / discount / price increase | `negocio-preco` |
54
+ | Where this customer is in the decision | `negocio-qualificacao` |
55
+ | Instructions for an agent that talks to customers | `negocio-agente-conversa` |
56
+ | Anything else about the business or their own life | the matching skill from the installed business pack, if any |
57
+ | *(any of the above)* | **always** `negocio-linguagem` alongside it |
58
+
59
+ When a request spans two skills, load both and answer once. Do not produce two answers.
60
+
61
+ If it is genuinely unclear who is reading, **ask one short question** — do not
62
+ guess and do not answer in both registers.
63
+
64
+ **Never announce the routing to a business reader.** The "🤖 Applying `@agent`…"
65
+ convention in §4 below is for someone who builds. To someone who decides,
66
+ *"I'll consult the language and decision skills"* is internal vocabulary leaking
67
+ — the exact defect `negocio-linguagem` forbids. Open with the answer itself.
68
+
69
+ ---
70
+
71
+ **Use this matrix to automatically select agents:**
72
+
73
+ | User Intent | Keywords | Selected Agent(s) | Min Model Tier | Auto-invoke? |
74
+ | ------------------- | ------------------------------------------ | ------------------------------------------- | -------------- | ------------ |
75
+ | **Authentication** | "login", "auth", "signup", "password" | `backend-specialist` (consult auditor on PR)| Fast/Sonnet | ✅ YES |
76
+ | **UI Component** | "button", "card", "layout", "style" | `frontend-specialist` | Fast/Flash | ✅ YES |
77
+ | **Mobile UI** | "screen", "navigation", "touch", "gesture" | `mobile-developer` | Fast/Flash | ✅ YES |
78
+ | **API Endpoint** | "endpoint", "route", "API", "POST", "GET" | `backend-specialist` | Fast/Sonnet | ✅ YES |
79
+ | **Database** | "schema", "migration", "query", "table" | `database-architect` | Fast/Sonnet | ✅ YES |
80
+ | **Bug Fix** | "error", "bug", "not working", "broken" | `debugger` | Sonnet | ✅ YES |
81
+ | **Test** | "test", "coverage", "unit", "e2e" | `test-engineer` | Fast/Flash | ✅ YES |
82
+ | **Deployment** | "deploy", "production", "CI/CD", "docker" | `devops-engineer` | Fast/Sonnet | ✅ YES |
83
+ | **Security Review** | "security", "vulnerability", "exploit" | `security-auditor` | Sonnet | ✅ YES |
84
+ | **Performance** | "slow", "optimize", "performance", "speed" | `performance-optimizer` | Sonnet | ✅ YES |
85
+ | **Product Def** | "requirements", "user story", "backlog" | `product-owner` | Fast/Haiku | ✅ YES |
86
+ | **New Feature** | "build", "create", "implement", "new app" | `orchestrator` → multi-agent | Plan Tier | ⚠️ ASK FIRST |
87
+ | **Feature delivery (phased)** | "entregar feature", "fluxo completo", demanda com fases, DEM-* engenharia | Load `entrega-com-agentes` → `orchestrator` ou flagship plan + `dispatch_handoff` | Plan Tier | ✅ YES when process documented |
88
+ | **Complex Task** | Multiple domains detected | `orchestrator` → multi-agent | Plan Tier | ⚠️ ASK FIRST |
89
+ | **Complex + Bridge** | Complex task + `zenkit-bridge` MCP | MCP `plan (Claude)` then `execute (Cursor)` | Plan Tier | ✅ YES when bridge on |
90
+ | **Delegate to another CLI** | "pass to composer/cursor", "claude -p", "codex exec" | `provider-orchestration` + matching `*-exec` | CLI Default | ✅ YES |
91
+ | **Project architecture** | "ADR", "trade-off", "arquitetura do produto", "decisão arquitetural" | Load `architecture`; `orchestrator` or `backend-specialist` | Plan Tier | ✅ YES |
92
+ | **System design interview** | "system design", "entrevista de system design", "mock interview", "design a URL shortener" | Load `system-design-interview` (+ `architecture` só se virar projeto real) | Sonnet | ✅ YES |
93
+ | **Physical actuation** | "light", "switch", "lock", "gate", "HVAC", "smart home", "set_power", "Tuya", real device | `backend-specialist` + `mcp-atuacao`, `mcp-builder` | Sonnet | ⚠️ HUMAN IN LOOP |
94
+
95
+ Same-runtime subagents (`Task`, native Agent tool) are **not** another provider — that is `coordinator-mode`. Another provider is another **binary** on the machine, with the buyer's own key.
96
+
97
+ ### Cross-IDE bridge (Claude Code ↔ Cursor)
98
+
99
+ When `ZENKIT_BRIDGE_ENABLED` is not `false` and MCP `zenkit-bridge` is connected:
100
+
101
+ 1. Call tool `classify_and_route` with the user message.
102
+ 2. If `action === "plan"` → `plan (Claude)` (use `modelHint`: opus / sonnet / haiku from result).
103
+ 3. If `action === "execute"` → `execute (Cursor SDK)` (requires `CURSOR_API_KEY`).
104
+ 4. If `action === "local_only"` or `"question"` → route to specialist agents as usual.
105
+
106
+ > The bridge's cheap tier obeys the house cost cap: ≤ $2 per 1M tokens (in+out,
107
+ > models.dev). Haiku (~$6) is not cheap — the cheap executor default is
108
+ > `opencode-go-exec` (`opencode-go/deepseek-v4-flash`). See `model-routing.mdc`.
109
+
110
+ See rule [cross-ide-bridge.mdc](../../rules/cross-ide-bridge.mdc) and [packages/zenkit-bridge/README.md](../../../packages/zenkit-bridge/README.md) (from repo root).
111
+
112
+ ## Load on demand
113
+
114
+ Read only the file that matches the task:
115
+
116
+ - [TIER 0 - Automatic Analysis (ALWAYS ACTIVE)](references/tier-0-automatic-analysis-always-active.md)
117
+ - [4. Response Format](references/4-response-format.md)
118
+ - [Domain Detection Rules](references/domain-detection-rules.md)
119
+ - [Complexity Assessment](references/complexity-assessment.md)
120
+ - [Implementation Rules](references/implementation-rules.md)
121
+ - [Edge Cases](references/edge-cases.md)
122
+ - [Integration with Existing Workflows](references/integration-with-existing-workflows.md)
123
+ - [Testing the System](references/testing-the-system.md)
124
+ - [Performance Considerations](references/performance-considerations.md)
125
+ - [User Education](references/user-education.md)
126
+ - [Debugging Agent Selection](references/debugging-agent-selection.md)
127
+ - [DEBUG: Intelligent Routing](references/debug-intelligent-routing.md)
128
+ - [Summary](references/summary.md)
@@ -0,0 +1,16 @@
1
+ ## 4. Response Format
2
+
3
+ **When auto-selecting an agent, inform the user concisely:**
4
+
5
+ ```markdown
6
+ 🤖 **Applying knowledge of `@security-auditor` + `@backend-specialist`...**
7
+
8
+ [Proceed with specialized response]
9
+ ```
10
+
11
+ **Benefits:**
12
+
13
+ - ✅ User sees which expertise is being applied
14
+ - ✅ Transparent decision-making
15
+ - ✅ Still automatic (no /commands needed)
16
+
@@ -0,0 +1,29 @@
1
+ ## Complexity Assessment
2
+
3
+ ### SIMPLE (Direct agent invocation)
4
+
5
+ - Single file edit
6
+ - Clear, specific task
7
+ - One domain only
8
+ - Example: "Fix the login button style"
9
+
10
+ **Action**: Auto-invoke respective agent
11
+
12
+ ### MODERATE (2-3 agents)
13
+
14
+ - 2-3 files affected
15
+ - Clear requirements
16
+ - 2 domains max
17
+ - Example: "Add API endpoint for user profile"
18
+
19
+ **Action**: Auto-invoke relevant agents sequentially
20
+
21
+ ### COMPLEX (Orchestrator required)
22
+
23
+ - Multiple files/domains
24
+ - Architectural decisions needed
25
+ - Unclear requirements
26
+ - Example: "Build a social media app"
27
+
28
+ **Action**: Auto-invoke `orchestrator` → will ask Socratic questions
29
+
@@ -0,0 +1,9 @@
1
+ ## DEBUG: Intelligent Routing
2
+
3
+ Show selection reasoning:
4
+
5
+ - Detected domains: [list]
6
+ - Selected agent: [name]
7
+ - Reasoning: [why]
8
+ ```
9
+
@@ -0,0 +1,7 @@
1
+ ## Debugging Agent Selection
2
+
3
+ ### Enable Debug Mode (for development)
4
+
5
+ Add to ZENKIT.mdc temporarily:
6
+
7
+ ```markdown
@@ -0,0 +1,29 @@
1
+ ## Domain Detection Rules
2
+
3
+ ### Single-Domain Tasks (Auto-invoke Single Agent)
4
+
5
+ | Domain | Patterns | Agent |
6
+ | --------------- | ------------------------------------------ | ----------------------- |
7
+ | **Security** | auth, login, jwt, password, hash, token | `security-auditor` |
8
+ | **Frontend** | component, react, vue, css, html, tailwind | `frontend-specialist` |
9
+ | **Backend** | api, server, express, fastapi, node | `backend-specialist` |
10
+ | **Mobile** | react native, flutter, ios, android, expo | `mobile-developer` |
11
+ | **Database** | prisma, sql, mongodb, schema, migration | `database-architect` |
12
+ | **Testing** | test, jest, vitest, playwright, cypress | `test-engineer` |
13
+ | **DevOps** | docker, kubernetes, ci/cd, pm2, nginx | `devops-engineer` |
14
+ | **Debug** | error, bug, crash, not working, issue | `debugger` |
15
+ | **Performance** | slow, lag, optimize, cache, performance | `performance-optimizer` |
16
+ | **SEO** | seo, meta, analytics, sitemap, robots | `seo-specialist` |
17
+ | **Game** | unity, godot, phaser, game, multiplayer | `game-developer` |
18
+
19
+ ### Multi-Domain Tasks (Auto-invoke Orchestrator)
20
+
21
+ If request matches **2+ domains from different categories**, automatically use `orchestrator`:
22
+
23
+ ```text
24
+ Example: "Create a secure login system with dark mode UI"
25
+ → Detected: Security + Frontend
26
+ → Auto-invoke: orchestrator
27
+ → Orchestrator will handle: security-auditor, frontend-specialist, test-engineer
28
+ ```
29
+
@@ -0,0 +1,29 @@
1
+ ## Edge Cases
2
+
3
+ ### Case 1: Generic Question
4
+
5
+ ```text
6
+ User: "How does React work?"
7
+ → Type: QUESTION
8
+ → No agent needed
9
+ → Respond directly with explanation
10
+ ```
11
+
12
+ ### Case 2: Extremely Vague Request
13
+
14
+ ```text
15
+ User: "Make it better"
16
+ → Complexity: UNCLEAR
17
+ → Action: Ask clarifying questions first
18
+ → Then route to appropriate agent
19
+ ```
20
+
21
+ ### Case 3: Contradictory Patterns
22
+
23
+ ```text
24
+ User: "Add mobile support to the web app"
25
+ → Conflict: mobile vs web
26
+ → Action: Ask: "Do you want responsive web or native mobile app?"
27
+ → Then route accordingly
28
+ ```
29
+
@@ -0,0 +1,35 @@
1
+ ## Implementation Rules
2
+
3
+ ### Rule 1: Silent Analysis
4
+
5
+ #### DO NOT announce "I'm analyzing your request..."
6
+
7
+ - ✅ Analyze silently
8
+ - ✅ Inform which agent is being applied
9
+ - ❌ Avoid verbose meta-commentary
10
+
11
+ ### Rule 2: Inform Agent Selection
12
+
13
+ **DO inform which expertise is being applied:**
14
+
15
+ ```markdown
16
+ 🤖 **Applying knowledge of `@frontend-specialist`...**
17
+
18
+ I will create the component with the following characteristics:
19
+ [Continue with specialized response]
20
+ ```
21
+
22
+ ### Rule 3: Seamless Experience
23
+
24
+ **The user should not notice a difference from talking to the right specialist directly.**
25
+
26
+ ### Rule 4: Override Capability
27
+
28
+ **User can still explicitly mention agents:**
29
+
30
+ ```text
31
+ User: "Use @backend-specialist to review this"
32
+ → Override auto-selection
33
+ → Use explicitly mentioned agent
34
+ ```
35
+