@maestro-ai/mcp-server 1.0.0 → 1.0.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 (440) hide show
  1. package/README.md +266 -227
  2. package/dist/content/design-system/README.md +231 -231
  3. package/dist/content/design-system/indexes/README.md +211 -211
  4. package/dist/content/design-system/indexes/colors-index.md +156 -156
  5. package/dist/content/design-system/indexes/quick-search.md +111 -111
  6. package/dist/content/design-system/indexes/stacks-index.md +341 -341
  7. package/dist/content/examples/Exemplo de Fluxo Completo com Java e Spring Boot.md +249 -249
  8. package/dist/content/examples/Exemplo de Fluxo Completo com Laravel e Filament.md +277 -277
  9. package/dist/content/examples/Exemplo de Fluxo Completo com Laravel e Livewire.md +260 -260
  10. package/dist/content/examples/Exemplo de Fluxo Completo com Node e NestJS.md +257 -257
  11. package/dist/content/guides/Cat/303/241logo de Stacks para Cloud Moderna.md" +119 -119
  12. package/dist/content/guides/Cat/303/241logo de Stacks para Hospedagem Compartilhada.md" +147 -147
  13. package/dist/content/guides/Checklist Mestre de Entrega.md +68 -68
  14. package/dist/content/guides/Gates de Qualidade.md +209 -209
  15. package/dist/content/guides/Guia de Adi/303/247/303/243o de Novas Funcionalidades.md" +355 -355
  16. package/dist/content/guides/Guia de Chaos Engineering.md +267 -267
  17. package/dist/content/guides/Guia de Debugging com IA.md +135 -135
  18. package/dist/content/guides/Guia de Estrat/303/251gias de Cache.md" +352 -352
  19. package/dist/content/guides/Guia de Migrations Zero-Downtime.md +311 -311
  20. package/dist/content/guides/Guia de Multi-tenancy.md +368 -368
  21. package/dist/content/guides/Guia de Otimiza/303/247/303/243o de Custos Cloud.md" +195 -195
  22. package/dist/content/guides/Guia de Refatora/303/247/303/243o de C/303/263digo Legado com IA.md" +162 -162
  23. package/dist/content/guides/Guia de SLOs e Error Budgets.md +315 -315
  24. package/dist/content/guides/M/303/251tricas de Efici/303/252ncia do Desenvolvimento com IA.md" +93 -93
  25. package/dist/content/guides/Rules base.md +90 -90
  26. package/dist/content/playbook/Playbook de Desenvolvimento com IA.md +364 -364
  27. package/dist/content/prompts/README.md +203 -203
  28. package/dist/content/prompts/acessibilidade/analise-acessibilidade.md +257 -257
  29. package/dist/content/prompts/apis/design-api-rest.md +303 -303
  30. package/dist/content/prompts/apis/idempotencia.md +254 -254
  31. package/dist/content/prompts/apis/versionamento.md +313 -313
  32. package/dist/content/prompts/arquitetura/arquitetura-c4-completo.md +190 -190
  33. package/dist/content/prompts/arquitetura/clean-architecture.md +151 -151
  34. package/dist/content/prompts/arquitetura/ddd-bounded-contexts.md +183 -183
  35. package/dist/content/prompts/arquitetura/ddd-cqrs.md +176 -176
  36. package/dist/content/prompts/arquitetura/modelo-dominio.md +207 -207
  37. package/dist/content/prompts/arquitetura/multi-tenancy.md +235 -235
  38. package/dist/content/prompts/database/migrations-zero-downtime.md +192 -192
  39. package/dist/content/prompts/database/otimizacao-queries.md +296 -296
  40. package/dist/content/prompts/desenvolvimento/code-review.md +301 -301
  41. package/dist/content/prompts/desenvolvimento/gerar-servico.md +271 -271
  42. package/dist/content/prompts/devops/docker-compose.md +336 -336
  43. package/dist/content/prompts/devops/feature-flags.md +374 -374
  44. package/dist/content/prompts/devops/kubernetes-deploy.md +460 -460
  45. package/dist/content/prompts/devops/pipeline-cicd.md +358 -358
  46. package/dist/content/prompts/devops/terraform-iac.md +502 -502
  47. package/dist/content/prompts/escalabilidade/analise-performance.md +240 -240
  48. package/dist/content/prompts/escalabilidade/analise-performance.txt +94 -94
  49. package/dist/content/prompts/escalabilidade/caching.md +255 -255
  50. package/dist/content/prompts/observabilidade/chaos-testing.md +237 -237
  51. package/dist/content/prompts/observabilidade/estrategia-observabilidade.md +263 -263
  52. package/dist/content/prompts/observabilidade/estrategia-observabilidade.txt +134 -134
  53. package/dist/content/prompts/observabilidade/slos.md +215 -215
  54. package/dist/content/prompts/produto/discovery-inicial.md +203 -203
  55. package/dist/content/prompts/produto/discovery-inicial.txt +33 -33
  56. package/dist/content/prompts/requisitos/refinar-requisitos.md +232 -232
  57. package/dist/content/prompts/requisitos/refinar-requisitos.txt +40 -40
  58. package/dist/content/prompts/seguranca/analise-seguranca.md +243 -243
  59. package/dist/content/prompts/seguranca/pentest-checklist.md +333 -333
  60. package/dist/content/prompts/seguranca/rate-limiting.md +356 -356
  61. package/dist/content/prompts/seguranca/revisao-lgpd.md +227 -227
  62. package/dist/content/prompts/seguranca/threat-modeling.md +224 -224
  63. package/dist/content/prompts/testes/contract-testing.md +340 -340
  64. package/dist/content/prompts/testes/gerar-testes-unitarios.md +474 -474
  65. package/dist/content/prompts/testes/testes-e2e.md +460 -460
  66. package/dist/content/prompts/testes/testes-integracao.md +418 -418
  67. package/dist/content/prompts/testes/testes-performance.md +458 -458
  68. package/dist/content/prompts/ux/gerar-ui-stitch.md +151 -151
  69. package/dist/content/rules/RULES.md +835 -835
  70. package/dist/content/rules/adapters/copilot.md +10 -10
  71. package/dist/content/rules/adapters/cursor.md +10 -10
  72. package/dist/content/rules/adapters/gemini.md +13 -13
  73. package/dist/content/rules/adapters/windsurf.md +10 -10
  74. package/dist/content/specialists/Especialista em Acessibilidade.md +266 -266
  75. package/dist/content/specialists/Especialista em An/303/241lise de Testes.md" +434 -434
  76. package/dist/content/specialists/Especialista em Arquitetura Avan/303/247ada.md" +358 -358
  77. package/dist/content/specialists/Especialista em Arquitetura de Software.md +177 -177
  78. package/dist/content/specialists/Especialista em Banco de Dados.md +260 -260
  79. package/dist/content/specialists/Especialista em Contrato de API.md +172 -172
  80. package/dist/content/specialists/Especialista em Dados e Analytics com IA.md +246 -246
  81. package/dist/content/specialists/Especialista em Debugging e Troubleshooting.md +191 -191
  82. package/dist/content/specialists/Especialista em Desenvolvimento Frontend.md +477 -477
  83. package/dist/content/specialists/Especialista em Desenvolvimento Mobile.md +241 -241
  84. package/dist/content/specialists/Especialista em Desenvolvimento e Vibe Coding Estruturado.md +417 -417
  85. package/dist/content/specialists/Especialista em DevOps e Infraestrutura.md +294 -294
  86. package/dist/content/specialists/Especialista em Documenta/303/247/303/243o T/303/251cnica.md" +227 -227
  87. package/dist/content/specialists/Especialista em Engenharia de Requisitos com IA.md +299 -299
  88. package/dist/content/specialists/Especialista em Explora/303/247/303/243o de Codebase.md" +179 -179
  89. package/dist/content/specialists/Especialista em Gest/303/243o de Produto.md" +179 -179
  90. package/dist/content/specialists/Especialista em Migra/303/247/303/243o e Moderniza/303/247/303/243o.md" +410 -410
  91. package/dist/content/specialists/Especialista em Modelagem e Arquitetura de Dom/303/255nio com IA.md" +248 -248
  92. package/dist/content/specialists/Especialista em Observabilidade.md +415 -415
  93. package/dist/content/specialists/Especialista em Performance e Escalabilidade.md +373 -373
  94. package/dist/content/specialists/Especialista em Plano de Execu/303/247/303/243o com IA.md" +341 -341
  95. package/dist/content/specialists/Especialista em Prototipagem R/303/241pida com Google Stitch.md" +419 -419
  96. package/dist/content/specialists/Especialista em Seguran/303/247a da Informa/303/247/303/243o.md" +508 -508
  97. package/dist/content/specialists/Especialista em UX Design.md +453 -453
  98. package/dist/content/specialists/INDEX.md +43 -43
  99. package/dist/content/templates/PRD.md +165 -165
  100. package/dist/content/templates/README.md +65 -65
  101. package/dist/content/templates/adr.md +103 -103
  102. package/dist/content/templates/arquitetura.md +279 -279
  103. package/dist/content/templates/backlog.md +185 -185
  104. package/dist/content/templates/checklist-seguranca.md +180 -180
  105. package/dist/content/templates/contexto.md +120 -120
  106. package/dist/content/templates/criterios-aceite.md +99 -99
  107. package/dist/content/templates/design-banco.md +270 -270
  108. package/dist/content/templates/design-doc.md +240 -240
  109. package/dist/content/templates/feature.md +88 -88
  110. package/dist/content/templates/historia-backend.md +84 -84
  111. package/dist/content/templates/historia-frontend.md +75 -75
  112. package/dist/content/templates/historia-usuario.md +125 -125
  113. package/dist/content/templates/mapa-navegacao.md +133 -133
  114. package/dist/content/templates/matriz-rastreabilidade.md +121 -121
  115. package/dist/content/templates/modelo-dominio.md +219 -219
  116. package/dist/content/templates/plano-testes.md +199 -199
  117. package/dist/content/templates/prototipo-stitch.md +138 -138
  118. package/dist/content/templates/requisitos.md +162 -162
  119. package/dist/content/templates/slo-sli.md +197 -197
  120. package/dist/content/workflows/README-MCP.md +363 -363
  121. package/dist/content/workflows/mcp-debug.md +506 -506
  122. package/dist/content/workflows/mcp-feature.md +385 -385
  123. package/dist/content/workflows/mcp-gate.md +413 -413
  124. package/dist/content/workflows/mcp-next.md +388 -388
  125. package/dist/content/workflows/mcp-refactor.md +600 -600
  126. package/dist/content/workflows/mcp-start.md +304 -304
  127. package/dist/content/workflows/mcp-status.md +400 -400
  128. package/dist/gates/tiers.test.js +14 -14
  129. package/dist/index.js +133 -133
  130. package/dist/resources/index.js +61 -61
  131. package/dist/stdio.js +39 -32
  132. package/dist/stdio.js.map +1 -1
  133. package/dist/tools/analise/performance.js +23 -23
  134. package/dist/tools/analise/qualidade.js +23 -23
  135. package/dist/tools/analise/relatorio.js +24 -24
  136. package/dist/tools/analise/seguranca.js +28 -28
  137. package/dist/tools/aprovar-gate.js +81 -81
  138. package/dist/tools/atualizar-codebase.js +18 -18
  139. package/dist/tools/avaliar-entregavel.js +18 -18
  140. package/dist/tools/carregar-projeto.js +103 -103
  141. package/dist/tools/classificar.js +36 -36
  142. package/dist/tools/confirmar-classificacao.js +36 -36
  143. package/dist/tools/confirmar-stitch.js +75 -75
  144. package/dist/tools/contexto.js +56 -56
  145. package/dist/tools/fluxos-alternativos.js +98 -98
  146. package/dist/tools/implementar-historia.js +63 -63
  147. package/dist/tools/iniciar-projeto.js +174 -174
  148. package/dist/tools/proximo.js +239 -239
  149. package/dist/tools/salvar.js +59 -59
  150. package/dist/tools/status.js +76 -76
  151. package/dist/tools/validar-gate.js +35 -35
  152. package/dist/types/response.js +11 -11
  153. package/dist/utils/instructions.js +48 -48
  154. package/dist/utils/prompt-mapper.js +16 -16
  155. package/dist/utils/system-md.js +33 -33
  156. package/package.json +67 -67
  157. package/dist/content/content/design-system/README.md +0 -231
  158. package/dist/content/content/design-system/data/charts.csv +0 -26
  159. package/dist/content/content/design-system/data/colors.csv +0 -97
  160. package/dist/content/content/design-system/data/icons.csv +0 -101
  161. package/dist/content/content/design-system/data/landing.csv +0 -31
  162. package/dist/content/content/design-system/data/products.csv +0 -97
  163. package/dist/content/content/design-system/data/prompts.csv +0 -24
  164. package/dist/content/content/design-system/data/react-performance.csv +0 -45
  165. package/dist/content/content/design-system/data/styles.csv +0 -59
  166. package/dist/content/content/design-system/data/typography.csv +0 -58
  167. package/dist/content/content/design-system/data/ui-reasoning.csv +0 -101
  168. package/dist/content/content/design-system/data/ux-guidelines.csv +0 -100
  169. package/dist/content/content/design-system/data/web-interface.csv +0 -31
  170. package/dist/content/content/design-system/indexes/README.md +0 -211
  171. package/dist/content/content/design-system/indexes/colors-index.md +0 -156
  172. package/dist/content/content/design-system/indexes/quick-search.md +0 -111
  173. package/dist/content/content/design-system/indexes/stacks-index.md +0 -341
  174. package/dist/content/content/design-system/stacks/flutter.csv +0 -53
  175. package/dist/content/content/design-system/stacks/html-tailwind.csv +0 -56
  176. package/dist/content/content/design-system/stacks/jetpack-compose.csv +0 -53
  177. package/dist/content/content/design-system/stacks/nextjs.csv +0 -53
  178. package/dist/content/content/design-system/stacks/nuxt-ui.csv +0 -51
  179. package/dist/content/content/design-system/stacks/nuxtjs.csv +0 -59
  180. package/dist/content/content/design-system/stacks/react-native.csv +0 -52
  181. package/dist/content/content/design-system/stacks/react.csv +0 -54
  182. package/dist/content/content/design-system/stacks/shadcn.csv +0 -61
  183. package/dist/content/content/design-system/stacks/svelte.csv +0 -54
  184. package/dist/content/content/design-system/stacks/swiftui.csv +0 -51
  185. package/dist/content/content/design-system/stacks/vue.csv +0 -50
  186. package/dist/content/content/examples/Exemplo de Fluxo Completo com Java e Spring Boot.md +0 -250
  187. package/dist/content/content/examples/Exemplo de Fluxo Completo com Laravel e Filament.md +0 -278
  188. package/dist/content/content/examples/Exemplo de Fluxo Completo com Laravel e Livewire.md +0 -261
  189. package/dist/content/content/examples/Exemplo de Fluxo Completo com Node e NestJS.md +0 -258
  190. package/dist/content/content/guides/Cat/303/241logo de Stacks para Cloud Moderna.md" +0 -119
  191. package/dist/content/content/guides/Cat/303/241logo de Stacks para Hospedagem Compartilhada.md" +0 -147
  192. package/dist/content/content/guides/Checklist Mestre de Entrega.md +0 -68
  193. package/dist/content/content/guides/Gates de Qualidade.md +0 -209
  194. package/dist/content/content/guides/Guia de Adi/303/247/303/243o de Novas Funcionalidades.md" +0 -355
  195. package/dist/content/content/guides/Guia de Chaos Engineering.md +0 -267
  196. package/dist/content/content/guides/Guia de Debugging com IA.md +0 -135
  197. package/dist/content/content/guides/Guia de Estrat/303/251gias de Cache.md" +0 -352
  198. package/dist/content/content/guides/Guia de Migrations Zero-Downtime.md +0 -311
  199. package/dist/content/content/guides/Guia de Multi-tenancy.md +0 -368
  200. package/dist/content/content/guides/Guia de Otimiza/303/247/303/243o de Custos Cloud.md" +0 -195
  201. package/dist/content/content/guides/Guia de Refatora/303/247/303/243o de C/303/263digo Legado com IA.md" +0 -162
  202. package/dist/content/content/guides/Guia de SLOs e Error Budgets.md +0 -315
  203. package/dist/content/content/guides/M/303/251tricas de Efici/303/252ncia do Desenvolvimento com IA.md" +0 -93
  204. package/dist/content/content/guides/Rules base.md +0 -90
  205. package/dist/content/content/playbook/Playbook de Desenvolvimento com IA.md +0 -364
  206. package/dist/content/content/prompts/README.md +0 -203
  207. package/dist/content/content/prompts/acessibilidade/analise-acessibilidade.md +0 -257
  208. package/dist/content/content/prompts/apis/design-api-rest.md +0 -303
  209. package/dist/content/content/prompts/apis/idempotencia.md +0 -254
  210. package/dist/content/content/prompts/apis/versionamento.md +0 -313
  211. package/dist/content/content/prompts/arquitetura/arquitetura-c4-completo.md +0 -190
  212. package/dist/content/content/prompts/arquitetura/clean-architecture.md +0 -151
  213. package/dist/content/content/prompts/arquitetura/ddd-bounded-contexts.md +0 -183
  214. package/dist/content/content/prompts/arquitetura/ddd-cqrs.md +0 -176
  215. package/dist/content/content/prompts/arquitetura/modelo-dominio.md +0 -207
  216. package/dist/content/content/prompts/arquitetura/multi-tenancy.md +0 -235
  217. package/dist/content/content/prompts/database/migrations-zero-downtime.md +0 -192
  218. package/dist/content/content/prompts/database/otimizacao-queries.md +0 -296
  219. package/dist/content/content/prompts/desenvolvimento/code-review.md +0 -301
  220. package/dist/content/content/prompts/desenvolvimento/gerar-servico.md +0 -271
  221. package/dist/content/content/prompts/devops/docker-compose.md +0 -336
  222. package/dist/content/content/prompts/devops/feature-flags.md +0 -374
  223. package/dist/content/content/prompts/devops/kubernetes-deploy.md +0 -460
  224. package/dist/content/content/prompts/devops/pipeline-cicd.md +0 -358
  225. package/dist/content/content/prompts/devops/terraform-iac.md +0 -502
  226. package/dist/content/content/prompts/escalabilidade/analise-performance.md +0 -240
  227. package/dist/content/content/prompts/escalabilidade/analise-performance.txt +0 -94
  228. package/dist/content/content/prompts/escalabilidade/caching.md +0 -255
  229. package/dist/content/content/prompts/observabilidade/chaos-testing.md +0 -237
  230. package/dist/content/content/prompts/observabilidade/estrategia-observabilidade.md +0 -263
  231. package/dist/content/content/prompts/observabilidade/estrategia-observabilidade.txt +0 -134
  232. package/dist/content/content/prompts/observabilidade/slos.md +0 -215
  233. package/dist/content/content/prompts/produto/discovery-inicial.md +0 -203
  234. package/dist/content/content/prompts/produto/discovery-inicial.txt +0 -33
  235. package/dist/content/content/prompts/requisitos/refinar-requisitos.md +0 -232
  236. package/dist/content/content/prompts/requisitos/refinar-requisitos.txt +0 -40
  237. package/dist/content/content/prompts/seguranca/analise-seguranca.md +0 -243
  238. package/dist/content/content/prompts/seguranca/pentest-checklist.md +0 -333
  239. package/dist/content/content/prompts/seguranca/rate-limiting.md +0 -356
  240. package/dist/content/content/prompts/seguranca/revisao-lgpd.md +0 -227
  241. package/dist/content/content/prompts/seguranca/threat-modeling.md +0 -224
  242. package/dist/content/content/prompts/testes/contract-testing.md +0 -340
  243. package/dist/content/content/prompts/testes/gerar-testes-unitarios.md +0 -474
  244. package/dist/content/content/prompts/testes/testes-e2e.md +0 -460
  245. package/dist/content/content/prompts/testes/testes-integracao.md +0 -418
  246. package/dist/content/content/prompts/testes/testes-performance.md +0 -458
  247. package/dist/content/content/prompts/ux/gerar-ui-stitch.md +0 -151
  248. package/dist/content/content/rules/GEMINI.md +0 -841
  249. package/dist/content/content/rules/RULES.md +0 -835
  250. package/dist/content/content/rules/adapters/copilot.md +0 -10
  251. package/dist/content/content/rules/adapters/cursor.md +0 -10
  252. package/dist/content/content/rules/adapters/gemini.md +0 -13
  253. package/dist/content/content/rules/adapters/windsurf.md +0 -10
  254. package/dist/content/content/skills/api-patterns/SKILL.md +0 -81
  255. package/dist/content/content/skills/api-patterns/api-style.md +0 -42
  256. package/dist/content/content/skills/api-patterns/auth.md +0 -24
  257. package/dist/content/content/skills/api-patterns/documentation.md +0 -26
  258. package/dist/content/content/skills/api-patterns/graphql.md +0 -41
  259. package/dist/content/content/skills/api-patterns/rate-limiting.md +0 -31
  260. package/dist/content/content/skills/api-patterns/response.md +0 -37
  261. package/dist/content/content/skills/api-patterns/rest.md +0 -40
  262. package/dist/content/content/skills/api-patterns/scripts/api_validator.py +0 -211
  263. package/dist/content/content/skills/api-patterns/security-testing.md +0 -122
  264. package/dist/content/content/skills/api-patterns/trpc.md +0 -41
  265. package/dist/content/content/skills/api-patterns/versioning.md +0 -22
  266. package/dist/content/content/skills/app-builder/SKILL.md +0 -75
  267. package/dist/content/content/skills/app-builder/agent-coordination.md +0 -71
  268. package/dist/content/content/skills/app-builder/feature-building.md +0 -53
  269. package/dist/content/content/skills/app-builder/project-detection.md +0 -34
  270. package/dist/content/content/skills/app-builder/scaffolding.md +0 -118
  271. package/dist/content/content/skills/app-builder/tech-stack.md +0 -40
  272. package/dist/content/content/skills/app-builder/templates/SKILL.md +0 -39
  273. package/dist/content/content/skills/app-builder/templates/astro-static/TEMPLATE.md +0 -76
  274. package/dist/content/content/skills/app-builder/templates/chrome-extension/TEMPLATE.md +0 -92
  275. package/dist/content/content/skills/app-builder/templates/cli-tool/TEMPLATE.md +0 -88
  276. package/dist/content/content/skills/app-builder/templates/electron-desktop/TEMPLATE.md +0 -88
  277. package/dist/content/content/skills/app-builder/templates/express-api/TEMPLATE.md +0 -83
  278. package/dist/content/content/skills/app-builder/templates/flutter-app/TEMPLATE.md +0 -90
  279. package/dist/content/content/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +0 -90
  280. package/dist/content/content/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +0 -82
  281. package/dist/content/content/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +0 -100
  282. package/dist/content/content/skills/app-builder/templates/nextjs-static/TEMPLATE.md +0 -106
  283. package/dist/content/content/skills/app-builder/templates/nuxt-app/TEMPLATE.md +0 -101
  284. package/dist/content/content/skills/app-builder/templates/python-fastapi/TEMPLATE.md +0 -83
  285. package/dist/content/content/skills/app-builder/templates/react-native-app/TEMPLATE.md +0 -93
  286. package/dist/content/content/skills/architecture/SKILL.md +0 -55
  287. package/dist/content/content/skills/architecture/context-discovery.md +0 -43
  288. package/dist/content/content/skills/architecture/examples.md +0 -94
  289. package/dist/content/content/skills/architecture/pattern-selection.md +0 -68
  290. package/dist/content/content/skills/architecture/patterns-reference.md +0 -50
  291. package/dist/content/content/skills/architecture/trade-off-analysis.md +0 -77
  292. package/dist/content/content/skills/bash-linux/SKILL.md +0 -199
  293. package/dist/content/content/skills/behavioral-modes/SKILL.md +0 -242
  294. package/dist/content/content/skills/brainstorming/SKILL.md +0 -163
  295. package/dist/content/content/skills/brainstorming/dynamic-questioning.md +0 -350
  296. package/dist/content/content/skills/clean-code/SKILL.md +0 -201
  297. package/dist/content/content/skills/code-review-checklist/SKILL.md +0 -109
  298. package/dist/content/content/skills/database-design/SKILL.md +0 -52
  299. package/dist/content/content/skills/database-design/database-selection.md +0 -43
  300. package/dist/content/content/skills/database-design/indexing.md +0 -39
  301. package/dist/content/content/skills/database-design/migrations.md +0 -48
  302. package/dist/content/content/skills/database-design/optimization.md +0 -36
  303. package/dist/content/content/skills/database-design/orm-selection.md +0 -30
  304. package/dist/content/content/skills/database-design/schema-design.md +0 -56
  305. package/dist/content/content/skills/database-design/scripts/schema_validator.py +0 -172
  306. package/dist/content/content/skills/deployment-procedures/SKILL.md +0 -241
  307. package/dist/content/content/skills/doc.md +0 -177
  308. package/dist/content/content/skills/documentation-templates/SKILL.md +0 -194
  309. package/dist/content/content/skills/frontend-design/SKILL.md +0 -396
  310. package/dist/content/content/skills/frontend-design/animation-guide.md +0 -331
  311. package/dist/content/content/skills/frontend-design/color-system.md +0 -311
  312. package/dist/content/content/skills/frontend-design/decision-trees.md +0 -418
  313. package/dist/content/content/skills/frontend-design/motion-graphics.md +0 -306
  314. package/dist/content/content/skills/frontend-design/scripts/accessibility_checker.py +0 -183
  315. package/dist/content/content/skills/frontend-design/scripts/ux_audit.py +0 -722
  316. package/dist/content/content/skills/frontend-design/typography-system.md +0 -345
  317. package/dist/content/content/skills/frontend-design/ux-psychology.md +0 -541
  318. package/dist/content/content/skills/frontend-design/visual-effects.md +0 -383
  319. package/dist/content/content/skills/game-development/2d-games/SKILL.md +0 -119
  320. package/dist/content/content/skills/game-development/3d-games/SKILL.md +0 -135
  321. package/dist/content/content/skills/game-development/SKILL.md +0 -167
  322. package/dist/content/content/skills/game-development/game-art/SKILL.md +0 -185
  323. package/dist/content/content/skills/game-development/game-audio/SKILL.md +0 -190
  324. package/dist/content/content/skills/game-development/game-design/SKILL.md +0 -129
  325. package/dist/content/content/skills/game-development/mobile-games/SKILL.md +0 -108
  326. package/dist/content/content/skills/game-development/multiplayer/SKILL.md +0 -132
  327. package/dist/content/content/skills/game-development/pc-games/SKILL.md +0 -144
  328. package/dist/content/content/skills/game-development/vr-ar/SKILL.md +0 -123
  329. package/dist/content/content/skills/game-development/web-games/SKILL.md +0 -150
  330. package/dist/content/content/skills/geo-fundamentals/SKILL.md +0 -156
  331. package/dist/content/content/skills/geo-fundamentals/scripts/geo_checker.py +0 -289
  332. package/dist/content/content/skills/i18n-localization/SKILL.md +0 -154
  333. package/dist/content/content/skills/i18n-localization/scripts/i18n_checker.py +0 -241
  334. package/dist/content/content/skills/intelligent-routing/SKILL.md +0 -334
  335. package/dist/content/content/skills/lint-and-validate/SKILL.md +0 -45
  336. package/dist/content/content/skills/lint-and-validate/scripts/lint_runner.py +0 -172
  337. package/dist/content/content/skills/lint-and-validate/scripts/type_coverage.py +0 -173
  338. package/dist/content/content/skills/mcp-builder/SKILL.md +0 -176
  339. package/dist/content/content/skills/mobile-design/SKILL.md +0 -394
  340. package/dist/content/content/skills/mobile-design/decision-trees.md +0 -516
  341. package/dist/content/content/skills/mobile-design/mobile-backend.md +0 -491
  342. package/dist/content/content/skills/mobile-design/mobile-color-system.md +0 -420
  343. package/dist/content/content/skills/mobile-design/mobile-debugging.md +0 -122
  344. package/dist/content/content/skills/mobile-design/mobile-design-thinking.md +0 -357
  345. package/dist/content/content/skills/mobile-design/mobile-navigation.md +0 -458
  346. package/dist/content/content/skills/mobile-design/mobile-performance.md +0 -767
  347. package/dist/content/content/skills/mobile-design/mobile-testing.md +0 -356
  348. package/dist/content/content/skills/mobile-design/mobile-typography.md +0 -433
  349. package/dist/content/content/skills/mobile-design/platform-android.md +0 -666
  350. package/dist/content/content/skills/mobile-design/platform-ios.md +0 -561
  351. package/dist/content/content/skills/mobile-design/scripts/mobile_audit.py +0 -670
  352. package/dist/content/content/skills/mobile-design/touch-psychology.md +0 -537
  353. package/dist/content/content/skills/nextjs-best-practices/SKILL.md +0 -203
  354. package/dist/content/content/skills/nodejs-best-practices/SKILL.md +0 -333
  355. package/dist/content/content/skills/parallel-agents/SKILL.md +0 -175
  356. package/dist/content/content/skills/performance-profiling/SKILL.md +0 -143
  357. package/dist/content/content/skills/performance-profiling/scripts/lighthouse_audit.py +0 -76
  358. package/dist/content/content/skills/plan-writing/SKILL.md +0 -152
  359. package/dist/content/content/skills/powershell-windows/SKILL.md +0 -167
  360. package/dist/content/content/skills/python-patterns/SKILL.md +0 -441
  361. package/dist/content/content/skills/react-patterns/SKILL.md +0 -198
  362. package/dist/content/content/skills/red-team-tactics/SKILL.md +0 -199
  363. package/dist/content/content/skills/seo-fundamentals/SKILL.md +0 -129
  364. package/dist/content/content/skills/seo-fundamentals/scripts/seo_checker.py +0 -219
  365. package/dist/content/content/skills/server-management/SKILL.md +0 -161
  366. package/dist/content/content/skills/systematic-debugging/SKILL.md +0 -109
  367. package/dist/content/content/skills/tailwind-patterns/SKILL.md +0 -269
  368. package/dist/content/content/skills/tdd-workflow/SKILL.md +0 -149
  369. package/dist/content/content/skills/testing-patterns/SKILL.md +0 -178
  370. package/dist/content/content/skills/testing-patterns/scripts/test_runner.py +0 -219
  371. package/dist/content/content/skills/vulnerability-scanner/SKILL.md +0 -276
  372. package/dist/content/content/skills/vulnerability-scanner/checklists.md +0 -121
  373. package/dist/content/content/skills/vulnerability-scanner/scripts/security_scan.py +0 -458
  374. package/dist/content/content/skills/webapp-testing/SKILL.md +0 -187
  375. package/dist/content/content/skills/webapp-testing/scripts/playwright_runner.py +0 -173
  376. package/dist/content/content/specialists/Especialista em Acessibilidade.md +0 -266
  377. package/dist/content/content/specialists/Especialista em An/303/241lise de Testes.md" +0 -434
  378. package/dist/content/content/specialists/Especialista em Arquitetura Avan/303/247ada.md" +0 -358
  379. package/dist/content/content/specialists/Especialista em Arquitetura de Software.md +0 -177
  380. package/dist/content/content/specialists/Especialista em Banco de Dados.md +0 -260
  381. package/dist/content/content/specialists/Especialista em Contrato de API.md +0 -172
  382. package/dist/content/content/specialists/Especialista em Dados e Analytics com IA.md +0 -246
  383. package/dist/content/content/specialists/Especialista em Debugging e Troubleshooting.md +0 -191
  384. package/dist/content/content/specialists/Especialista em Desenvolvimento Frontend.md +0 -477
  385. package/dist/content/content/specialists/Especialista em Desenvolvimento Mobile.md +0 -241
  386. package/dist/content/content/specialists/Especialista em Desenvolvimento e Vibe Coding Estruturado.md +0 -417
  387. package/dist/content/content/specialists/Especialista em DevOps e Infraestrutura.md +0 -294
  388. package/dist/content/content/specialists/Especialista em Documenta/303/247/303/243o T/303/251cnica.md" +0 -227
  389. package/dist/content/content/specialists/Especialista em Engenharia de Requisitos com IA.md +0 -299
  390. package/dist/content/content/specialists/Especialista em Explora/303/247/303/243o de Codebase.md" +0 -179
  391. package/dist/content/content/specialists/Especialista em Gest/303/243o de Produto.md" +0 -179
  392. package/dist/content/content/specialists/Especialista em Migra/303/247/303/243o e Moderniza/303/247/303/243o.md" +0 -410
  393. package/dist/content/content/specialists/Especialista em Modelagem e Arquitetura de Dom/303/255nio com IA.md" +0 -248
  394. package/dist/content/content/specialists/Especialista em Observabilidade.md +0 -415
  395. package/dist/content/content/specialists/Especialista em Performance e Escalabilidade.md +0 -373
  396. package/dist/content/content/specialists/Especialista em Plano de Execu/303/247/303/243o com IA.md" +0 -341
  397. package/dist/content/content/specialists/Especialista em Prototipagem R/303/241pida com Google Stitch.md" +0 -419
  398. package/dist/content/content/specialists/Especialista em Seguran/303/247a da Informa/303/247/303/243o.md" +0 -508
  399. package/dist/content/content/specialists/Especialista em UX Design.md +0 -453
  400. package/dist/content/content/specialists/INDEX.md +0 -43
  401. package/dist/content/content/templates/PRD.md +0 -165
  402. package/dist/content/content/templates/README.md +0 -65
  403. package/dist/content/content/templates/adr.md +0 -103
  404. package/dist/content/content/templates/arquitetura.md +0 -279
  405. package/dist/content/content/templates/backlog.md +0 -185
  406. package/dist/content/content/templates/checklist-seguranca.md +0 -180
  407. package/dist/content/content/templates/contexto.md +0 -120
  408. package/dist/content/content/templates/criterios-aceite.md +0 -99
  409. package/dist/content/content/templates/design-banco.md +0 -270
  410. package/dist/content/content/templates/design-doc.md +0 -240
  411. package/dist/content/content/templates/feature.md +0 -88
  412. package/dist/content/content/templates/historia-backend.md +0 -84
  413. package/dist/content/content/templates/historia-frontend.md +0 -75
  414. package/dist/content/content/templates/historia-usuario.md +0 -125
  415. package/dist/content/content/templates/mapa-navegacao.md +0 -133
  416. package/dist/content/content/templates/matriz-rastreabilidade.md +0 -121
  417. package/dist/content/content/templates/modelo-dominio.md +0 -219
  418. package/dist/content/content/templates/plano-testes.md +0 -199
  419. package/dist/content/content/templates/prototipo-stitch.md +0 -138
  420. package/dist/content/content/templates/requisitos.md +0 -162
  421. package/dist/content/content/templates/slo-sli.md +0 -197
  422. package/dist/content/content/workflows/README-MCP.md +0 -363
  423. package/dist/content/content/workflows/brainstorm.md +0 -113
  424. package/dist/content/content/workflows/create.md +0 -59
  425. package/dist/content/content/workflows/debug.md +0 -103
  426. package/dist/content/content/workflows/deploy.md +0 -176
  427. package/dist/content/content/workflows/enhance.md +0 -63
  428. package/dist/content/content/workflows/mcp-debug.md +0 -506
  429. package/dist/content/content/workflows/mcp-feature.md +0 -385
  430. package/dist/content/content/workflows/mcp-gate.md +0 -413
  431. package/dist/content/content/workflows/mcp-next.md +0 -388
  432. package/dist/content/content/workflows/mcp-refactor.md +0 -600
  433. package/dist/content/content/workflows/mcp-start.md +0 -304
  434. package/dist/content/content/workflows/mcp-status.md +0 -400
  435. package/dist/content/content/workflows/orchestrate.md +0 -237
  436. package/dist/content/content/workflows/plan.md +0 -89
  437. package/dist/content/content/workflows/preview.md +0 -81
  438. package/dist/content/content/workflows/status.md +0 -86
  439. package/dist/content/content/workflows/test.md +0 -144
  440. package/dist/content/content/workflows/ui-ux-pro-max.md +0 -296
