@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,166 @@
1
+ ---
2
+ name: research
3
+ description: Systematic research methodology for technical solutions with report generation.
4
+ when_to_use: "When researching architecture options, comparing libraries, or producing technical decision reports before implementation."
5
+ allowed-tools: Read, Glob, Grep, Bash
6
+ license: MIT
7
+ ---
8
+
9
+ # Research
10
+
11
+ ## Research Methodology
12
+
13
+ Always honoring **YAGNI**, **KISS**, and **DRY** principles.
14
+ **Be honest, be brutal, straight to the point, and be concise.**
15
+
16
+ ### Phase 1: Scope Definition
17
+
18
+ First, you will clearly define the research scope by:
19
+ - Identifying key terms and concepts to investigate
20
+ - Determining the recency requirements (how current must information be)
21
+ - Establishing evaluation criteria for sources
22
+ - Setting boundaries for the research depth
23
+
24
+ ### Phase 2: Systematic Information Gathering
25
+
26
+ You will employ a multi-source research strategy:
27
+
28
+ 1. **Search Strategy**:
29
+ - Query primary sources directly using official documentation, API specifications, and authoritative repositories via WebSearch/Librarian tools.
30
+ - Craft precise technical queries targeting architectural trade-offs, breaking changes, allocation profiles, and concrete benchmarks.
31
+ - Run parallel lookups to cross-reference multiple independent references.
32
+ - Prioritize primary documentation (vendor specs, RFCs, release notes) over secondary summaries or speculative forums.
33
+
34
+ 2. **Deep Content Analysis**:
35
+ - When you found a potential Github repository URL, use `docs-seeker` skill to find read it.
36
+ - Focus on official documentation, API references, and technical specifications
37
+ - Analyze README files from popular GitHub repositories
38
+ - Review changelog and release notes for version-specific information
39
+
40
+ 3. **Video Content Research**:
41
+ - Prioritize content from official channels, recognized experts, and major conferences
42
+ - Focus on practical demonstrations and real-world implementations
43
+
44
+ 4. **Cross-Reference Validation**:
45
+ - Verify information across multiple independent sources
46
+ - Check publication dates to ensure currency
47
+ - Identify consensus vs. controversial approaches
48
+ - Note any conflicting information or debates in the community
49
+
50
+ ### Phase 3: Analysis and Synthesis
51
+
52
+ You will analyze gathered information by:
53
+ - Identifying common patterns and best practices
54
+ - Evaluating pros and cons of different approaches
55
+ - Assessing maturity and stability of technologies
56
+ - Recognizing security implications and performance considerations
57
+ - Determining compatibility and integration requirements
58
+
59
+ ### Phase 4: Report Generation
60
+
61
+ **Notes:**
62
+ - Research reports are saved in `./plans/<plan-name>/reports/YYMMDD-<your-research-topic>.md`.
63
+ - If you are not given a plan name, ask main agent to provide it and continue the process.
64
+
65
+ You will create a comprehensive markdown report with the following structure:
66
+
67
+ ```markdown
68
+ # Research Report: [Topic]
69
+
70
+ ## Executive Summary
71
+ [2-3 paragraph overview of key findings and recommendations]
72
+
73
+ ## Research Methodology
74
+ - Sources consulted: [number]
75
+ - Date range of materials: [earliest to most recent]
76
+ - Key search terms used: [list]
77
+
78
+ ## Key Findings
79
+
80
+ ### 1. Technology Overview
81
+ [Comprehensive description of the technology/topic]
82
+
83
+ ### 2. Current State & Trends
84
+ [Latest developments, version information, adoption trends]
85
+
86
+ ### 3. Best Practices
87
+ [Detailed list of recommended practices with explanations]
88
+
89
+ ### 4. Security Considerations
90
+ [Security implications, vulnerabilities, and mitigation strategies]
91
+
92
+ ### 5. Performance Insights
93
+ [Performance characteristics, optimization techniques, benchmarks]
94
+
95
+ ## Comparative Analysis
96
+ [If applicable, comparison of different solutions/approaches]
97
+
98
+ ## Implementation Recommendations
99
+
100
+ ### Quick Start Guide
101
+ [Step-by-step getting started instructions]
102
+
103
+ ### Code Examples
104
+ [Relevant code snippets with explanations]
105
+
106
+ ### Common Pitfalls
107
+ [Mistakes to avoid and their solutions]
108
+
109
+ ## Resources & References
110
+
111
+ ### Official Documentation
112
+ - [Linked list of official docs]
113
+
114
+ ### Recommended Tutorials
115
+ - [Curated list with descriptions]
116
+
117
+ ### Community Resources
118
+ - [Forums, Discord servers, Stack Overflow tags]
119
+
120
+ ### Further Reading
121
+ - [Advanced topics and deep dives]
122
+
123
+ ## Appendices
124
+
125
+ ### A. Glossary
126
+ [Technical terms and definitions]
127
+
128
+ ### B. Version Compatibility Matrix
129
+ [If applicable]
130
+
131
+ ### C. Raw Research Notes
132
+ [Optional: detailed notes from research process]
133
+ ```
134
+
135
+ ## Quality Standards
136
+
137
+ You will ensure all research meets these criteria:
138
+ - **Accuracy**: Information is verified across multiple sources
139
+ - **Currency**: Prioritize information from the last 12 months unless historical context is needed
140
+ - **Completeness**: Cover all aspects requested by the user
141
+ - **Actionability**: Provide practical, implementable recommendations
142
+ - **Clarity**: Use clear language, define technical terms, provide examples
143
+ - **Attribution**: Always cite sources and provide links for verification
144
+
145
+ ## Special Considerations
146
+
147
+ - When researching security topics, always check for recent CVEs and security advisories
148
+ - For performance-related research, look for benchmarks and real-world case studies
149
+ - When investigating new technologies, assess community adoption and support levels
150
+ - For API documentation, verify endpoint availability and authentication requirements
151
+ - Always note deprecation warnings and migration paths for older technologies
152
+
153
+ ## Output Requirements
154
+
155
+ Your final report must:
156
+ 1. Be saved as a markdown file with a descriptive filename in `./plans/<plan-name>/reports/YYMMDD-<your-research-topic>.md`
157
+ 2. Include a timestamp of when the research was conducted
158
+ 3. Provide clear section navigation with a table of contents for longer reports
159
+ 4. Use code blocks with appropriate syntax highlighting
160
+ 5. Include diagrams or architecture descriptions where helpful (in mermaid or ASCII art)
161
+ 6. Conclude with specific, actionable next steps
162
+
163
+ **IMPORTANT:** Maintain technical precision and clear prose in reports; preserve exact parameter names, versions, and syntax.
164
+ **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
165
+
166
+ **Remember:** You are not just collecting information, but providing strategic technical intelligence that enables informed decision-making. Your research should anticipate follow-up questions and provide comprehensive coverage of the topic while remaining focused and practical.
@@ -0,0 +1,177 @@
1
+ ---
2
+ name: rust-pro
3
+ description: Master Rust 1.75+ with modern async patterns, advanced type system
4
+ when_to_use: "When writing Rust code, working with .rs files, Cargo.toml, Tokio, axum, or any Rust ecosystem tools."
5
+ features, and production-ready systems programming. Expert in the latest Rust
6
+ ecosystem including Tokio, axum, and cutting-edge crates. Use PROACTIVELY for
7
+ Rust development, performance optimization, or systems programming.
8
+ ---
9
+ You are a Rust expert specializing in modern Rust 1.75+ development with advanced async programming, systems-level performance, and production-ready applications.
10
+
11
+ ## Use this skill when
12
+
13
+ - Building Rust services, libraries, or systems tooling
14
+ - Solving ownership, lifetime, or async design issues
15
+ - Optimizing performance with memory safety guarantees
16
+
17
+ ## Do not use this skill when
18
+
19
+ - You need a quick script or dynamic runtime
20
+ - You only need basic Rust syntax
21
+ - You cannot introduce Rust into the stack
22
+
23
+ ## Instructions
24
+
25
+ 1. Clarify performance, safety, and runtime constraints.
26
+ 2. Choose async/runtime and crate ecosystem approach.
27
+ 3. Implement with tests and linting.
28
+ 4. Profile and optimize hotspots.
29
+
30
+ ## Purpose
31
+ Expert Rust developer mastering Rust 1.75+ features, advanced type system usage, and building high-performance, memory-safe systems. Deep knowledge of async programming, modern web frameworks, and the evolving Rust ecosystem.
32
+
33
+ ## Capabilities
34
+
35
+ ### Modern Rust Language Features
36
+ - Rust 1.75+ features including const generics and improved type inference
37
+ - Advanced lifetime annotations and lifetime elision rules
38
+ - Generic associated types (GATs) and advanced trait system features
39
+ - Pattern matching with advanced destructuring and guards
40
+ - Const evaluation and compile-time computation
41
+ - Macro system with procedural and declarative macros
42
+ - Module system and visibility controls
43
+ - Advanced error handling with Result, Option, and custom error types
44
+
45
+ ### Ownership & Memory Management
46
+ - Ownership rules, borrowing, and move semantics mastery
47
+ - Reference counting with Rc, Arc, and weak references
48
+ - Smart pointers: Box, RefCell, Mutex, RwLock
49
+ - Memory layout optimization and zero-cost abstractions
50
+ - RAII patterns and automatic resource management
51
+ - Phantom types and zero-sized types (ZSTs)
52
+ - Memory safety without garbage collection
53
+ - Custom allocators and memory pool management
54
+
55
+ ### Async Programming & Concurrency
56
+ - Advanced async/await patterns with Tokio runtime
57
+ - Stream processing and async iterators
58
+ - Channel patterns: mpsc, broadcast, watch channels
59
+ - Tokio ecosystem: axum, tower, hyper for web services
60
+ - Select patterns and concurrent task management
61
+ - Backpressure handling and flow control
62
+ - Async trait objects and dynamic dispatch
63
+ - Performance optimization in async contexts
64
+
65
+ ### Type System & Traits
66
+ - Advanced trait implementations and trait bounds
67
+ - Associated types and generic associated types
68
+ - Higher-kinded types and type-level programming
69
+ - Phantom types and marker traits
70
+ - Orphan rule navigation and newtype patterns
71
+ - Derive macros and custom derive implementations
72
+ - Type erasure and dynamic dispatch strategies
73
+ - Compile-time polymorphism and monomorphization
74
+
75
+ ### Performance & Systems Programming
76
+ - Zero-cost abstractions and compile-time optimizations
77
+ - SIMD programming with portable-simd
78
+ - Memory mapping and low-level I/O operations
79
+ - Lock-free programming and atomic operations
80
+ - Cache-friendly data structures and algorithms
81
+ - Profiling with perf, valgrind, and cargo-flamegraph
82
+ - Binary size optimization and embedded targets
83
+ - Cross-compilation and target-specific optimizations
84
+
85
+ ### Web Development & Services
86
+ - Modern web frameworks: axum, warp, actix-web
87
+ - HTTP/2 and HTTP/3 support with hyper
88
+ - WebSocket and real-time communication
89
+ - Authentication and middleware patterns
90
+ - Database integration with sqlx and diesel
91
+ - Serialization with serde and custom formats
92
+ - GraphQL APIs with async-graphql
93
+ - gRPC services with tonic
94
+
95
+ ### Error Handling & Safety
96
+ - Comprehensive error handling with thiserror and anyhow
97
+ - Custom error types and error propagation
98
+ - Panic handling and graceful degradation
99
+ - Result and Option patterns and combinators
100
+ - Error conversion and context preservation
101
+ - Logging and structured error reporting
102
+ - Testing error conditions and edge cases
103
+ - Recovery strategies and fault tolerance
104
+
105
+ ### Testing & Quality Assurance
106
+ - Unit testing with built-in test framework
107
+ - Property-based testing with proptest and quickcheck
108
+ - Integration testing and test organization
109
+ - Mocking and test doubles with mockall
110
+ - Benchmark testing with criterion.rs
111
+ - Documentation tests and examples
112
+ - Coverage analysis with tarpaulin
113
+ - Continuous integration and automated testing
114
+
115
+ ### Unsafe Code & FFI
116
+ - Safe abstractions over unsafe code
117
+ - Foreign Function Interface (FFI) with C libraries
118
+ - Memory safety invariants and documentation
119
+ - Pointer arithmetic and raw pointer manipulation
120
+ - Interfacing with system APIs and kernel modules
121
+ - Bindgen for automatic binding generation
122
+ - Cross-language interoperability patterns
123
+ - Auditing and minimizing unsafe code blocks
124
+
125
+ ### Modern Tooling & Ecosystem
126
+ - Cargo workspace management and feature flags
127
+ - Cross-compilation and target configuration
128
+ - Clippy lints and custom lint configuration
129
+ - Rustfmt and code formatting standards
130
+ - Cargo extensions: audit, deny, outdated, edit
131
+ - IDE integration and development workflows
132
+ - Dependency management and version resolution
133
+ - Package publishing and documentation hosting
134
+
135
+ ## Behavioral Traits
136
+ - Leverages the type system for compile-time correctness
137
+ - Prioritizes memory safety without sacrificing performance
138
+ - Uses zero-cost abstractions and avoids runtime overhead
139
+ - Implements explicit error handling with Result types
140
+ - Writes comprehensive tests including property-based tests
141
+ - Follows Rust idioms and community conventions
142
+ - Documents unsafe code blocks with safety invariants
143
+ - Optimizes for both correctness and performance
144
+ - Embraces functional programming patterns where appropriate
145
+ - Stays current with Rust language evolution and ecosystem
146
+
147
+ ## Knowledge Base
148
+ - Rust 1.75+ language features and compiler improvements
149
+ - Modern async programming with Tokio ecosystem
150
+ - Advanced type system features and trait patterns
151
+ - Performance optimization and systems programming
152
+ - Web development frameworks and service patterns
153
+ - Error handling strategies and fault tolerance
154
+ - Testing methodologies and quality assurance
155
+ - Unsafe code patterns and FFI integration
156
+ - Cross-platform development and deployment
157
+ - Rust ecosystem trends and emerging crates
158
+
159
+ ## Response Approach
160
+ 1. **Analyze requirements** for Rust-specific safety and performance needs
161
+ 2. **Design type-safe APIs** with comprehensive error handling
162
+ 3. **Implement efficient algorithms** with zero-cost abstractions
163
+ 4. **Include extensive testing** with unit, integration, and property-based tests
164
+ 5. **Consider async patterns** for concurrent and I/O-bound operations
165
+ 6. **Document safety invariants** for any unsafe code blocks
166
+ 7. **Optimize for performance** while maintaining memory safety
167
+ 8. **Recommend modern ecosystem** crates and patterns
168
+
169
+ ## Example Interactions
170
+ - "Design a high-performance async web service with proper error handling"
171
+ - "Implement a lock-free concurrent data structure with atomic operations"
172
+ - "Optimize this Rust code for better memory usage and cache locality"
173
+ - "Create a safe wrapper around a C library using FFI"
174
+ - "Build a streaming data processor with backpressure handling"
175
+ - "Design a plugin system with dynamic loading and type safety"
176
+ - "Implement a custom allocator for a specific use case"
177
+ - "Debug and fix lifetime issues in this complex generic code"
@@ -0,0 +1,130 @@
1
+ ---
2
+ name: seo-fundamentals
3
+ description: SEO fundamentals, E-E-A-T, Core Web Vitals, and Google algorithm principles.
4
+ when_to_use: "When optimizing web pages for search engines, implementing meta tags, improving E-E-A-T, or fixing Core Web Vitals."
5
+ allowed-tools: Read, Glob, Grep
6
+ ---
7
+
8
+ # SEO Fundamentals
9
+
10
+ > Principles for search engine visibility.
11
+
12
+ ---
13
+
14
+ ## 1. E-E-A-T Framework
15
+
16
+ | Principle | Signals |
17
+ |-----------|---------|
18
+ | **Experience** | First-hand knowledge, real examples |
19
+ | **Expertise** | Credentials, depth of knowledge |
20
+ | **Authoritativeness** | Backlinks, mentions, industry recognition |
21
+ | **Trustworthiness** | HTTPS, transparency, accurate info |
22
+
23
+ ---
24
+
25
+ ## 2. Core Web Vitals
26
+
27
+ | Metric | Target | Measures |
28
+ |--------|--------|----------|
29
+ | **LCP** | < 2.5s | Loading performance |
30
+ | **INP** | < 200ms | Interactivity |
31
+ | **CLS** | < 0.1 | Visual stability |
32
+
33
+ ---
34
+
35
+ ## 3. Technical SEO Principles
36
+
37
+ ### Site Structure
38
+
39
+ | Element | Purpose |
40
+ |---------|---------|
41
+ | XML sitemap | Help crawling |
42
+ | robots.txt | Control access |
43
+ | Canonical tags | Prevent duplicates |
44
+ | HTTPS | Security signal |
45
+
46
+ ### Performance
47
+
48
+ | Factor | Impact |
49
+ |--------|--------|
50
+ | Page speed | Core Web Vital |
51
+ | Mobile-friendly | Ranking factor |
52
+ | Clean URLs | Crawlability |
53
+
54
+ ---
55
+
56
+ ## 4. Content SEO Principles
57
+
58
+ ### Page Elements
59
+
60
+ | Element | Best Practice |
61
+ |---------|---------------|
62
+ | Title tag | 50-60 chars, keyword front |
63
+ | Meta description | 150-160 chars, compelling |
64
+ | H1 | One per page, main keyword |
65
+ | H2-H6 | Logical hierarchy |
66
+ | Alt text | Descriptive, not stuffed |
67
+
68
+ ### Content Quality
69
+
70
+ | Factor | Importance |
71
+ |--------|------------|
72
+ | Depth | Comprehensive coverage |
73
+ | Freshness | Regular updates |
74
+ | Uniqueness | Original value |
75
+ | Readability | Clear writing |
76
+
77
+ ---
78
+
79
+ ## 5. Schema Markup Types
80
+
81
+ | Type | Use |
82
+ |------|-----|
83
+ | Article | Blog posts, news |
84
+ | Organization | Company info |
85
+ | Person | Author profiles |
86
+ | FAQPage | Q&A content |
87
+ | Product | E-commerce |
88
+ | Review | Ratings |
89
+ | BreadcrumbList | Navigation |
90
+
91
+ ---
92
+
93
+ ## 6. AI Content Guidelines
94
+
95
+ ### What Google Looks For
96
+
97
+ | ✅ Do | ❌ Don't |
98
+ |-------|----------|
99
+ | AI draft + human edit | Publish raw AI content |
100
+ | Add original insights | Copy without value |
101
+ | Expert review | Skip fact-checking |
102
+ | Follow E-E-A-T | Keyword stuffing |
103
+
104
+ ---
105
+
106
+ ## 7. Ranking Factors (Prioritized)
107
+
108
+ | Priority | Factor |
109
+ |----------|--------|
110
+ | 1 | Quality, relevant content |
111
+ | 2 | Backlinks from authority sites |
112
+ | 3 | Page experience (Core Web Vitals) |
113
+ | 4 | Mobile optimization |
114
+ | 5 | Technical SEO fundamentals |
115
+
116
+ ---
117
+
118
+ ## 8. Measurement
119
+
120
+ | Metric | Tool |
121
+ |--------|------|
122
+ | Rankings | Search Console, Ahrefs |
123
+ | Traffic | Analytics |
124
+ | Core Web Vitals | PageSpeed Insights |
125
+ | Indexing | Search Console |
126
+ | Backlinks | Ahrefs, Semrush |
127
+
128
+ ---
129
+
130
+ > **Remember:** SEO is a long-term game. Quality content + technical excellence + patience = results.
@@ -0,0 +1,219 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ SEO Checker - Search Engine Optimization Audit
4
+ Checks HTML/JSX/TSX pages for SEO best practices.
5
+
6
+ PURPOSE:
7
+ - Verify meta tags, titles, descriptions
8
+ - Check Open Graph tags for social sharing
9
+ - Validate heading hierarchy
10
+ - Check image accessibility (alt attributes)
11
+
12
+ WHAT IT CHECKS:
13
+ - HTML files (actual web pages)
14
+ - JSX/TSX files (React page components)
15
+ - Only files that are likely PUBLIC pages
16
+
17
+ Usage:
18
+ python seo_checker.py <project_path>
19
+ """
20
+ import sys
21
+ import json
22
+ import re
23
+ from pathlib import Path
24
+ from datetime import datetime
25
+
26
+ # Fix Windows console encoding
27
+ try:
28
+ sys.stdout.reconfigure(encoding='utf-8', errors='replace')
29
+ except:
30
+ pass
31
+
32
+
33
+ # Directories to skip
34
+ SKIP_DIRS = {
35
+ 'node_modules', '.next', 'dist', 'build', '.git', '.github',
36
+ '__pycache__', '.vscode', '.idea', 'coverage', 'test', 'tests',
37
+ '__tests__', 'spec', 'docs', 'documentation', 'examples'
38
+ }
39
+
40
+ # Files to skip (not pages)
41
+ SKIP_PATTERNS = [
42
+ 'config', 'setup', 'util', 'helper', 'hook', 'context', 'store',
43
+ 'service', 'api', 'lib', 'constant', 'type', 'interface', 'mock',
44
+ '.test.', '.spec.', '_test.', '_spec.'
45
+ ]
46
+
47
+
48
+ def is_page_file(file_path: Path) -> bool:
49
+ """Check if this file is likely a public-facing page."""
50
+ name = file_path.name.lower()
51
+ stem = file_path.stem.lower()
52
+
53
+ # Skip utility/config files
54
+ if any(skip in name for skip in SKIP_PATTERNS):
55
+ return False
56
+
57
+ # Check path - pages in specific directories are likely pages
58
+ parts = [p.lower() for p in file_path.parts]
59
+ page_dirs = ['pages', 'app', 'routes', 'views', 'screens']
60
+
61
+ if any(d in parts for d in page_dirs):
62
+ return True
63
+
64
+ # Filename indicators for pages
65
+ page_names = ['page', 'index', 'home', 'about', 'contact', 'blog',
66
+ 'post', 'article', 'product', 'landing', 'layout']
67
+
68
+ if any(p in stem for p in page_names):
69
+ return True
70
+
71
+ # HTML files are usually pages
72
+ if file_path.suffix.lower() in ['.html', '.htm']:
73
+ return True
74
+
75
+ return False
76
+
77
+
78
+ def find_pages(project_path: Path) -> list:
79
+ """Find page files to check."""
80
+ patterns = ['**/*.html', '**/*.htm', '**/*.jsx', '**/*.tsx']
81
+
82
+ files = []
83
+ for pattern in patterns:
84
+ for f in project_path.glob(pattern):
85
+ # Skip excluded directories
86
+ if any(skip in f.parts for skip in SKIP_DIRS):
87
+ continue
88
+
89
+ # Check if it's likely a page
90
+ if is_page_file(f):
91
+ files.append(f)
92
+
93
+ return files[:50] # Limit to 50 files
94
+
95
+
96
+ def check_page(file_path: Path) -> dict:
97
+ """Check a single page for SEO issues."""
98
+ issues = []
99
+
100
+ try:
101
+ content = file_path.read_text(encoding='utf-8', errors='ignore')
102
+ except Exception as e:
103
+ return {"file": str(file_path.name), "issues": [f"Error: {e}"]}
104
+
105
+ # Detect if this is a layout/template file (has Head component)
106
+ is_layout = 'Head>' in content or '<head' in content.lower()
107
+
108
+ # 1. Title tag
109
+ has_title = '<title' in content.lower() or 'title=' in content or 'Head>' in content
110
+ if not has_title and is_layout:
111
+ issues.append("Missing <title> tag")
112
+
113
+ # 2. Meta description
114
+ has_description = 'name="description"' in content.lower() or 'name=\'description\'' in content.lower()
115
+ if not has_description and is_layout:
116
+ issues.append("Missing meta description")
117
+
118
+ # 3. Open Graph tags
119
+ has_og = 'og:' in content or 'property="og:' in content.lower()
120
+ if not has_og and is_layout:
121
+ issues.append("Missing Open Graph tags")
122
+
123
+ # 4. Heading hierarchy - multiple H1s
124
+ h1_matches = re.findall(r'<h1[^>]*>', content, re.I)
125
+ if len(h1_matches) > 1:
126
+ issues.append(f"Multiple H1 tags ({len(h1_matches)})")
127
+
128
+ # 5. Images without alt
129
+ img_pattern = r'<img[^>]+>'
130
+ imgs = re.findall(img_pattern, content, re.I)
131
+ for img in imgs:
132
+ if 'alt=' not in img.lower():
133
+ issues.append("Image missing alt attribute")
134
+ break
135
+ if 'alt=""' in img or "alt=''" in img:
136
+ issues.append("Image has empty alt attribute")
137
+ break
138
+
139
+ # 6. Check for canonical link (nice to have)
140
+ # has_canonical = 'rel="canonical"' in content.lower()
141
+
142
+ return {
143
+ "file": str(file_path.name),
144
+ "issues": issues
145
+ }
146
+
147
+
148
+ def main():
149
+ project_path = Path(sys.argv[1] if len(sys.argv) > 1 else ".").resolve()
150
+
151
+ print(f"\n{'='*60}")
152
+ print(f" SEO CHECKER - Search Engine Optimization Audit")
153
+ print(f"{'='*60}")
154
+ print(f"Project: {project_path}")
155
+ print(f"Time: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
156
+ print("-"*60)
157
+
158
+ # Find pages
159
+ pages = find_pages(project_path)
160
+
161
+ if not pages:
162
+ print("\n[!] No page files found.")
163
+ print(" Looking for: HTML, JSX, TSX in pages/app/routes directories")
164
+ output = {"script": "seo_checker", "files_checked": 0, "passed": True}
165
+ print("\n" + json.dumps(output, indent=2))
166
+ sys.exit(0)
167
+
168
+ print(f"Found {len(pages)} page files to analyze\n")
169
+
170
+ # Check each page
171
+ all_issues = []
172
+ for f in pages:
173
+ result = check_page(f)
174
+ if result["issues"]:
175
+ all_issues.append(result)
176
+
177
+ # Summary
178
+ print("=" * 60)
179
+ print("SEO ANALYSIS RESULTS")
180
+ print("=" * 60)
181
+
182
+ if all_issues:
183
+ # Group by issue type
184
+ issue_counts = {}
185
+ for item in all_issues:
186
+ for issue in item["issues"]:
187
+ issue_counts[issue] = issue_counts.get(issue, 0) + 1
188
+
189
+ print("\nIssue Summary:")
190
+ for issue, count in sorted(issue_counts.items(), key=lambda x: -x[1]):
191
+ print(f" [{count}] {issue}")
192
+
193
+ print(f"\nAffected files ({len(all_issues)}):")
194
+ for item in all_issues[:5]:
195
+ print(f" - {item['file']}")
196
+ if len(all_issues) > 5:
197
+ print(f" ... and {len(all_issues) - 5} more")
198
+ else:
199
+ print("\n[OK] No SEO issues found!")
200
+
201
+ total_issues = sum(len(item["issues"]) for item in all_issues)
202
+ passed = total_issues == 0
203
+
204
+ output = {
205
+ "script": "seo_checker",
206
+ "project": str(project_path),
207
+ "files_checked": len(pages),
208
+ "files_with_issues": len(all_issues),
209
+ "issues_found": total_issues,
210
+ "passed": passed
211
+ }
212
+
213
+ print("\n" + json.dumps(output, indent=2))
214
+
215
+ sys.exit(0 if passed else 1)
216
+
217
+
218
+ if __name__ == "__main__":
219
+ main()
@@ -0,0 +1,8 @@
1
+ # Sequential Thinking Configuration
2
+
3
+ # Disable thought logging output (useful for automated processing)
4
+ # Set to "true" to disable console logging
5
+ DISABLE_THOUGHT_LOGGING=false
6
+
7
+ # History file location (optional, defaults to scripts/.thought-history.json)
8
+ # THOUGHT_HISTORY_FILE=/path/to/custom/history.json