@maestro-ai/mcp-server 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (448) 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.d.ts.map +1 -1
  141. package/dist/tools/carregar-projeto.js +91 -116
  142. package/dist/tools/carregar-projeto.js.map +1 -1
  143. package/dist/tools/classificar.js +36 -36
  144. package/dist/tools/confirmar-classificacao.js +36 -36
  145. package/dist/tools/confirmar-stitch.js +75 -75
  146. package/dist/tools/contexto.js +56 -56
  147. package/dist/tools/fluxos-alternativos.js +98 -98
  148. package/dist/tools/implementar-historia.js +63 -63
  149. package/dist/tools/iniciar-projeto.d.ts.map +1 -1
  150. package/dist/tools/iniciar-projeto.js +139 -224
  151. package/dist/tools/iniciar-projeto.js.map +1 -1
  152. package/dist/tools/proximo.d.ts.map +1 -1
  153. package/dist/tools/proximo.js +224 -252
  154. package/dist/tools/proximo.js.map +1 -1
  155. package/dist/tools/salvar.js +59 -59
  156. package/dist/tools/status.d.ts.map +1 -1
  157. package/dist/tools/status.js +64 -93
  158. package/dist/tools/status.js.map +1 -1
  159. package/dist/tools/validar-gate.js +35 -35
  160. package/dist/types/response.js +11 -11
  161. package/dist/utils/instructions.js +48 -48
  162. package/dist/utils/prompt-mapper.js +16 -16
  163. package/dist/utils/system-md.js +33 -33
  164. package/package.json +67 -67
  165. package/dist/content/content/design-system/README.md +0 -231
  166. package/dist/content/content/design-system/data/charts.csv +0 -26
  167. package/dist/content/content/design-system/data/colors.csv +0 -97
  168. package/dist/content/content/design-system/data/icons.csv +0 -101
  169. package/dist/content/content/design-system/data/landing.csv +0 -31
  170. package/dist/content/content/design-system/data/products.csv +0 -97
  171. package/dist/content/content/design-system/data/prompts.csv +0 -24
  172. package/dist/content/content/design-system/data/react-performance.csv +0 -45
  173. package/dist/content/content/design-system/data/styles.csv +0 -59
  174. package/dist/content/content/design-system/data/typography.csv +0 -58
  175. package/dist/content/content/design-system/data/ui-reasoning.csv +0 -101
  176. package/dist/content/content/design-system/data/ux-guidelines.csv +0 -100
  177. package/dist/content/content/design-system/data/web-interface.csv +0 -31
  178. package/dist/content/content/design-system/indexes/README.md +0 -211
  179. package/dist/content/content/design-system/indexes/colors-index.md +0 -156
  180. package/dist/content/content/design-system/indexes/quick-search.md +0 -111
  181. package/dist/content/content/design-system/indexes/stacks-index.md +0 -341
  182. package/dist/content/content/design-system/stacks/flutter.csv +0 -53
  183. package/dist/content/content/design-system/stacks/html-tailwind.csv +0 -56
  184. package/dist/content/content/design-system/stacks/jetpack-compose.csv +0 -53
  185. package/dist/content/content/design-system/stacks/nextjs.csv +0 -53
  186. package/dist/content/content/design-system/stacks/nuxt-ui.csv +0 -51
  187. package/dist/content/content/design-system/stacks/nuxtjs.csv +0 -59
  188. package/dist/content/content/design-system/stacks/react-native.csv +0 -52
  189. package/dist/content/content/design-system/stacks/react.csv +0 -54
  190. package/dist/content/content/design-system/stacks/shadcn.csv +0 -61
  191. package/dist/content/content/design-system/stacks/svelte.csv +0 -54
  192. package/dist/content/content/design-system/stacks/swiftui.csv +0 -51
  193. package/dist/content/content/design-system/stacks/vue.csv +0 -50
  194. package/dist/content/content/examples/Exemplo de Fluxo Completo com Java e Spring Boot.md +0 -250
  195. package/dist/content/content/examples/Exemplo de Fluxo Completo com Laravel e Filament.md +0 -278
  196. package/dist/content/content/examples/Exemplo de Fluxo Completo com Laravel e Livewire.md +0 -261
  197. package/dist/content/content/examples/Exemplo de Fluxo Completo com Node e NestJS.md +0 -258
  198. package/dist/content/content/guides/Cat/303/241logo de Stacks para Cloud Moderna.md" +0 -119
  199. package/dist/content/content/guides/Cat/303/241logo de Stacks para Hospedagem Compartilhada.md" +0 -147
  200. package/dist/content/content/guides/Checklist Mestre de Entrega.md +0 -68
  201. package/dist/content/content/guides/Gates de Qualidade.md +0 -209
  202. package/dist/content/content/guides/Guia de Adi/303/247/303/243o de Novas Funcionalidades.md" +0 -355
  203. package/dist/content/content/guides/Guia de Chaos Engineering.md +0 -267
  204. package/dist/content/content/guides/Guia de Debugging com IA.md +0 -135
  205. package/dist/content/content/guides/Guia de Estrat/303/251gias de Cache.md" +0 -352
  206. package/dist/content/content/guides/Guia de Migrations Zero-Downtime.md +0 -311
  207. package/dist/content/content/guides/Guia de Multi-tenancy.md +0 -368
  208. package/dist/content/content/guides/Guia de Otimiza/303/247/303/243o de Custos Cloud.md" +0 -195
  209. package/dist/content/content/guides/Guia de Refatora/303/247/303/243o de C/303/263digo Legado com IA.md" +0 -162
  210. package/dist/content/content/guides/Guia de SLOs e Error Budgets.md +0 -315
  211. package/dist/content/content/guides/M/303/251tricas de Efici/303/252ncia do Desenvolvimento com IA.md" +0 -93
  212. package/dist/content/content/guides/Rules base.md +0 -90
  213. package/dist/content/content/playbook/Playbook de Desenvolvimento com IA.md +0 -364
  214. package/dist/content/content/prompts/README.md +0 -203
  215. package/dist/content/content/prompts/acessibilidade/analise-acessibilidade.md +0 -257
  216. package/dist/content/content/prompts/apis/design-api-rest.md +0 -303
  217. package/dist/content/content/prompts/apis/idempotencia.md +0 -254
  218. package/dist/content/content/prompts/apis/versionamento.md +0 -313
  219. package/dist/content/content/prompts/arquitetura/arquitetura-c4-completo.md +0 -190
  220. package/dist/content/content/prompts/arquitetura/clean-architecture.md +0 -151
  221. package/dist/content/content/prompts/arquitetura/ddd-bounded-contexts.md +0 -183
  222. package/dist/content/content/prompts/arquitetura/ddd-cqrs.md +0 -176
  223. package/dist/content/content/prompts/arquitetura/modelo-dominio.md +0 -207
  224. package/dist/content/content/prompts/arquitetura/multi-tenancy.md +0 -235
  225. package/dist/content/content/prompts/database/migrations-zero-downtime.md +0 -192
  226. package/dist/content/content/prompts/database/otimizacao-queries.md +0 -296
  227. package/dist/content/content/prompts/desenvolvimento/code-review.md +0 -301
  228. package/dist/content/content/prompts/desenvolvimento/gerar-servico.md +0 -271
  229. package/dist/content/content/prompts/devops/docker-compose.md +0 -336
  230. package/dist/content/content/prompts/devops/feature-flags.md +0 -374
  231. package/dist/content/content/prompts/devops/kubernetes-deploy.md +0 -460
  232. package/dist/content/content/prompts/devops/pipeline-cicd.md +0 -358
  233. package/dist/content/content/prompts/devops/terraform-iac.md +0 -502
  234. package/dist/content/content/prompts/escalabilidade/analise-performance.md +0 -240
  235. package/dist/content/content/prompts/escalabilidade/analise-performance.txt +0 -94
  236. package/dist/content/content/prompts/escalabilidade/caching.md +0 -255
  237. package/dist/content/content/prompts/observabilidade/chaos-testing.md +0 -237
  238. package/dist/content/content/prompts/observabilidade/estrategia-observabilidade.md +0 -263
  239. package/dist/content/content/prompts/observabilidade/estrategia-observabilidade.txt +0 -134
  240. package/dist/content/content/prompts/observabilidade/slos.md +0 -215
  241. package/dist/content/content/prompts/produto/discovery-inicial.md +0 -203
  242. package/dist/content/content/prompts/produto/discovery-inicial.txt +0 -33
  243. package/dist/content/content/prompts/requisitos/refinar-requisitos.md +0 -232
  244. package/dist/content/content/prompts/requisitos/refinar-requisitos.txt +0 -40
  245. package/dist/content/content/prompts/seguranca/analise-seguranca.md +0 -243
  246. package/dist/content/content/prompts/seguranca/pentest-checklist.md +0 -333
  247. package/dist/content/content/prompts/seguranca/rate-limiting.md +0 -356
  248. package/dist/content/content/prompts/seguranca/revisao-lgpd.md +0 -227
  249. package/dist/content/content/prompts/seguranca/threat-modeling.md +0 -224
  250. package/dist/content/content/prompts/testes/contract-testing.md +0 -340
  251. package/dist/content/content/prompts/testes/gerar-testes-unitarios.md +0 -474
  252. package/dist/content/content/prompts/testes/testes-e2e.md +0 -460
  253. package/dist/content/content/prompts/testes/testes-integracao.md +0 -418
  254. package/dist/content/content/prompts/testes/testes-performance.md +0 -458
  255. package/dist/content/content/prompts/ux/gerar-ui-stitch.md +0 -151
  256. package/dist/content/content/rules/GEMINI.md +0 -841
  257. package/dist/content/content/rules/RULES.md +0 -835
  258. package/dist/content/content/rules/adapters/copilot.md +0 -10
  259. package/dist/content/content/rules/adapters/cursor.md +0 -10
  260. package/dist/content/content/rules/adapters/gemini.md +0 -13
  261. package/dist/content/content/rules/adapters/windsurf.md +0 -10
  262. package/dist/content/content/skills/api-patterns/SKILL.md +0 -81
  263. package/dist/content/content/skills/api-patterns/api-style.md +0 -42
  264. package/dist/content/content/skills/api-patterns/auth.md +0 -24
  265. package/dist/content/content/skills/api-patterns/documentation.md +0 -26
  266. package/dist/content/content/skills/api-patterns/graphql.md +0 -41
  267. package/dist/content/content/skills/api-patterns/rate-limiting.md +0 -31
  268. package/dist/content/content/skills/api-patterns/response.md +0 -37
  269. package/dist/content/content/skills/api-patterns/rest.md +0 -40
  270. package/dist/content/content/skills/api-patterns/scripts/api_validator.py +0 -211
  271. package/dist/content/content/skills/api-patterns/security-testing.md +0 -122
  272. package/dist/content/content/skills/api-patterns/trpc.md +0 -41
  273. package/dist/content/content/skills/api-patterns/versioning.md +0 -22
  274. package/dist/content/content/skills/app-builder/SKILL.md +0 -75
  275. package/dist/content/content/skills/app-builder/agent-coordination.md +0 -71
  276. package/dist/content/content/skills/app-builder/feature-building.md +0 -53
  277. package/dist/content/content/skills/app-builder/project-detection.md +0 -34
  278. package/dist/content/content/skills/app-builder/scaffolding.md +0 -118
  279. package/dist/content/content/skills/app-builder/tech-stack.md +0 -40
  280. package/dist/content/content/skills/app-builder/templates/SKILL.md +0 -39
  281. package/dist/content/content/skills/app-builder/templates/astro-static/TEMPLATE.md +0 -76
  282. package/dist/content/content/skills/app-builder/templates/chrome-extension/TEMPLATE.md +0 -92
  283. package/dist/content/content/skills/app-builder/templates/cli-tool/TEMPLATE.md +0 -88
  284. package/dist/content/content/skills/app-builder/templates/electron-desktop/TEMPLATE.md +0 -88
  285. package/dist/content/content/skills/app-builder/templates/express-api/TEMPLATE.md +0 -83
  286. package/dist/content/content/skills/app-builder/templates/flutter-app/TEMPLATE.md +0 -90
  287. package/dist/content/content/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +0 -90
  288. package/dist/content/content/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +0 -82
  289. package/dist/content/content/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +0 -100
  290. package/dist/content/content/skills/app-builder/templates/nextjs-static/TEMPLATE.md +0 -106
  291. package/dist/content/content/skills/app-builder/templates/nuxt-app/TEMPLATE.md +0 -101
  292. package/dist/content/content/skills/app-builder/templates/python-fastapi/TEMPLATE.md +0 -83
  293. package/dist/content/content/skills/app-builder/templates/react-native-app/TEMPLATE.md +0 -93
  294. package/dist/content/content/skills/architecture/SKILL.md +0 -55
  295. package/dist/content/content/skills/architecture/context-discovery.md +0 -43
  296. package/dist/content/content/skills/architecture/examples.md +0 -94
  297. package/dist/content/content/skills/architecture/pattern-selection.md +0 -68
  298. package/dist/content/content/skills/architecture/patterns-reference.md +0 -50
  299. package/dist/content/content/skills/architecture/trade-off-analysis.md +0 -77
  300. package/dist/content/content/skills/bash-linux/SKILL.md +0 -199
  301. package/dist/content/content/skills/behavioral-modes/SKILL.md +0 -242
  302. package/dist/content/content/skills/brainstorming/SKILL.md +0 -163
  303. package/dist/content/content/skills/brainstorming/dynamic-questioning.md +0 -350
  304. package/dist/content/content/skills/clean-code/SKILL.md +0 -201
  305. package/dist/content/content/skills/code-review-checklist/SKILL.md +0 -109
  306. package/dist/content/content/skills/database-design/SKILL.md +0 -52
  307. package/dist/content/content/skills/database-design/database-selection.md +0 -43
  308. package/dist/content/content/skills/database-design/indexing.md +0 -39
  309. package/dist/content/content/skills/database-design/migrations.md +0 -48
  310. package/dist/content/content/skills/database-design/optimization.md +0 -36
  311. package/dist/content/content/skills/database-design/orm-selection.md +0 -30
  312. package/dist/content/content/skills/database-design/schema-design.md +0 -56
  313. package/dist/content/content/skills/database-design/scripts/schema_validator.py +0 -172
  314. package/dist/content/content/skills/deployment-procedures/SKILL.md +0 -241
  315. package/dist/content/content/skills/doc.md +0 -177
  316. package/dist/content/content/skills/documentation-templates/SKILL.md +0 -194
  317. package/dist/content/content/skills/frontend-design/SKILL.md +0 -396
  318. package/dist/content/content/skills/frontend-design/animation-guide.md +0 -331
  319. package/dist/content/content/skills/frontend-design/color-system.md +0 -311
  320. package/dist/content/content/skills/frontend-design/decision-trees.md +0 -418
  321. package/dist/content/content/skills/frontend-design/motion-graphics.md +0 -306
  322. package/dist/content/content/skills/frontend-design/scripts/accessibility_checker.py +0 -183
  323. package/dist/content/content/skills/frontend-design/scripts/ux_audit.py +0 -722
  324. package/dist/content/content/skills/frontend-design/typography-system.md +0 -345
  325. package/dist/content/content/skills/frontend-design/ux-psychology.md +0 -541
  326. package/dist/content/content/skills/frontend-design/visual-effects.md +0 -383
  327. package/dist/content/content/skills/game-development/2d-games/SKILL.md +0 -119
  328. package/dist/content/content/skills/game-development/3d-games/SKILL.md +0 -135
  329. package/dist/content/content/skills/game-development/SKILL.md +0 -167
  330. package/dist/content/content/skills/game-development/game-art/SKILL.md +0 -185
  331. package/dist/content/content/skills/game-development/game-audio/SKILL.md +0 -190
  332. package/dist/content/content/skills/game-development/game-design/SKILL.md +0 -129
  333. package/dist/content/content/skills/game-development/mobile-games/SKILL.md +0 -108
  334. package/dist/content/content/skills/game-development/multiplayer/SKILL.md +0 -132
  335. package/dist/content/content/skills/game-development/pc-games/SKILL.md +0 -144
  336. package/dist/content/content/skills/game-development/vr-ar/SKILL.md +0 -123
  337. package/dist/content/content/skills/game-development/web-games/SKILL.md +0 -150
  338. package/dist/content/content/skills/geo-fundamentals/SKILL.md +0 -156
  339. package/dist/content/content/skills/geo-fundamentals/scripts/geo_checker.py +0 -289
  340. package/dist/content/content/skills/i18n-localization/SKILL.md +0 -154
  341. package/dist/content/content/skills/i18n-localization/scripts/i18n_checker.py +0 -241
  342. package/dist/content/content/skills/intelligent-routing/SKILL.md +0 -334
  343. package/dist/content/content/skills/lint-and-validate/SKILL.md +0 -45
  344. package/dist/content/content/skills/lint-and-validate/scripts/lint_runner.py +0 -172
  345. package/dist/content/content/skills/lint-and-validate/scripts/type_coverage.py +0 -173
  346. package/dist/content/content/skills/mcp-builder/SKILL.md +0 -176
  347. package/dist/content/content/skills/mobile-design/SKILL.md +0 -394
  348. package/dist/content/content/skills/mobile-design/decision-trees.md +0 -516
  349. package/dist/content/content/skills/mobile-design/mobile-backend.md +0 -491
  350. package/dist/content/content/skills/mobile-design/mobile-color-system.md +0 -420
  351. package/dist/content/content/skills/mobile-design/mobile-debugging.md +0 -122
  352. package/dist/content/content/skills/mobile-design/mobile-design-thinking.md +0 -357
  353. package/dist/content/content/skills/mobile-design/mobile-navigation.md +0 -458
  354. package/dist/content/content/skills/mobile-design/mobile-performance.md +0 -767
  355. package/dist/content/content/skills/mobile-design/mobile-testing.md +0 -356
  356. package/dist/content/content/skills/mobile-design/mobile-typography.md +0 -433
  357. package/dist/content/content/skills/mobile-design/platform-android.md +0 -666
  358. package/dist/content/content/skills/mobile-design/platform-ios.md +0 -561
  359. package/dist/content/content/skills/mobile-design/scripts/mobile_audit.py +0 -670
  360. package/dist/content/content/skills/mobile-design/touch-psychology.md +0 -537
  361. package/dist/content/content/skills/nextjs-best-practices/SKILL.md +0 -203
  362. package/dist/content/content/skills/nodejs-best-practices/SKILL.md +0 -333
  363. package/dist/content/content/skills/parallel-agents/SKILL.md +0 -175
  364. package/dist/content/content/skills/performance-profiling/SKILL.md +0 -143
  365. package/dist/content/content/skills/performance-profiling/scripts/lighthouse_audit.py +0 -76
  366. package/dist/content/content/skills/plan-writing/SKILL.md +0 -152
  367. package/dist/content/content/skills/powershell-windows/SKILL.md +0 -167
  368. package/dist/content/content/skills/python-patterns/SKILL.md +0 -441
  369. package/dist/content/content/skills/react-patterns/SKILL.md +0 -198
  370. package/dist/content/content/skills/red-team-tactics/SKILL.md +0 -199
  371. package/dist/content/content/skills/seo-fundamentals/SKILL.md +0 -129
  372. package/dist/content/content/skills/seo-fundamentals/scripts/seo_checker.py +0 -219
  373. package/dist/content/content/skills/server-management/SKILL.md +0 -161
  374. package/dist/content/content/skills/systematic-debugging/SKILL.md +0 -109
  375. package/dist/content/content/skills/tailwind-patterns/SKILL.md +0 -269
  376. package/dist/content/content/skills/tdd-workflow/SKILL.md +0 -149
  377. package/dist/content/content/skills/testing-patterns/SKILL.md +0 -178
  378. package/dist/content/content/skills/testing-patterns/scripts/test_runner.py +0 -219
  379. package/dist/content/content/skills/vulnerability-scanner/SKILL.md +0 -276
  380. package/dist/content/content/skills/vulnerability-scanner/checklists.md +0 -121
  381. package/dist/content/content/skills/vulnerability-scanner/scripts/security_scan.py +0 -458
  382. package/dist/content/content/skills/webapp-testing/SKILL.md +0 -187
  383. package/dist/content/content/skills/webapp-testing/scripts/playwright_runner.py +0 -173
  384. package/dist/content/content/specialists/Especialista em Acessibilidade.md +0 -266
  385. package/dist/content/content/specialists/Especialista em An/303/241lise de Testes.md" +0 -434
  386. package/dist/content/content/specialists/Especialista em Arquitetura Avan/303/247ada.md" +0 -358
  387. package/dist/content/content/specialists/Especialista em Arquitetura de Software.md +0 -177
  388. package/dist/content/content/specialists/Especialista em Banco de Dados.md +0 -260
  389. package/dist/content/content/specialists/Especialista em Contrato de API.md +0 -172
  390. package/dist/content/content/specialists/Especialista em Dados e Analytics com IA.md +0 -246
  391. package/dist/content/content/specialists/Especialista em Debugging e Troubleshooting.md +0 -191
  392. package/dist/content/content/specialists/Especialista em Desenvolvimento Frontend.md +0 -477
  393. package/dist/content/content/specialists/Especialista em Desenvolvimento Mobile.md +0 -241
  394. package/dist/content/content/specialists/Especialista em Desenvolvimento e Vibe Coding Estruturado.md +0 -417
  395. package/dist/content/content/specialists/Especialista em DevOps e Infraestrutura.md +0 -294
  396. package/dist/content/content/specialists/Especialista em Documenta/303/247/303/243o T/303/251cnica.md" +0 -227
  397. package/dist/content/content/specialists/Especialista em Engenharia de Requisitos com IA.md +0 -299
  398. package/dist/content/content/specialists/Especialista em Explora/303/247/303/243o de Codebase.md" +0 -179
  399. package/dist/content/content/specialists/Especialista em Gest/303/243o de Produto.md" +0 -179
  400. package/dist/content/content/specialists/Especialista em Migra/303/247/303/243o e Moderniza/303/247/303/243o.md" +0 -410
  401. package/dist/content/content/specialists/Especialista em Modelagem e Arquitetura de Dom/303/255nio com IA.md" +0 -248
  402. package/dist/content/content/specialists/Especialista em Observabilidade.md +0 -415
  403. package/dist/content/content/specialists/Especialista em Performance e Escalabilidade.md +0 -373
  404. package/dist/content/content/specialists/Especialista em Plano de Execu/303/247/303/243o com IA.md" +0 -341
  405. package/dist/content/content/specialists/Especialista em Prototipagem R/303/241pida com Google Stitch.md" +0 -419
  406. package/dist/content/content/specialists/Especialista em Seguran/303/247a da Informa/303/247/303/243o.md" +0 -508
  407. package/dist/content/content/specialists/Especialista em UX Design.md +0 -453
  408. package/dist/content/content/specialists/INDEX.md +0 -43
  409. package/dist/content/content/templates/PRD.md +0 -165
  410. package/dist/content/content/templates/README.md +0 -65
  411. package/dist/content/content/templates/adr.md +0 -103
  412. package/dist/content/content/templates/arquitetura.md +0 -279
  413. package/dist/content/content/templates/backlog.md +0 -185
  414. package/dist/content/content/templates/checklist-seguranca.md +0 -180
  415. package/dist/content/content/templates/contexto.md +0 -120
  416. package/dist/content/content/templates/criterios-aceite.md +0 -99
  417. package/dist/content/content/templates/design-banco.md +0 -270
  418. package/dist/content/content/templates/design-doc.md +0 -240
  419. package/dist/content/content/templates/feature.md +0 -88
  420. package/dist/content/content/templates/historia-backend.md +0 -84
  421. package/dist/content/content/templates/historia-frontend.md +0 -75
  422. package/dist/content/content/templates/historia-usuario.md +0 -125
  423. package/dist/content/content/templates/mapa-navegacao.md +0 -133
  424. package/dist/content/content/templates/matriz-rastreabilidade.md +0 -121
  425. package/dist/content/content/templates/modelo-dominio.md +0 -219
  426. package/dist/content/content/templates/plano-testes.md +0 -199
  427. package/dist/content/content/templates/prototipo-stitch.md +0 -138
  428. package/dist/content/content/templates/requisitos.md +0 -162
  429. package/dist/content/content/templates/slo-sli.md +0 -197
  430. package/dist/content/content/workflows/README-MCP.md +0 -363
  431. package/dist/content/content/workflows/brainstorm.md +0 -113
  432. package/dist/content/content/workflows/create.md +0 -59
  433. package/dist/content/content/workflows/debug.md +0 -103
  434. package/dist/content/content/workflows/deploy.md +0 -176
  435. package/dist/content/content/workflows/enhance.md +0 -63
  436. package/dist/content/content/workflows/mcp-debug.md +0 -506
  437. package/dist/content/content/workflows/mcp-feature.md +0 -385
  438. package/dist/content/content/workflows/mcp-gate.md +0 -413
  439. package/dist/content/content/workflows/mcp-next.md +0 -388
  440. package/dist/content/content/workflows/mcp-refactor.md +0 -600
  441. package/dist/content/content/workflows/mcp-start.md +0 -304
  442. package/dist/content/content/workflows/mcp-status.md +0 -400
  443. package/dist/content/content/workflows/orchestrate.md +0 -237
  444. package/dist/content/content/workflows/plan.md +0 -89
  445. package/dist/content/content/workflows/preview.md +0 -81
  446. package/dist/content/content/workflows/status.md +0 -86
  447. package/dist/content/content/workflows/test.md +0 -144
  448. 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.