@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,77 @@
1
+ # Trade-off Analysis & ADR
2
+
3
+ > Document every architectural decision with trade-offs.
4
+
5
+ ## Decision Framework
6
+
7
+ For EACH architectural component, document:
8
+
9
+ ```markdown
10
+ ## Architecture Decision Record
11
+
12
+ ### Context
13
+ - **Problem**: [What problem are we solving?]
14
+ - **Constraints**: [Team size, scale, timeline, budget]
15
+
16
+ ### Options Considered
17
+
18
+ | Option | Pros | Cons | Complexity | When Valid |
19
+ |--------|------|------|------------|-----------|
20
+ | Option A | Benefit 1 | Cost 1 | Low | [Conditions] |
21
+ | Option B | Benefit 2 | Cost 2 | High | [Conditions] |
22
+
23
+ ### Decision
24
+ **Chosen**: [Option B]
25
+
26
+ ### Rationale
27
+ 1. [Reason 1 - tied to constraints]
28
+ 2. [Reason 2 - tied to requirements]
29
+
30
+ ### Trade-offs Accepted
31
+ - [What we're giving up]
32
+ - [Why this is acceptable]
33
+
34
+ ### Consequences
35
+ - **Positive**: [Benefits we gain]
36
+ - **Negative**: [Costs/risks we accept]
37
+ - **Mitigation**: [How we'll address negatives]
38
+
39
+ ### Revisit Trigger
40
+ - [When to reconsider this decision]
41
+ ```
42
+
43
+ ## ADR Template
44
+
45
+ ```markdown
46
+ # ADR-[XXX]: [Decision Title]
47
+
48
+ ## Status
49
+ Proposed | Accepted | Deprecated | Superseded by [ADR-YYY]
50
+
51
+ ## Context
52
+ [What problem? What constraints?]
53
+
54
+ ## Decision
55
+ [What we chose - be specific]
56
+
57
+ ## Rationale
58
+ [Why - tie to requirements and constraints]
59
+
60
+ ## Trade-offs
61
+ [What we're giving up - be honest]
62
+
63
+ ## Consequences
64
+ - **Positive**: [Benefits]
65
+ - **Negative**: [Costs]
66
+ - **Mitigation**: [How to address]
67
+ ```
68
+
69
+ ## ADR Storage
70
+
71
+ ```
72
+ docs/
73
+ └── architecture/
74
+ β”œβ”€β”€ adr-001-use-nextjs.md
75
+ β”œβ”€β”€ adr-002-postgresql-over-mongodb.md
76
+ └── adr-003-adopt-repository-pattern.md
77
+ ```
@@ -0,0 +1,203 @@
1
+ ---
2
+ name: bash-linux
3
+ description: Bash/Linux terminal patterns. Critical commands, piping, error handling, scripting. Use when working on macOS or Linux systems.
4
+ when_to_use: "When working on macOS or Linux systems, writing bash scripts, or using terminal commands. NOT for Windows/PowerShell environments."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
6
+ ---
7
+
8
+ # Bash Linux Patterns
9
+
10
+ > Essential patterns for Bash on Linux/macOS.
11
+
12
+ ---
13
+
14
+ ## 1. Operator Syntax
15
+
16
+ ### Chaining Commands
17
+
18
+ | Operator | Meaning | Example |
19
+ |----------|---------|---------|
20
+ | `;` | Run sequentially | `cmd1; cmd2` |
21
+ | `&&` | Run if previous succeeded | `npm install && npm run dev` |
22
+ | `\|\|` | Run if previous failed | `npm test \|\| echo "Tests failed"` |
23
+ | `\|` | Pipe output | `ls \| grep ".js"` |
24
+
25
+ ---
26
+
27
+ ## 2. File Operations
28
+
29
+ ### Essential Commands
30
+
31
+ | Task | Command |
32
+ |------|---------|
33
+ | List all | `ls -la` |
34
+ | Find files | `find . -name "*.js" -type f` |
35
+ | File content | `cat file.txt` |
36
+ | First N lines | `head -n 20 file.txt` |
37
+ | Last N lines | `tail -n 20 file.txt` |
38
+ | Follow log | `tail -f log.txt` |
39
+ | Search in files | `grep -r "pattern" --include="*.js"` |
40
+ | File size | `du -sh *` |
41
+ | Disk usage | `df -h` |
42
+
43
+ ---
44
+
45
+ ## 3. Process Management
46
+
47
+ | Task | Command |
48
+ |------|---------|
49
+ | List processes | `ps aux` |
50
+ | Find by name | `pgrep -fl node` |
51
+ | Terminate gracefully | `kill <PID>` (use `kill -9` only if unresponsive) |
52
+ | Find port user | `lsof -i :3000` |
53
+ | Terminate port user | `pids=$(lsof -t -i :3000) && [ -n "$pids" ] && kill $pids` |
54
+ | Background | `npm run dev &` |
55
+ | Jobs | `jobs -l` |
56
+ | Bring to front | `fg %1` |
57
+
58
+ ---
59
+
60
+ ## 4. Text Processing
61
+
62
+ ### Core Tools
63
+
64
+ | Tool | Purpose | Example |
65
+ |------|---------|---------|
66
+ | `grep` | Search | `grep -rn "TODO" src/` |
67
+ | `sed` | Replace | `sed -i 's/old/new/g' file.txt` |
68
+ | `awk` | Extract columns | `awk '{print $1}' file.txt` |
69
+ | `cut` | Cut fields | `cut -d',' -f1 data.csv` |
70
+ | `sort` | Sort lines | `sort -u file.txt` |
71
+ | `uniq` | Unique lines | `sort file.txt \| uniq -c` |
72
+ | `wc` | Count | `wc -l file.txt` |
73
+
74
+ ---
75
+
76
+ ## 5. Environment Variables
77
+
78
+ | Task | Command |
79
+ |------|---------|
80
+ | View all | `env` or `printenv` |
81
+ | View one | `echo $PATH` |
82
+ | Set temporary | `export VAR="value"` |
83
+ | Set in script | `VAR="value" command` |
84
+ | Add to PATH | `export PATH="$PATH:/new/path"` |
85
+
86
+ ---
87
+
88
+ ## 6. Network
89
+
90
+ | Task | Command |
91
+ |------|---------|
92
+ | Download | `curl -O https://example.com/file` |
93
+ | API request | `curl -X GET https://api.example.com` |
94
+ | POST JSON | `curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' URL` |
95
+ | Check port | `nc -zv localhost 3000` |
96
+ | Network info | `ifconfig` or `ip addr` |
97
+
98
+ ---
99
+
100
+ ## 7. Script Template
101
+
102
+ ```bash
103
+ #!/bin/bash
104
+ set -euo pipefail # Exit on error, undefined var, pipe fail
105
+
106
+ # Colors (optional)
107
+ RED='\033[0;31m'
108
+ GREEN='\033[0;32m'
109
+ NC='\033[0m'
110
+
111
+ # Script directory
112
+ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
113
+
114
+ # Functions (use printf for predictable output)
115
+ log_info() { printf "%b[INFO]%b %s\n" "${GREEN}" "${NC}" "$*"; }
116
+ log_error() { printf "%b[ERROR]%b %s\n" "${RED}" "${NC}" "$*" >&2; }
117
+
118
+ # Main
119
+ main() {
120
+ log_info "Starting..."
121
+ # Your logic here
122
+ log_info "Done!"
123
+ }
124
+
125
+ main "$@"
126
+ ```
127
+
128
+ ---
129
+
130
+ ## 8. Common Patterns
131
+
132
+ ### Check if command exists
133
+
134
+ ```bash
135
+ if command -v node &> /dev/null; then
136
+ echo "Node is installed"
137
+ fi
138
+ ```
139
+
140
+ ### Default variable value
141
+
142
+ ```bash
143
+ NAME=${1:-"default_value"}
144
+ ```
145
+
146
+ ### Read file line by line
147
+
148
+ ```bash
149
+ while IFS= read -r line; do
150
+ echo "$line"
151
+ done < file.txt
152
+ ```
153
+
154
+ ### Loop over files (with nullglob safety)
155
+
156
+ ```bash
157
+ shopt -s nullglob
158
+ for file in *.js; do
159
+ echo "Processing $file"
160
+ done
161
+ shopt -u nullglob
162
+ ```
163
+
164
+ ---
165
+
166
+ ## 9. Differences from PowerShell
167
+
168
+ | Task | PowerShell | Bash |
169
+ |------|------------|------|
170
+ | List files | `Get-ChildItem` | `ls -la` |
171
+ | Find files | `Get-ChildItem -Recurse` | `find . -type f` |
172
+ | Environment | `$env:VAR` | `$VAR` |
173
+ | String concat | `"$a$b"` | `"$a$b"` (same) |
174
+ | Null check | `if ($x)` | `if [ -n "$x" ]` |
175
+ | Pipeline | Object-based | Text-based |
176
+
177
+ ---
178
+
179
+ ## 10. Error Handling
180
+
181
+ ### Set options
182
+
183
+ ```bash
184
+ set -e # Exit on error
185
+ set -u # Exit on undefined variable
186
+ set -o pipefail # Exit on pipe failure
187
+ set -x # Debug: print commands
188
+ ```
189
+
190
+ ### Trap for cleanup (use mktemp for race-free files)
191
+
192
+ ```bash
193
+ TMP_FILE=$(mktemp)
194
+ cleanup() {
195
+ echo "Cleaning up..."
196
+ rm -f "$TMP_FILE"
197
+ }
198
+ trap cleanup EXIT
199
+ ```
200
+
201
+ ---
202
+
203
+ > **Remember:** Bash is text-based. Use `&&` for success chains, `set -e` for safety, and quote your variables!
@@ -0,0 +1,112 @@
1
+ ---
2
+ name: batch-operations
3
+ description: Apply operations across multiple files simultaneously. Pattern-based bulk modifications, search-and-replace across codebases, consistent changes to many files at once.
4
+ when_to_use: "When the user needs to change multiple files with the same pattern, rename across a codebase, add imports to many files, update versions, or apply consistent modifications. NOT for single-file edits."
5
+ allowed-tools: Read, Write, Edit, Grep, Glob, Bash
6
+ effort: medium
7
+ ---
8
+
9
+ # Batch Operations β€” Multi-File Changes
10
+
11
+ > Apply consistent changes across many files at once. One pattern, many targets.
12
+
13
+ ## When to Use
14
+
15
+ βœ… **Good for:**
16
+ - Renaming a function/component across all files that use it
17
+ - Adding an import to every file in a directory
18
+ - Updating version numbers across package files
19
+ - Applying the same code pattern to multiple similar files
20
+ - Migrating from one API to another across the codebase
21
+ - Adding/removing a field from all similar data structures
22
+
23
+ ❌ **Not for:**
24
+ - Single-file edits (use direct editing)
25
+ - Unique changes per file (handle individually)
26
+ - Changes that need per-file judgment (use an agent per domain)
27
+
28
+ ---
29
+
30
+ ## Batch Operation Protocol
31
+
32
+ ### Step 1: Define the Pattern
33
+ ```
34
+ What: [exact text/pattern to find]
35
+ Replace: [exact replacement text]
36
+ Scope: [file glob pattern, e.g., "src/**/*.tsx"]
37
+ Exclude: [files to skip, e.g., "**/*.test.tsx"]
38
+ ```
39
+
40
+ ### Step 2: Preview Before Executing
41
+ ```bash
42
+ # Find all affected files FIRST
43
+ grep -rl "oldPattern" src/ --include="*.ts"
44
+
45
+ # Count matches
46
+ grep -rc "oldPattern" src/ --include="*.ts" | grep -v ":0$"
47
+
48
+ # Show context for each match
49
+ grep -rn "oldPattern" src/ --include="*.ts"
50
+ ```
51
+
52
+ > πŸ”΄ **NEVER batch-modify without previewing first.** Show the user what will change.
53
+
54
+ ### Step 3: Execute the Batch
55
+
56
+ For text replacements across large codebases (process in throttled, recoverable chunks):
57
+ ```bash
58
+ # On Linux/macOS: use ast-grep, sd or targeted find with dry-run/diff review first
59
+ # Avoid unbounded sed -i bursts that saturate disk I/O on shared filesystems:
60
+ find src -name "*.ts" -print0 | xargs -0 -n 25 sed -i 's/oldPattern/newPattern/g'
61
+
62
+ # On Windows (PowerShell): stream content without loading entire files into memory:
63
+ Get-ChildItem -Path src -Recurse -Filter *.ts |
64
+ ForEach-Object {
65
+ $content = [System.IO.File]::ReadAllText($_.FullName)
66
+ if ($content.Contains('oldPattern')) {
67
+ [System.IO.File]::WriteAllText($_.FullName, $content.Replace('oldPattern', 'newPattern'))
68
+ }
69
+ }
70
+ ```
71
+
72
+ For structural changes (adding imports, wrapping code):
73
+ - Use the Edit tool or ast-grep (`sg`) on each file for semantic safety
74
+ - Process files in manageable batches (10-25 files per step), verifying git status between chunks
75
+ - Ensure operations are idempotent (e.g. check if `export { X }` already exists before appending)
76
+
77
+ ### Step 4: Verify the Batch
78
+ ```bash
79
+ # Confirm no missed instances
80
+ grep -rl "oldPattern" src/ --include="*.ts"
81
+ # Should return empty
82
+
83
+ # Confirm replacements are correct
84
+ grep -rn "newPattern" src/ --include="*.ts" | head -5
85
+
86
+ # Run tests to catch breakage
87
+ npm run test
88
+ npm run build
89
+ ```
90
+
91
+ ---
92
+
93
+ ## Common Batch Patterns
94
+
95
+ | Operation | Command Pattern |
96
+ |---|---|
97
+ | **Rename import** | Find all `import { X }` β†’ replace with `import { Y }` |
98
+ | **Update version** | Find `"version": "1.0"` β†’ replace across all package.json |
99
+ | **Add export** | Append `export { X }` to all index files |
100
+ | **Remove deprecated** | Find `deprecatedFn()` β†’ replace with `newFn()` |
101
+ | **Add header** | Prepend license header to all source files |
102
+ | **Type migration** | Find `interface X` β†’ replace with `type X =` |
103
+
104
+ ---
105
+
106
+ ## Safety Rules
107
+
108
+ 1. **Preview first** β€” always show affected files before modifying
109
+ 2. **Git safety** β€” ensure clean working directory (`git stash` or commit first)
110
+ 3. **Exclude tests** β€” often tests need different treatment than source
111
+ 4. **Verify after** β€” run build + tests after every batch operation
112
+ 5. **Report changes** β€” list every file modified with change summary
@@ -0,0 +1,255 @@
1
+ ---
2
+ name: behavioral-modes
3
+ description: AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate). Use to adapt behavior based on task type.
4
+ when_to_use: "When adapting AI behavior for specific task types: brainstorm, implement, debug, review, teach, ship, or orchestrate modes."
5
+ allowed-tools: Read, Write, Edit, Glob, Grep, Bash
6
+ ---
7
+
8
+ # Behavioral Modes - Adaptive AI Operating Modes
9
+
10
+ ## Purpose
11
+ This skill defines distinct behavioral modes that optimize AI performance for specific tasks. Modes change how the AI approaches problems, communicates, and prioritizes.
12
+
13
+ ---
14
+
15
+ ## Available Modes
16
+
17
+ ### 1. 🧠 BRAINSTORM Mode
18
+
19
+ **When to use:** Early project planning, feature ideation, architecture decisions
20
+
21
+ **Behavior:**
22
+ - Ask clarifying questions before assumptions
23
+ - Offer multiple alternatives (at least 3)
24
+ - Think divergently - explore unconventional solutions
25
+ - No code yet - focus on ideas and options
26
+ - Use visual diagrams (mermaid) to explain concepts
27
+
28
+ **Output style:**
29
+ ```
30
+ "Let's explore this together. Here are some approaches:
31
+
32
+ Option A: [description]
33
+ βœ… Pros: ...
34
+ ❌ Cons: ...
35
+
36
+ Option B: [description]
37
+ βœ… Pros: ...
38
+ ❌ Cons: ...
39
+
40
+ What resonates with you? Or should we explore a different direction?"
41
+ ```
42
+
43
+ ---
44
+
45
+ ### 2. ⚑ IMPLEMENT Mode
46
+
47
+ **When to use:** Writing code, building features, executing plans
48
+
49
+ **Behavior:**
50
+ - **CRITICAL: Use `clean-code` skill standards** - concise, direct, no verbose explanations
51
+ - Fast execution - minimize questions
52
+ - Use established patterns and best practices
53
+ - Write complete, production-ready code
54
+ - Include error handling and edge cases
55
+ - **NO tutorial-style explanations** - just code
56
+ - **NO unnecessary comments** - let code self-document
57
+ - **NO over-engineering** - solve the problem directly
58
+ - **NO RUSHING** - Quality > Speed. Read ALL references before coding.
59
+
60
+ **Output style:**
61
+ ```
62
+ [Code block]
63
+
64
+ [Brief summary, max 1-2 sentences]
65
+ ```
66
+
67
+ **NOT:**
68
+ ```
69
+ "Building [feature]...
70
+
71
+ βœ“ Created [file1]
72
+ βœ“ Created [file2]
73
+ βœ“ Updated [file3]
74
+
75
+ [long explanation]
76
+
77
+ Run `npm run dev` to test."
78
+ ```
79
+
80
+ ---
81
+
82
+ ### 3. πŸ” DEBUG Mode
83
+
84
+ **When to use:** Fixing bugs, troubleshooting errors, investigating issues
85
+
86
+ **Behavior:**
87
+ - Ask for error messages and reproduction steps
88
+ - Think systematically - check logs, trace data flow
89
+ - Form hypothesis β†’ test β†’ verify
90
+ - Explain the root cause, not just the fix
91
+ - Prevent future occurrences
92
+
93
+ **Output style:**
94
+ ```
95
+ "Investigating...
96
+
97
+ πŸ” Symptom: [what's happening]
98
+ 🎯 Root cause: [why it's happening]
99
+ βœ… Fix: [the solution]
100
+ πŸ›‘οΈ Prevention: [how to avoid in future]
101
+ ```
102
+
103
+ ---
104
+
105
+ ### 4. πŸ“‹ REVIEW Mode
106
+
107
+ **When to use:** Code review, architecture review, security audit
108
+
109
+ **Behavior:**
110
+ - Be thorough but constructive
111
+ - Categorize by severity (Critical/High/Medium/Low)
112
+ - Explain the "why" behind suggestions
113
+ - Offer improved code examples
114
+ - Acknowledge what's done well
115
+
116
+ **Output style:**
117
+ ```
118
+ ## Code Review: [file/feature]
119
+
120
+ ### πŸ”΄ Critical
121
+ - [issue with explanation]
122
+
123
+ ### 🟠 Improvements
124
+ - [suggestion with example]
125
+
126
+ ### 🟒 Good
127
+ - [positive observation]
128
+ ```
129
+
130
+ ---
131
+
132
+ ### 5. πŸ“š TEACH Mode
133
+
134
+ **When to use:** Explaining concepts, documentation, onboarding
135
+
136
+ **Behavior:**
137
+ - Explain from fundamentals
138
+ - Use analogies and examples
139
+ - Progress from simple to complex
140
+ - Include practical exercises
141
+ - Check understanding
142
+
143
+ **Output style:**
144
+ ```
145
+ ## Understanding [Concept]
146
+
147
+ ### What is it?
148
+ [Simple explanation with analogy]
149
+
150
+ ### How it works
151
+ [Technical explanation with diagram]
152
+
153
+ ### Example
154
+ [Code example with comments]
155
+
156
+ ### Try it yourself
157
+ [Exercise or task]
158
+ ```
159
+
160
+ ---
161
+
162
+ ### 6. πŸš€ SHIP Mode
163
+
164
+ **When to use:** Production deployment, final polish, release preparation
165
+
166
+ **Behavior:**
167
+ - Focus on stability over features
168
+ - Check for missing error handling
169
+ - Verify environment configs
170
+ - Run all tests
171
+ - Create deployment checklist
172
+
173
+ **Output style:**
174
+ ```
175
+ ## Pre-Ship Checklist
176
+
177
+ ### βœ… Code Quality
178
+ - [ ] No TypeScript errors
179
+ - [ ] ESLint passing
180
+ - [ ] All tests passing
181
+
182
+ ### βœ… Security
183
+ - [ ] No exposed secrets
184
+ - [ ] Input validation complete
185
+
186
+ ### βœ… Performance
187
+ - [ ] Bundle size acceptable
188
+ - [ ] No console.logs
189
+
190
+ ### πŸš€ Ready to deploy
191
+ ```
192
+
193
+ ---
194
+
195
+ ## Mode Detection
196
+
197
+ ### Mode Precedence & Intent Resolution
198
+
199
+ When user input contains conflicting keywords (e.g. "review bug and create fix"), resolve by task phase precedence:
200
+ 1. **DEBUG** (investigate root cause first if an error exists)
201
+ 2. **BRAINSTORM** (clarify architecture if options are requested)
202
+ 3. **IMPLEMENT** (execute the change once the path is clear)
203
+ 4. **REVIEW** (audit changes after implementation)
204
+ 5. **SHIP** (verification and release)
205
+
206
+ | Primary Intent | Default Mode |
207
+ |----------------|--------------|
208
+ | "what if", "ideas", "compare options" | BRAINSTORM |
209
+ | "build", "create", "implement" | IMPLEMENT |
210
+ | "not working", "error", "stack trace" | DEBUG |
211
+ | "review", "check diff", "audit" | REVIEW |
212
+ | "explain", "how does", "walk me through" | TEACH |
213
+ | "deploy", "release", "ship to prod" | SHIP |
214
+
215
+ ---
216
+
217
+ ## Multi-Agent Collaboration Patterns (2025)
218
+
219
+ Modern architectures optimized for agent-to-agent collaboration:
220
+
221
+ ### 1. πŸ”­ EXPLORE Mode
222
+ **Role:** Discovery and Analysis (Explorer Agent)
223
+ **Behavior:** Socratic questioning, deep-dive code reading, dependency mapping.
224
+ **Output:** `discovery-report.json`, architectural visualization.
225
+
226
+ ### 2. πŸ—ΊοΈ PLAN-EXECUTE-CRITIC (PEC)
227
+ Cyclic mode transitions for high-complexity tasks:
228
+ 1. **Planner:** Decomposes the task into atomic steps (`task.md`).
229
+ 2. **Executor:** Performs the actual coding (`IMPLEMENT`).
230
+ 3. **Critic:** Reviews the code, performs security and performance checks (`REVIEW`).
231
+
232
+ ### 3. 🧠 MENTAL MODEL SYNC
233
+ Behavior for creating and loading "Mental Model" summaries to preserve context between sessions.
234
+
235
+ ---
236
+
237
+ ## Combining Modes
238
+
239
+ When a complex task spans multiple modes across steps:
240
+ - **Phase transition:** Explicitly declare mode transitions between task milestones (e.g., `Moving from DEBUG to IMPLEMENT`).
241
+ - **Isolation:** Execute in one mode per turn; never blend contradictory behaviors (e.g. brainstorming speculative alternatives while writing production code).
242
+ - **Fallback:** If uncertainty arises during `IMPLEMENT`, switch temporarily to `BRAINSTORM` with trade-offs before proceeding.
243
+
244
+ ---
245
+
246
+ ## Manual Mode Switching
247
+
248
+ Users can explicitly request a mode:
249
+
250
+ ```
251
+ /brainstorm new feature ideas
252
+ /implement the user profile page
253
+ /debug why login fails
254
+ /review this pull request
255
+ ```