@@ -1,108 +0,0 @@
1
- ---
2
- name: mobile-games
3
- description: Mobile game development principles. Touch input, battery, performance, app stores.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- ---
6
-
7
- # Mobile Game Development
8
-
9
- > Platform constraints and optimization principles.
10
-
11
- ---
12
-
13
- ## 1. Platform Considerations
14
-
15
- ### Key Constraints
16
-
17
- | Constraint | Strategy |
18
- |------------|----------|
19
- | **Touch input** | Large hit areas, gestures |
20
- | **Battery** | Limit CPU/GPU usage |
21
- | **Thermal** | Throttle when hot |
22
- | **Screen size** | Responsive UI |
23
- | **Interruptions** | Pause on background |
24
-
25
- ---
26
-
27
- ## 2. Touch Input Principles
28
-
29
- ### Touch vs Controller
30
-
31
- | Touch | Desktop/Console |
32
- |-------|-----------------|
33
- | Imprecise | Precise |
34
- | Occludes screen | No occlusion |
35
- | Limited buttons | Many buttons |
36
- | Gestures available | Buttons/sticks |
37
-
38
- ### Best Practices
39
-
40
- - Minimum touch target: 44x44 points
41
- - Visual feedback on touch
42
- - Avoid precise timing requirements
43
- - Support both portrait and landscape
44
-
45
- ---
46
-
47
- ## 3. Performance Targets
48
-
49
- ### Thermal Management
50
-
51
- | Action | Trigger |
52
- |--------|---------|
53
- | Reduce quality | Device warm |
54
- | Limit FPS | Device hot |
55
- | Pause effects | Critical temp |
56
-
57
- ### Battery Optimization
58
-
59
- - 30 FPS often sufficient
60
- - Sleep when paused
61
- - Minimize GPS/network
62
- - Dark mode saves OLED battery
63
-
64
- ---
65
-
66
- ## 4. App Store Requirements
67
-
68
- ### iOS (App Store)
69
-
70
- | Requirement | Note |
71
- |-------------|------|
72
- | Privacy labels | Required |
73
- | Account deletion | If account creation exists |
74
- | Screenshots | For all device sizes |
75
-
76
- ### Android (Google Play)
77
-
78
- | Requirement | Note |
79
- |-------------|------|
80
- | Target API | Current year's SDK |
81
- | 64-bit | Required |
82
- | App bundles | Recommended |
83
-
84
- ---
85
-
86
- ## 5. Monetization Models
87
-
88
- | Model | Best For |
89
- |-------|----------|
90
- | **Premium** | Quality games, loyal audience |
91
- | **Free + IAP** | Casual, progression-based |
92
- | **Ads** | Hyper-casual, high volume |
93
- | **Subscription** | Content updates, multiplayer |
94
-
95
- ---
96
-
97
- ## 6. Anti-Patterns
98
-
99
- | ❌ Don't | ✅ Do |
100
- |----------|-------|
101
- | Desktop controls on mobile | Design for touch |
102
- | Ignore battery drain | Monitor thermals |
103
- | Force landscape | Support player preference |
104
- | Always-on network | Cache and sync |
105
-
106
- ---
107
-
108
- > **Remember:** Mobile is the most constrained platform. Respect battery and attention.
@@ -1,132 +0,0 @@
1
- ---
2
- name: multiplayer
3
- description: Multiplayer game development principles. Architecture, networking, synchronization.
4
- allowed-tools: Read, Write, Edit, Glob, Grep, Bash
5
- ---
6
-
7
- # Multiplayer Game Development
8
-
9
- > Networking architecture and synchronization principles.
10
-
11
- ---
12
-
13
- ## 1. Architecture Selection
14
-
15
- ### Decision Tree
16
-
17
- ```
18
- What type of multiplayer?
19
-
20
- ├── Competitive / Real-time
21
- │ └── Dedicated Server (authoritative)
22
-
23
- ├── Cooperative / Casual
24
- │ └── Host-based (one player is server)
25
-
26
- ├── Turn-based
27
- │ └── Client-server (simple)
28
-
29
- └── Massive (MMO)
30
- └── Distributed servers
31
- ```
32
-
33
- ### Comparison
34
-
35
- | Architecture | Latency | Cost | Security |
36
- |--------------|---------|------|----------|
37
- | **Dedicated** | Low | High | Strong |
38
- | **P2P** | Variable | Low | Weak |
39
- | **Host-based** | Medium | Low | Medium |
40
-
41
- ---
42
-
43
- ## 2. Synchronization Principles
44
-
45
- ### State vs Input
46
-
47
- | Approach | Sync What | Best For |
48
- |----------|-----------|----------|
49
- | **State Sync** | Game state | Simple, few objects |
50
- | **Input Sync** | Player inputs | Action games |
51
- | **Hybrid** | Both | Most games |
52
-
53
- ### Lag Compensation
54
-
55
- | Technique | Purpose |
56
- |-----------|---------|
57
- | **Prediction** | Client predicts server |
58
- | **Interpolation** | Smooth remote players |
59
- | **Reconciliation** | Fix mispredictions |
60
- | **Lag compensation** | Rewind for hit detection |
61
-
62
- ---
63
-
64
- ## 3. Network Optimization
65
-
66
- ### Bandwidth Reduction
67
-
68
- | Technique | Savings |
69
- |-----------|---------|
70
- | **Delta compression** | Send only changes |
71
- | **Quantization** | Reduce precision |
72
- | **Priority** | Important data first |
73
- | **Area of interest** | Only nearby entities |
74
-
75
- ### Update Rates
76
-
77
- | Type | Rate |
78
- |------|------|
79
- | Position | 20-60 Hz |
80
- | Health | On change |
81
- | Inventory | On change |
82
- | Chat | On send |
83
-
84
- ---
85
-
86
- ## 4. Security Principles
87
-
88
- ### Server Authority
89
-
90
- ```
91
- Client: "I hit the enemy"
92
- Server: Validate → did projectile actually hit?
93
- → was player in valid state?
94
- → was timing possible?
95
- ```
96
-
97
- ### Anti-Cheat
98
-
99
- | Cheat | Prevention |
100
- |-------|------------|
101
- | Speed hack | Server validates movement |
102
- | Aimbot | Server validates sight line |
103
- | Item dupe | Server owns inventory |
104
- | Wall hack | Don't send hidden data |
105
-
106
- ---
107
-
108
- ## 5. Matchmaking
109
-
110
- ### Considerations
111
-
112
- | Factor | Impact |
113
- |--------|--------|
114
- | **Skill** | Fair matches |
115
- | **Latency** | Playable connection |
116
- | **Wait time** | Player patience |
117
- | **Party size** | Group play |
118
-
119
- ---
120
-
121
- ## 6. Anti-Patterns
122
-
123
- | ❌ Don't | ✅ Do |
124
- |----------|-------|
125
- | Trust the client | Server is authority |
126
- | Send everything | Send only necessary |
127
- | Ignore latency | Design for 100-200ms |
128
- | Sync exact positions | Interpolate/predict |
129
-
130
- ---
131
-
132
- > **Remember:** Never trust the client. The server is the source of truth.
@@ -1,144 +0,0 @@
1
- ---
2
- name: pc-games
3
- description: PC and console game development principles. Engine selection, platform features, optimization strategies.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- ---
6
-
7
- # PC/Console Game Development
8
-
9
- > Engine selection and platform-specific principles.
10
-
11
- ---
12
-
13
- ## 1. Engine Selection
14
-
15
- ### Decision Tree
16
-
17
- ```
18
- What are you building?
19
-
20
- ├── 2D Game
21
- │ ├── Open source important? → Godot
22
- │ └── Large team/assets? → Unity
23
-
24
- ├── 3D Game
25
- │ ├── AAA visual quality? → Unreal
26
- │ ├── Cross-platform priority? → Unity
27
- │ └── Indie/open source? → Godot 4
28
-
29
- └── Specific Needs
30
- ├── DOTS performance? → Unity
31
- ├── Nanite/Lumen? → Unreal
32
- └── Lightweight? → Godot
33
- ```
34
-
35
- ### Comparison
36
-
37
- | Factor | Unity 6 | Godot 4 | Unreal 5 |
38
- |--------|---------|---------|----------|
39
- | 2D | Good | Excellent | Limited |
40
- | 3D | Good | Good | Excellent |
41
- | Learning | Medium | Easy | Hard |
42
- | Cost | Revenue share | Free | 5% after $1M |
43
- | Team | Any | Solo-Medium | Medium-Large |
44
-
45
- ---
46
-
47
- ## 2. Platform Features
48
-
49
- ### Steam Integration
50
-
51
- | Feature | Purpose |
52
- |---------|---------|
53
- | Achievements | Player goals |
54
- | Cloud Saves | Cross-device progress |
55
- | Leaderboards | Competition |
56
- | Workshop | User mods |
57
- | Rich Presence | Show in-game status |
58
-
59
- ### Console Requirements
60
-
61
- | Platform | Certification |
62
- |----------|--------------|
63
- | PlayStation | TRC compliance |
64
- | Xbox | XR compliance |
65
- | Nintendo | Lotcheck |
66
-
67
- ---
68
-
69
- ## 3. Controller Support
70
-
71
- ### Input Abstraction
72
-
73
- ```
74
- Map ACTIONS, not buttons:
75
- - "confirm" → A (Xbox), Cross (PS), B (Nintendo)
76
- - "cancel" → B (Xbox), Circle (PS), A (Nintendo)
77
- ```
78
-
79
- ### Haptic Feedback
80
-
81
- | Intensity | Use |
82
- |-----------|-----|
83
- | Light | UI feedback |
84
- | Medium | Impacts |
85
- | Heavy | Major events |
86
-
87
- ---
88
-
89
- ## 4. Performance Optimization
90
-
91
- ### Profiling First
92
-
93
- | Engine | Tool |
94
- |--------|------|
95
- | Unity | Profiler Window |
96
- | Godot | Debugger → Profiler |
97
- | Unreal | Unreal Insights |
98
-
99
- ### Common Bottlenecks
100
-
101
- | Bottleneck | Solution |
102
- |------------|----------|
103
- | Draw calls | Batching, atlases |
104
- | GC spikes | Object pooling |
105
- | Physics | Simpler colliders |
106
- | Shaders | LOD shaders |
107
-
108
- ---
109
-
110
- ## 5. Engine-Specific Principles
111
-
112
- ### Unity 6
113
-
114
- - DOTS for performance-critical systems
115
- - Burst compiler for hot paths
116
- - Addressables for asset streaming
117
-
118
- ### Godot 4
119
-
120
- - GDScript for rapid iteration
121
- - C# for complex logic
122
- - Signals for decoupling
123
-
124
- ### Unreal 5
125
-
126
- - Blueprint for designers
127
- - C++ for performance
128
- - Nanite for high-poly environments
129
- - Lumen for dynamic lighting
130
-
131
- ---
132
-
133
- ## 6. Anti-Patterns
134
-
135
- | ❌ Don't | ✅ Do |
136
- |----------|-------|
137
- | Choose engine by hype | Choose by project needs |
138
- | Ignore platform guidelines | Study certification requirements |
139
- | Hardcode input buttons | Abstract to actions |
140
- | Skip profiling | Profile early and often |
141
-
142
- ---
143
-
144
- > **Remember:** Engine is a tool. Master the principles, then adapt to any engine.
@@ -1,123 +0,0 @@
1
- ---
2
- name: vr-ar
3
- description: VR/AR development principles. Comfort, interaction, performance requirements.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- ---
6
-
7
- # VR/AR Development
8
-
9
- > Immersive experience principles.
10
-
11
- ---
12
-
13
- ## 1. Platform Selection
14
-
15
- ### VR Platforms
16
-
17
- | Platform | Use Case |
18
- |----------|----------|
19
- | **Quest** | Standalone, wireless |
20
- | **PCVR** | High fidelity |
21
- | **PSVR** | Console market |
22
- | **WebXR** | Browser-based |
23
-
24
- ### AR Platforms
25
-
26
- | Platform | Use Case |
27
- |----------|----------|
28
- | **ARKit** | iOS devices |
29
- | **ARCore** | Android devices |
30
- | **WebXR** | Browser AR |
31
- | **HoloLens** | Enterprise |
32
-
33
- ---
34
-
35
- ## 2. Comfort Principles
36
-
37
- ### Motion Sickness Prevention
38
-
39
- | Cause | Solution |
40
- |-------|----------|
41
- | **Locomotion** | Teleport, snap turn |
42
- | **Low FPS** | Maintain 90 FPS |
43
- | **Camera shake** | Avoid or minimize |
44
- | **Rapid acceleration** | Gradual movement |
45
-
46
- ### Comfort Settings
47
-
48
- - Vignette during movement
49
- - Snap vs smooth turning
50
- - Seated vs standing modes
51
- - Height calibration
52
-
53
- ---
54
-
55
- ## 3. Performance Requirements
56
-
57
- ### Target Metrics
58
-
59
- | Platform | FPS | Resolution |
60
- |----------|-----|------------|
61
- | Quest 2 | 72-90 | 1832x1920 |
62
- | Quest 3 | 90-120 | 2064x2208 |
63
- | PCVR | 90 | 2160x2160+ |
64
- | PSVR2 | 90-120 | 2000x2040 |
65
-
66
- ### Frame Budget
67
-
68
- - VR requires consistent frame times
69
- - Single dropped frame = visible judder
70
- - 90 FPS = 11.11ms budget
71
-
72
- ---
73
-
74
- ## 4. Interaction Principles
75
-
76
- ### Controller Interaction
77
-
78
- | Type | Use |
79
- |------|-----|
80
- | **Point + click** | UI, distant objects |
81
- | **Grab** | Manipulation |
82
- | **Gesture** | Magic, special actions |
83
- | **Physical** | Throwing, swinging |
84
-
85
- ### Hand Tracking
86
-
87
- - More immersive but less precise
88
- - Good for: social, casual
89
- - Challenging for: action, precision
90
-
91
- ---
92
-
93
- ## 5. Spatial Design
94
-
95
- ### World Scale
96
-
97
- - 1 unit = 1 meter (critical)
98
- - Objects must feel right size
99
- - Test with real measurements
100
-
101
- ### Depth Cues
102
-
103
- | Cue | Importance |
104
- |-----|------------|
105
- | Stereo | Primary depth |
106
- | Motion parallax | Secondary |
107
- | Shadows | Grounding |
108
- | Occlusion | Layering |
109
-
110
- ---
111
-
112
- ## 6. Anti-Patterns
113
-
114
- | ❌ Don't | ✅ Do |
115
- |----------|-------|
116
- | Move camera without player | Player controls camera |
117
- | Drop below 90 FPS | Maintain frame rate |
118
- | Use tiny UI text | Large, readable text |
119
- | Ignore arm length | Scale to player reach |
120
-
121
- ---
122
-
123
- > **Remember:** Comfort is not optional. Sick players don't play.
@@ -1,150 +0,0 @@
1
- ---
2
- name: web-games
3
- description: Web browser game development principles. Framework selection, WebGPU, optimization, PWA.
4
- allowed-tools: Read, Write, Edit, Glob, Grep
5
- ---
6
-
7
- # Web Browser Game Development
8
-
9
- > Framework selection and browser-specific principles.
10
-
11
- ---
12
-
13
- ## 1. Framework Selection
14
-
15
- ### Decision Tree
16
-
17
- ```
18
- What type of game?
19
-
20
- ├── 2D Game
21
- │ ├── Full game engine features? → Phaser
22
- │ └── Raw rendering power? → PixiJS
23
-
24
- ├── 3D Game
25
- │ ├── Full engine (physics, XR)? → Babylon.js
26
- │ └── Rendering focused? → Three.js
27
-
28
- └── Hybrid / Canvas
29
- └── Custom → Raw Canvas/WebGL
30
- ```
31
-
32
- ### Comparison (2025)
33
-
34
- | Framework | Type | Best For |
35
- |-----------|------|----------|
36
- | **Phaser 4** | 2D | Full game features |
37
- | **PixiJS 8** | 2D | Rendering, UI |
38
- | **Three.js** | 3D | Visualizations, lightweight |
39
- | **Babylon.js 7** | 3D | Full engine, XR |
40
-
41
- ---
42
-
43
- ## 2. WebGPU Adoption
44
-
45
- ### Browser Support (2025)
46
-
47
- | Browser | Support |
48
- |---------|---------|
49
- | Chrome | ✅ Since v113 |
50
- | Edge | ✅ Since v113 |
51
- | Firefox | ✅ Since v131 |
52
- | Safari | ✅ Since 18.0 |
53
- | **Total** | **~73%** global |
54
-
55
- ### Decision
56
-
57
- - **New projects**: Use WebGPU with WebGL fallback
58
- - **Legacy support**: Start with WebGL
59
- - **Feature detection**: Check `navigator.gpu`
60
-
61
- ---
62
-
63
- ## 3. Performance Principles
64
-
65
- ### Browser Constraints
66
-
67
- | Constraint | Strategy |
68
- |------------|----------|
69
- | No local file access | Asset bundling, CDN |
70
- | Tab throttling | Pause when hidden |
71
- | Mobile data limits | Compress assets |
72
- | Audio autoplay | Require user interaction |
73
-
74
- ### Optimization Priority
75
-
76
- 1. **Asset compression** - KTX2, Draco, WebP
77
- 2. **Lazy loading** - Load on demand
78
- 3. **Object pooling** - Avoid GC
79
- 4. **Draw call batching** - Reduce state changes
80
- 5. **Web Workers** - Offload heavy computation
81
-
82
- ---
83
-
84
- ## 4. Asset Strategy
85
-
86
- ### Compression Formats
87
-
88
- | Type | Format |
89
- |------|--------|
90
- | Textures | KTX2 + Basis Universal |
91
- | Audio | WebM/Opus (fallback: MP3) |
92
- | 3D Models | glTF + Draco/Meshopt |
93
-
94
- ### Loading Strategy
95
-
96
- | Phase | Load |
97
- |-------|------|
98
- | Startup | Core assets, <2MB |
99
- | Gameplay | Stream on demand |
100
- | Background | Prefetch next level |
101
-
102
- ---
103
-
104
- ## 5. PWA for Games
105
-
106
- ### Benefits
107
-
108
- - Offline play
109
- - Install to home screen
110
- - Full screen mode
111
- - Push notifications
112
-
113
- ### Requirements
114
-
115
- - Service worker for caching
116
- - Web app manifest
117
- - HTTPS
118
-
119
- ---
120
-
121
- ## 6. Audio Handling
122
-
123
- ### Browser Requirements
124
-
125
- - Audio context requires user interaction
126
- - Create AudioContext on first click/tap
127
- - Resume context if suspended
128
-
129
- ### Best Practices
130
-
131
- - Use Web Audio API
132
- - Pool audio sources
133
- - Preload common sounds
134
- - Compress with WebM/Opus
135
-
136
- ---
137
-
138
- ## 7. Anti-Patterns
139
-
140
- | ❌ Don't | ✅ Do |
141
- |----------|-------|
142
- | Load all assets upfront | Progressive loading |
143
- | Ignore tab visibility | Pause when hidden |
144
- | Block on audio load | Lazy load audio |
145
- | Skip compression | Compress everything |
146
- | Assume fast connection | Handle slow networks |
147
-
148
- ---
149
-
150
- > **Remember:** Browser is the most accessible platform. Respect its constraints.