@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,506 +1,506 @@
1
- ---
2
- description: Correção de bugs com fluxo estruturado (Reprodução → Análise → Fix → Regressão)
3
- ---
4
-
5
- # /mcp-debug - Correção de Bug MCP
6
-
7
- $ARGUMENTS
8
-
9
- ---
10
-
11
- ## Objetivo
12
-
13
- Corrigir bugs de forma estruturada usando fluxo de 4 fases do MCP Maestro, com análise de causa raiz e testes de regressão.
14
-
15
- ---
16
-
17
- ## Quando Usar
18
-
19
- - Bug reportado em produção ou desenvolvimento
20
- - Comportamento inesperado que precisa investigação
21
- - Erro que requer análise sistemática
22
-
23
- **NÃO usar para:**
24
- - Nova funcionalidade → Use `/mcp-feature`
25
- - Refatoração de código → Use `/mcp-refactor`
26
-
27
- ---
28
-
29
- ## Fluxo de 4 Fases
30
-
31
- ```
32
- 1. Reprodução do Bug
33
-
34
- 2. Análise de Causa Raiz
35
-
36
- 3. Fix + Testes de Regressão
37
-
38
- 4. Deploy
39
- ```
40
-
41
- ---
42
-
43
- ## Execução
44
-
45
- ### Passo 1: Coleta de Informações
46
-
47
- **Perguntar ao usuário:**
48
-
49
- ```markdown
50
- 🐛 **Correção de Bug**
51
-
52
- 1. Descreva o bug:
53
- [Exemplo: Pedido duplicado ao clicar rapidamente no botão "Finalizar"]
54
-
55
- 2. Severidade do bug:
56
- - **critica**: Sistema inoperante, perda de dados
57
- - **alta**: Feature principal não funciona
58
- - **media**: Feature secundária afetada
59
- - **baixa**: Cosmético, sem impacto funcional
60
-
61
- Escolha: [critica/alta/media/baixa]
62
-
63
- 3. (Opcional) Como reproduzir:
64
- [Passos para reproduzir o bug]
65
-
66
- 4. (Opcional) Stack trace ou logs:
67
- [Cole aqui se disponível]
68
- ```
69
-
70
- ---
71
-
72
- ### Passo 2: Iniciar Fluxo de Debugging
73
-
74
- ```typescript
75
- await mcp_maestro_corrigir_bug({
76
- descricao: "[descrição fornecida]",
77
- severidade: "[critica/alta/media/baixa]",
78
- ticket_id: "[opcional: JIRA-123]"
79
- });
80
- ```
81
-
82
- **MCP cria contexto de bug e retorna:**
83
-
84
- ```json
85
- {
86
- "bug_id": "BUG-001",
87
- "fases": [
88
- "Reprodução",
89
- "Análise de Causa Raiz",
90
- "Fix + Regressão",
91
- "Deploy"
92
- ],
93
- "fase_atual": 1,
94
- "prioridade": "[baseada na severidade]"
95
- }
96
- ```
97
-
98
- ---
99
-
100
- ### Passo 3: Fase 1 - Reprodução do Bug
101
-
102
- **Apresentar:**
103
-
104
- ```markdown
105
- ✅ **Fluxo de Debugging Iniciado** (BUG-001)
106
- 🚨 **Severidade:** [critica/alta/media/baixa]
107
-
108
- ---
109
-
110
- 🎯 **Fase 1/4: Reprodução do Bug**
111
- 🤖 **Especialista:** Debugging e Troubleshooting
112
-
113
- ## Reprodução Sistemática
114
-
115
- Vamos reproduzir o bug de forma controlada:
116
-
117
- 1. **Ambiente**
118
- - Onde ocorre: [dev/staging/prod]
119
- - Versão: [commit/tag]
120
- - Browser/Device: [se aplicável]
121
-
122
- 2. **Passos para Reproduzir**
123
- 1. [Passo 1]
124
- 2. [Passo 2]
125
- 3. [Passo 3]
126
-
127
- 3. **Comportamento Esperado**
128
- - [O que deveria acontecer]
129
-
130
- 4. **Comportamento Atual**
131
- - [O que está acontecendo]
132
-
133
- 5. **Evidências**
134
- - Screenshots: [urls se disponível]
135
- - Logs: [trechos relevantes]
136
- - Network: [requests falhando]
137
-
138
- Conseguiu reproduzir o bug? (S/N)
139
- ```
140
-
141
- ---
142
-
143
- ### Passo 4: Fase 2 - Análise de Causa Raiz
144
-
145
- **Carregar especialista de Debugging:**
146
-
147
- ```typescript
148
- const especialista = await fetch('maestro://especialista/debugging-troubleshooting');
149
- ```
150
-
151
- **Apresentar:**
152
-
153
- ```markdown
154
- 🎯 **Fase 2/4: Análise de Causa Raiz**
155
-
156
- ## Investigação Sistemática
157
-
158
- ### Hipóteses Possíveis
159
-
160
- Baseado nos sintomas, lista de causas prováveis:
161
-
162
- 1. ❓ **[Hipótese 1 - Mais provável]**
163
- - Evidência: [log/código que apoia]
164
- - Como testar: [validação]
165
-
166
- 2. ❓ **[Hipótese 2]**
167
- - Evidência: [...]
168
- - Como testar: [...]
169
-
170
- 3. ❓ **[Hipótese 3 - Menos provável]**
171
- - Evidência: [...]
172
- - Como testar: [...]
173
-
174
- ### Análise de Código
175
-
176
- Arquivos suspeitos:
177
- - `[arquivo1.ts]` - [motivo]
178
- - `[arquivo2.ts]` - [motivo]
179
-
180
- Vamos investigar a hipótese 1. [Análise detalhada do código]
181
- ```
182
-
183
- **Processo de eliminação:**
184
-
185
- ```markdown
186
- **Testando Hipótese 1:** [descrição]
187
-
188
- [Análise do código/logs]
189
-
190
- **Resultado:** ✅ Confirmada / ❌ Descartada
191
-
192
- ---
193
-
194
- 🎯 **Causa Raiz Identificada:**
195
-
196
- [Explicação detalhada do problema]
197
-
198
- **Por que aconteceu:**
199
- - [Motivo 1]
200
- - [Motivo 2]
201
-
202
- **Onde está o bug:**
203
- - Arquivo: `[caminho/arquivo.ts]`
204
- - Linha: [numero]
205
- - Função: `[nomeFuncao]`
206
- ```
207
-
208
- ---
209
-
210
- ### Passo 5: Fase 3 - Fix + Testes de Regressão
211
-
212
- **Apresentar:**
213
-
214
- ```markdown
215
- 🎯 **Fase 3/4: Fix + Testes de Regressão**
216
-
217
- ## Correção Proposta
218
-
219
- ```[linguagem]
220
- // ❌ ANTES (com bug)
221
- [código com problema]
222
-
223
- // ✅ DEPOIS (corrigido)
224
- [código corrigido]
225
- ```
226
-
227
- **Explicação da correção:**
228
- [Por que isso resolve o problema]
229
-
230
- ---
231
-
232
- ## Testes de Regressão
233
-
234
- Para garantir que o fix funciona E não quebra nada:
235
-
236
- ### 1. Teste Unitário (Novo)
237
-
238
- ```[linguagem]
239
- describe('[NomeDaFuncao]', () => {
240
- it('should [comportamento esperado]', () => {
241
- // Arrange
242
- [setup]
243
-
244
- // Act
245
- [execução]
246
-
247
- // Assert
248
- [validação]
249
- });
250
-
251
- it('should not [regressão possível]', () => {
252
- // Testa efeito colateral
253
- });
254
- });
255
- ```
256
-
257
- ### 2. Teste de Integração
258
-
259
- [Cenário E2E que valida o fix]
260
-
261
- ### 3. Validação Manual
262
-
263
- Passos para testar manualmente:
264
- 1. [Passo 1]
265
- 2. [Passo 2]
266
- 3. ✅ [Resultado esperado]
267
-
268
- ---
269
-
270
- Implementar correção e rodar testes? (S/N)
271
- ```
272
-
273
- ---
274
-
275
- ### Passo 6: Fase 4 - Deploy
276
-
277
- **Coordenar com `/deploy`:**
278
-
279
- ```markdown
280
- 🎯 **Fase 4/4: Deploy**
281
-
282
- ## Estratégia de Deploy
283
-
284
- **Severidade: [critica/alta/media/baixa]**
285
-
286
- ### Se Crítica:
287
- - 🚨 Hotfix imediato
288
- - Deploy direto em prod após validação em staging
289
- - Rollback plan pronto
290
-
291
- ### Se Alta:
292
- - Deploy em staging → validação → prod
293
- - Comunicar stakeholders
294
-
295
- ### Se Média/Baixa:
296
- - Incluir no próximo release
297
- - Documentar no CHANGELOG
298
-
299
- ---
300
-
301
- **Checklist Pré-Deploy:**
302
- - [ ] Fix implementado
303
- - [ ] Testes unitários passando
304
- - [ ] Testes de regressão passando
305
- - [ ] Code review aprovado
306
- - [ ] Validado em staging
307
-
308
- Executar deploy? Use `/deploy [ambiente]`
309
- ```
310
-
311
- ---
312
-
313
- ## Exemplos de Uso
314
-
315
- ### Exemplo 1: Bug Crítico (Duplicação de Pedido)
316
-
317
- ```
318
- User: /mcp-debug
319
-
320
- AI: Descreva o bug:
321
-
322
- User: Pedido duplicado ao clicar rapidamente no botão Finalizar
323
-
324
- AI: Severidade?
325
-
326
- User: critica
327
-
328
- AI: ✅ Fluxo iniciado (BUG-001) - Severidade CRÍTICA
329
-
330
- 🎯 Fase 1: Reprodução
331
-
332
- Vamos reproduzir de forma controlada:
333
- 1. Criar pedido
334
- 2. Clicar rapidamente 2x em "Finalizar"
335
- 3. Verificar banco de dados
336
-
337
- Reproduzido ✅
338
-
339
- [Avança para Fase 2]
340
-
341
- 🎯 Fase 2: Análise de Causa Raiz
342
-
343
- Hipóteses:
344
- 1. ❓ Falta de debounce no botão (MAIS PROVÁVEL)
345
- 2. ❓ Falta de idempotência no endpoint
346
- 3. ❓ Race condition no banco
347
-
348
- Analisando código de `CheckoutButton.tsx`...
349
-
350
- 🎯 Causa Raiz: Botão sem debounce + endpoint não idempotente
351
-
352
- [Avança para Fase 3]
353
-
354
- 🎯 Fase 3: Fix
355
-
356
- ```typescript
357
- // ❌ ANTES
358
- <button onClick={handleCheckout}>Finalizar</button>
359
-
360
- // ✅ DEPOIS
361
- <button
362
- onClick={debounce(handleCheckout, 300)}
363
- disabled={isProcessing}
364
- >
365
- Finalizar
366
- </button>
367
- ```
368
-
369
- + Adicionar idempotency key no backend
370
-
371
- Testes criados ✅
372
-
373
- [Avança para Fase 4]
374
-
375
- 🎯 Fase 4: Deploy
376
-
377
- Severidade CRÍTICA → Hotfix imediato
378
-
379
- Use: /deploy production --hotfix
380
- ```
381
-
382
- ### Exemplo 2: Bug de UI (Baixa Severidade)
383
-
384
- ```
385
- User: /mcp-debug Botão de logout desalinhado no mobile
386
-
387
- AI: Severidade?
388
-
389
- User: baixa
390
-
391
- AI: ✅ Fluxo iniciado (BUG-002) - Severidade BAIXA
392
-
393
- Bug cosmético. Incluir no próximo release.
394
-
395
- Fase 1: Reprodução ✅
396
- Fase 2: CSS incorreto identificado
397
- Fase 3: Fix aplicado
398
- Fase 4: Agendar para próximo deploy
399
- ```
400
-
401
- ---
402
-
403
- ## Comandos Relacionados
404
-
405
- ```
406
- /mcp-debug [descrição] → Inicia fluxo de debugging
407
- /mcp-next → Avança entre fases
408
- /deploy --hotfix → Deploy emergencial (bugs críticos)
409
- ```
410
-
411
- ---
412
-
413
- ## Estrutura de Arquivos Gerados
414
-
415
- ```
416
- docs/
417
- ├── bugs/
418
- │ └── BUG-001-pedido-duplicado/
419
- │ ├── 01-reproducao.md
420
- │ ├── 02-causa-raiz.md
421
- │ ├── 03-fix-e-testes.md
422
- │ └── 04-deploy-log.md
423
- ```
424
-
425
- ---
426
-
427
- ## Regras Críticas (Root Cause Analysis)
428
-
429
- ### ✅ SEMPRE:
430
-
431
- 1. Reproduzir bug ANTES de tentar corrigir
432
- 2. Fazer análise de causa raiz (não apenas sintomas)
433
- 3. Adicionar testes que capturam o bug
434
- 4. Validar em staging antes de prod (exceto hotfixes)
435
- 5. Documentar causa raiz para aprendizado
436
-
437
- ### ❌ NUNCA:
438
-
439
- 1. "Corrigir" sem entender a causa
440
- 2. Deploy de fix crítico sem testes
441
- 3. Assumir causa raiz sem evidências
442
- 4. Esquecer de testar efeitos colaterais
443
- 5. Deixar bug sem teste de regressão
444
-
445
- ---
446
-
447
- ## Matriz de Severidade → Ação
448
-
449
- | Severidade | SLA | Deploy | Comunicação |
450
- |------------|-----|--------|-------------|
451
- | **Crítica** | 1h | Hotfix imediato | Stakeholders + usuários |
452
- | **Alta** | 4h | Próximo deploy | Stakeholders |
453
- | **Média** | 1-2 dias | Release agendado | Interno |
454
- | **Baixa** | 1 semana | Quando conveniente | Changelog |
455
-
456
- ---
457
-
458
- ## Protocolo de Hotfix (Bugs Críticos)
459
-
460
- ```
461
- 1. Criar branch: hotfix/BUG-001-pedido-duplicado
462
- 2. Fix + testes
463
- 3. Deploy staging → validar
464
- 4. Deploy prod
465
- 5. Merge back to main
466
- 6. Post-mortem (se necessário)
467
- ```
468
-
469
- ---
470
-
471
- ## Troubleshooting
472
-
473
- ### Não Consigo Reproduzir
474
-
475
- **Ação:**
476
-
477
- ```markdown
478
- Se não conseguiu reproduzir:
479
-
480
- 1. **Coletar mais informações**
481
- - Logs mais detalhados
482
- - Request/Response headers
483
- - Estado do banco no momento
484
-
485
- 2. **Testar em ambiente idêntico**
486
- - Mesma versão
487
- - Mesmos dados
488
- - Mesmo browser/device
489
-
490
- 3. **Race condition?**
491
- - Tentar com diferentes timings
492
- - Usar ferramentas de slow-motion (Network throttling)
493
- ```
494
-
495
- ### Múltiplas Causas Possíveis
496
-
497
- **Ação:**
498
-
499
- ```markdown
500
- Se várias hipóteses igualmente prováveis:
501
-
502
- 1. Testar todas sistematicamente
503
- 2. Usar método de bisseção (git bisect)
504
- 3. Adicionar logs temporários
505
- 4. Pair programming com colega
506
- ```
1
+ ---
2
+ description: Correção de bugs com fluxo estruturado (Reprodução → Análise → Fix → Regressão)
3
+ ---
4
+
5
+ # /mcp-debug - Correção de Bug MCP
6
+
7
+ $ARGUMENTS
8
+
9
+ ---
10
+
11
+ ## Objetivo
12
+
13
+ Corrigir bugs de forma estruturada usando fluxo de 4 fases do MCP Maestro, com análise de causa raiz e testes de regressão.
14
+
15
+ ---
16
+
17
+ ## Quando Usar
18
+
19
+ - Bug reportado em produção ou desenvolvimento
20
+ - Comportamento inesperado que precisa investigação
21
+ - Erro que requer análise sistemática
22
+
23
+ **NÃO usar para:**
24
+ - Nova funcionalidade → Use `/mcp-feature`
25
+ - Refatoração de código → Use `/mcp-refactor`
26
+
27
+ ---
28
+
29
+ ## Fluxo de 4 Fases
30
+
31
+ ```
32
+ 1. Reprodução do Bug
33
+
34
+ 2. Análise de Causa Raiz
35
+
36
+ 3. Fix + Testes de Regressão
37
+
38
+ 4. Deploy
39
+ ```
40
+
41
+ ---
42
+
43
+ ## Execução
44
+
45
+ ### Passo 1: Coleta de Informações
46
+
47
+ **Perguntar ao usuário:**
48
+
49
+ ```markdown
50
+ 🐛 **Correção de Bug**
51
+
52
+ 1. Descreva o bug:
53
+ [Exemplo: Pedido duplicado ao clicar rapidamente no botão "Finalizar"]
54
+
55
+ 2. Severidade do bug:
56
+ - **critica**: Sistema inoperante, perda de dados
57
+ - **alta**: Feature principal não funciona
58
+ - **media**: Feature secundária afetada
59
+ - **baixa**: Cosmético, sem impacto funcional
60
+
61
+ Escolha: [critica/alta/media/baixa]
62
+
63
+ 3. (Opcional) Como reproduzir:
64
+ [Passos para reproduzir o bug]
65
+
66
+ 4. (Opcional) Stack trace ou logs:
67
+ [Cole aqui se disponível]
68
+ ```
69
+
70
+ ---
71
+
72
+ ### Passo 2: Iniciar Fluxo de Debugging
73
+
74
+ ```typescript
75
+ await mcp_maestro_corrigir_bug({
76
+ descricao: "[descrição fornecida]",
77
+ severidade: "[critica/alta/media/baixa]",
78
+ ticket_id: "[opcional: JIRA-123]"
79
+ });
80
+ ```
81
+
82
+ **MCP cria contexto de bug e retorna:**
83
+
84
+ ```json
85
+ {
86
+ "bug_id": "BUG-001",
87
+ "fases": [
88
+ "Reprodução",
89
+ "Análise de Causa Raiz",
90
+ "Fix + Regressão",
91
+ "Deploy"
92
+ ],
93
+ "fase_atual": 1,
94
+ "prioridade": "[baseada na severidade]"
95
+ }
96
+ ```
97
+
98
+ ---
99
+
100
+ ### Passo 3: Fase 1 - Reprodução do Bug
101
+
102
+ **Apresentar:**
103
+
104
+ ```markdown
105
+ ✅ **Fluxo de Debugging Iniciado** (BUG-001)
106
+ 🚨 **Severidade:** [critica/alta/media/baixa]
107
+
108
+ ---
109
+
110
+ 🎯 **Fase 1/4: Reprodução do Bug**
111
+ 🤖 **Especialista:** Debugging e Troubleshooting
112
+
113
+ ## Reprodução Sistemática
114
+
115
+ Vamos reproduzir o bug de forma controlada:
116
+
117
+ 1. **Ambiente**
118
+ - Onde ocorre: [dev/staging/prod]
119
+ - Versão: [commit/tag]
120
+ - Browser/Device: [se aplicável]
121
+
122
+ 2. **Passos para Reproduzir**
123
+ 1. [Passo 1]
124
+ 2. [Passo 2]
125
+ 3. [Passo 3]
126
+
127
+ 3. **Comportamento Esperado**
128
+ - [O que deveria acontecer]
129
+
130
+ 4. **Comportamento Atual**
131
+ - [O que está acontecendo]
132
+
133
+ 5. **Evidências**
134
+ - Screenshots: [urls se disponível]
135
+ - Logs: [trechos relevantes]
136
+ - Network: [requests falhando]
137
+
138
+ Conseguiu reproduzir o bug? (S/N)
139
+ ```
140
+
141
+ ---
142
+
143
+ ### Passo 4: Fase 2 - Análise de Causa Raiz
144
+
145
+ **Carregar especialista de Debugging:**
146
+
147
+ ```typescript
148
+ const especialista = await fetch('maestro://especialista/debugging-troubleshooting');
149
+ ```
150
+
151
+ **Apresentar:**
152
+
153
+ ```markdown
154
+ 🎯 **Fase 2/4: Análise de Causa Raiz**
155
+
156
+ ## Investigação Sistemática
157
+
158
+ ### Hipóteses Possíveis
159
+
160
+ Baseado nos sintomas, lista de causas prováveis:
161
+
162
+ 1. ❓ **[Hipótese 1 - Mais provável]**
163
+ - Evidência: [log/código que apoia]
164
+ - Como testar: [validação]
165
+
166
+ 2. ❓ **[Hipótese 2]**
167
+ - Evidência: [...]
168
+ - Como testar: [...]
169
+
170
+ 3. ❓ **[Hipótese 3 - Menos provável]**
171
+ - Evidência: [...]
172
+ - Como testar: [...]
173
+
174
+ ### Análise de Código
175
+
176
+ Arquivos suspeitos:
177
+ - `[arquivo1.ts]` - [motivo]
178
+ - `[arquivo2.ts]` - [motivo]
179
+
180
+ Vamos investigar a hipótese 1. [Análise detalhada do código]
181
+ ```
182
+
183
+ **Processo de eliminação:**
184
+
185
+ ```markdown
186
+ **Testando Hipótese 1:** [descrição]
187
+
188
+ [Análise do código/logs]
189
+
190
+ **Resultado:** ✅ Confirmada / ❌ Descartada
191
+
192
+ ---
193
+
194
+ 🎯 **Causa Raiz Identificada:**
195
+
196
+ [Explicação detalhada do problema]
197
+
198
+ **Por que aconteceu:**
199
+ - [Motivo 1]
200
+ - [Motivo 2]
201
+
202
+ **Onde está o bug:**
203
+ - Arquivo: `[caminho/arquivo.ts]`
204
+ - Linha: [numero]
205
+ - Função: `[nomeFuncao]`
206
+ ```
207
+
208
+ ---
209
+
210
+ ### Passo 5: Fase 3 - Fix + Testes de Regressão
211
+
212
+ **Apresentar:**
213
+
214
+ ```markdown
215
+ 🎯 **Fase 3/4: Fix + Testes de Regressão**
216
+
217
+ ## Correção Proposta
218
+
219
+ ```[linguagem]
220
+ // ❌ ANTES (com bug)
221
+ [código com problema]
222
+
223
+ // ✅ DEPOIS (corrigido)
224
+ [código corrigido]
225
+ ```
226
+
227
+ **Explicação da correção:**
228
+ [Por que isso resolve o problema]
229
+
230
+ ---
231
+
232
+ ## Testes de Regressão
233
+
234
+ Para garantir que o fix funciona E não quebra nada:
235
+
236
+ ### 1. Teste Unitário (Novo)
237
+
238
+ ```[linguagem]
239
+ describe('[NomeDaFuncao]', () => {
240
+ it('should [comportamento esperado]', () => {
241
+ // Arrange
242
+ [setup]
243
+
244
+ // Act
245
+ [execução]
246
+
247
+ // Assert
248
+ [validação]
249
+ });
250
+
251
+ it('should not [regressão possível]', () => {
252
+ // Testa efeito colateral
253
+ });
254
+ });
255
+ ```
256
+
257
+ ### 2. Teste de Integração
258
+
259
+ [Cenário E2E que valida o fix]
260
+
261
+ ### 3. Validação Manual
262
+
263
+ Passos para testar manualmente:
264
+ 1. [Passo 1]
265
+ 2. [Passo 2]
266
+ 3. ✅ [Resultado esperado]
267
+
268
+ ---
269
+
270
+ Implementar correção e rodar testes? (S/N)
271
+ ```
272
+
273
+ ---
274
+
275
+ ### Passo 6: Fase 4 - Deploy
276
+
277
+ **Coordenar com `/deploy`:**
278
+
279
+ ```markdown
280
+ 🎯 **Fase 4/4: Deploy**
281
+
282
+ ## Estratégia de Deploy
283
+
284
+ **Severidade: [critica/alta/media/baixa]**
285
+
286
+ ### Se Crítica:
287
+ - 🚨 Hotfix imediato
288
+ - Deploy direto em prod após validação em staging
289
+ - Rollback plan pronto
290
+
291
+ ### Se Alta:
292
+ - Deploy em staging → validação → prod
293
+ - Comunicar stakeholders
294
+
295
+ ### Se Média/Baixa:
296
+ - Incluir no próximo release
297
+ - Documentar no CHANGELOG
298
+
299
+ ---
300
+
301
+ **Checklist Pré-Deploy:**
302
+ - [ ] Fix implementado
303
+ - [ ] Testes unitários passando
304
+ - [ ] Testes de regressão passando
305
+ - [ ] Code review aprovado
306
+ - [ ] Validado em staging
307
+
308
+ Executar deploy? Use `/deploy [ambiente]`
309
+ ```
310
+
311
+ ---
312
+
313
+ ## Exemplos de Uso
314
+
315
+ ### Exemplo 1: Bug Crítico (Duplicação de Pedido)
316
+
317
+ ```
318
+ User: /mcp-debug
319
+
320
+ AI: Descreva o bug:
321
+
322
+ User: Pedido duplicado ao clicar rapidamente no botão Finalizar
323
+
324
+ AI: Severidade?
325
+
326
+ User: critica
327
+
328
+ AI: ✅ Fluxo iniciado (BUG-001) - Severidade CRÍTICA
329
+
330
+ 🎯 Fase 1: Reprodução
331
+
332
+ Vamos reproduzir de forma controlada:
333
+ 1. Criar pedido
334
+ 2. Clicar rapidamente 2x em "Finalizar"
335
+ 3. Verificar banco de dados
336
+
337
+ Reproduzido ✅
338
+
339
+ [Avança para Fase 2]
340
+
341
+ 🎯 Fase 2: Análise de Causa Raiz
342
+
343
+ Hipóteses:
344
+ 1. ❓ Falta de debounce no botão (MAIS PROVÁVEL)
345
+ 2. ❓ Falta de idempotência no endpoint
346
+ 3. ❓ Race condition no banco
347
+
348
+ Analisando código de `CheckoutButton.tsx`...
349
+
350
+ 🎯 Causa Raiz: Botão sem debounce + endpoint não idempotente
351
+
352
+ [Avança para Fase 3]
353
+
354
+ 🎯 Fase 3: Fix
355
+
356
+ ```typescript
357
+ // ❌ ANTES
358
+ <button onClick={handleCheckout}>Finalizar</button>
359
+
360
+ // ✅ DEPOIS
361
+ <button
362
+ onClick={debounce(handleCheckout, 300)}
363
+ disabled={isProcessing}
364
+ >
365
+ Finalizar
366
+ </button>
367
+ ```
368
+
369
+ + Adicionar idempotency key no backend
370
+
371
+ Testes criados ✅
372
+
373
+ [Avança para Fase 4]
374
+
375
+ 🎯 Fase 4: Deploy
376
+
377
+ Severidade CRÍTICA → Hotfix imediato
378
+
379
+ Use: /deploy production --hotfix
380
+ ```
381
+
382
+ ### Exemplo 2: Bug de UI (Baixa Severidade)
383
+
384
+ ```
385
+ User: /mcp-debug Botão de logout desalinhado no mobile
386
+
387
+ AI: Severidade?
388
+
389
+ User: baixa
390
+
391
+ AI: ✅ Fluxo iniciado (BUG-002) - Severidade BAIXA
392
+
393
+ Bug cosmético. Incluir no próximo release.
394
+
395
+ Fase 1: Reprodução ✅
396
+ Fase 2: CSS incorreto identificado
397
+ Fase 3: Fix aplicado
398
+ Fase 4: Agendar para próximo deploy
399
+ ```
400
+
401
+ ---
402
+
403
+ ## Comandos Relacionados
404
+
405
+ ```
406
+ /mcp-debug [descrição] → Inicia fluxo de debugging
407
+ /mcp-next → Avança entre fases
408
+ /deploy --hotfix → Deploy emergencial (bugs críticos)
409
+ ```
410
+
411
+ ---
412
+
413
+ ## Estrutura de Arquivos Gerados
414
+
415
+ ```
416
+ docs/
417
+ ├── bugs/
418
+ │ └── BUG-001-pedido-duplicado/
419
+ │ ├── 01-reproducao.md
420
+ │ ├── 02-causa-raiz.md
421
+ │ ├── 03-fix-e-testes.md
422
+ │ └── 04-deploy-log.md
423
+ ```
424
+
425
+ ---
426
+
427
+ ## Regras Críticas (Root Cause Analysis)
428
+
429
+ ### ✅ SEMPRE:
430
+
431
+ 1. Reproduzir bug ANTES de tentar corrigir
432
+ 2. Fazer análise de causa raiz (não apenas sintomas)
433
+ 3. Adicionar testes que capturam o bug
434
+ 4. Validar em staging antes de prod (exceto hotfixes)
435
+ 5. Documentar causa raiz para aprendizado
436
+
437
+ ### ❌ NUNCA:
438
+
439
+ 1. "Corrigir" sem entender a causa
440
+ 2. Deploy de fix crítico sem testes
441
+ 3. Assumir causa raiz sem evidências
442
+ 4. Esquecer de testar efeitos colaterais
443
+ 5. Deixar bug sem teste de regressão
444
+
445
+ ---
446
+
447
+ ## Matriz de Severidade → Ação
448
+
449
+ | Severidade | SLA | Deploy | Comunicação |
450
+ |------------|-----|--------|-------------|
451
+ | **Crítica** | 1h | Hotfix imediato | Stakeholders + usuários |
452
+ | **Alta** | 4h | Próximo deploy | Stakeholders |
453
+ | **Média** | 1-2 dias | Release agendado | Interno |
454
+ | **Baixa** | 1 semana | Quando conveniente | Changelog |
455
+
456
+ ---
457
+
458
+ ## Protocolo de Hotfix (Bugs Críticos)
459
+
460
+ ```
461
+ 1. Criar branch: hotfix/BUG-001-pedido-duplicado
462
+ 2. Fix + testes
463
+ 3. Deploy staging → validar
464
+ 4. Deploy prod
465
+ 5. Merge back to main
466
+ 6. Post-mortem (se necessário)
467
+ ```
468
+
469
+ ---
470
+
471
+ ## Troubleshooting
472
+
473
+ ### Não Consigo Reproduzir
474
+
475
+ **Ação:**
476
+
477
+ ```markdown
478
+ Se não conseguiu reproduzir:
479
+
480
+ 1. **Coletar mais informações**
481
+ - Logs mais detalhados
482
+ - Request/Response headers
483
+ - Estado do banco no momento
484
+
485
+ 2. **Testar em ambiente idêntico**
486
+ - Mesma versão
487
+ - Mesmos dados
488
+ - Mesmo browser/device
489
+
490
+ 3. **Race condition?**
491
+ - Tentar com diferentes timings
492
+ - Usar ferramentas de slow-motion (Network throttling)
493
+ ```
494
+
495
+ ### Múltiplas Causas Possíveis
496
+
497
+ **Ação:**
498
+
499
+ ```markdown
500
+ Se várias hipóteses igualmente prováveis:
501
+
502
+ 1. Testar todas sistematicamente
503
+ 2. Usar método de bisseção (git bisect)
504
+ 3. Adicionar logs temporários
505
+ 4. Pair programming com colega
506
+ ```