@ggailabs/cli-context 0.5.6 → 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 (298) hide show
  1. package/README.md +25 -181
  2. package/dist/.context/docs/GENESIS_SYSTEM_PROMPT.md +61 -0
  3. package/dist/.context/eng/agents/architect.md +68 -0
  4. package/dist/.context/eng/agents/backend_typescript.md +1000 -0
  5. package/dist/.context/eng/agents/bug_hunter.md +49 -0
  6. package/dist/.context/eng/agents/code_archaeologist.md +83 -0
  7. package/dist/.context/eng/agents/code_reviewer.md +90 -0
  8. package/dist/.context/eng/agents/devops_specialist.md +718 -0
  9. package/dist/.context/eng/agents/frontend_specialist.md +1027 -0
  10. package/dist/.context/eng/agents/orchestrator.md +89 -0
  11. package/dist/.context/eng/agents/penetration_tester.md +59 -0
  12. package/dist/.context/eng/agents/qa_specialist.md +1234 -0
  13. package/dist/.context/eng/agents/security_reviewer.md +92 -0
  14. package/dist/.context/eng/agents/ui_specialist.md +16 -0
  15. package/dist/.context/eng/docs/AGENT_HANDOFF_PROMPT.md +44 -0
  16. package/dist/.context/eng/docs/GENESIS_DESIGN_SYSTEM.md +88 -0
  17. package/dist/.context/eng/docs/GG_METHODOLOGY.md +48 -0
  18. package/dist/.context/eng/docs/OPERATIONS_LOG.md +31 -0
  19. package/dist/.context/eng/docs/PROJECT_MAP.md +35 -0
  20. package/dist/.context/eng/docs/standards/devops.md +0 -0
  21. package/dist/.context/eng/docs/standards/frontend.md +0 -0
  22. package/dist/.context/eng/docs/standards/typescript.md +12 -0
  23. package/dist/.context/eng/skills/agent_logging/SKILL.md +22 -0
  24. package/dist/.context/eng/skills/brainstorming/SKILL.md +51 -0
  25. package/dist/.context/eng/skills/documentation_templates/SKILL.md +73 -0
  26. package/dist/.context/eng/skills/exploring_codebase/SKILL.md +52 -0
  27. package/dist/.context/eng/skills/mcp_builder/SKILL.md +64 -0
  28. package/dist/.context/eng/skills/patterns/compliance_check/SKILL.md +37 -0
  29. package/dist/.context/eng/skills/patterns/coverage_table/SKILL.md +57 -0
  30. package/dist/.context/eng/skills/patterns/exit_criteria/SKILL.md +35 -0
  31. package/dist/.context/eng/skills/patterns/failure_recovery/SKILL.md +78 -0
  32. package/dist/.context/eng/skills/patterns/quality_gate/SKILL.md +43 -0
  33. package/dist/.context/eng/skills/patterns/standards_workflow/SKILL.md +395 -0
  34. package/dist/.context/eng/skills/patterns/state_tracking/SKILL.md +34 -0
  35. package/dist/.context/eng/skills/patterns/task_tracking/SKILL.md +42 -0
  36. package/dist/.context/eng/skills/performance_profiling/SKILL.md +60 -0
  37. package/dist/.context/eng/skills/previce/SKILL.md +49 -0
  38. package/dist/.context/eng/skills/tdd/SKILL.md +59 -0
  39. package/dist/.context/eng/skills/using_git_worktrees/SKILL.md +45 -0
  40. package/dist/.context/eng/skills/vulnerability_scanner/SKILL.md +78 -0
  41. package/dist/.context/eng/skills/writing_plans/SKILL.md +85 -0
  42. package/dist/.context/plans/.gitkeep +0 -0
  43. package/dist/.context/pt-br/agents/architect.md +68 -0
  44. package/dist/.context/pt-br/agents/backend_typescript.md +1002 -0
  45. package/dist/.context/pt-br/agents/bug_hunter.md +49 -0
  46. package/dist/.context/pt-br/agents/code_archaeologist.md +82 -0
  47. package/dist/.context/pt-br/agents/code_reviewer.md +88 -0
  48. package/dist/.context/pt-br/agents/devops_specialist.md +718 -0
  49. package/dist/.context/pt-br/agents/frontend_specialist.md +1029 -0
  50. package/dist/.context/pt-br/agents/orchestrator.md +87 -0
  51. package/dist/.context/pt-br/agents/penetration_tester.md +59 -0
  52. package/dist/.context/pt-br/agents/qa_specialist.md +1234 -0
  53. package/dist/.context/pt-br/agents/security_reviewer.md +92 -0
  54. package/dist/.context/pt-br/agents/ui_specialist.md +55 -0
  55. package/dist/.context/pt-br/docs/AGENT_HANDOFF_PROMPT.md +44 -0
  56. package/dist/.context/pt-br/docs/GENESIS_DESIGN_SYSTEM.md +88 -0
  57. package/dist/.context/pt-br/docs/GG_METHODOLOGY.md +48 -0
  58. package/dist/.context/pt-br/docs/OPERATIONS_LOG.md +31 -0
  59. package/dist/.context/pt-br/docs/PROJECT_MAP.md +37 -0
  60. package/dist/.context/pt-br/docs/standards/devops.md +707 -0
  61. package/dist/.context/pt-br/docs/standards/frontend.md +748 -0
  62. package/dist/.context/pt-br/docs/standards/typescript.md +1150 -0
  63. package/dist/.context/pt-br/skills/agent_logging/SKILL.md +40 -0
  64. package/dist/.context/pt-br/skills/brainstorming/SKILL.md +51 -0
  65. package/dist/.context/pt-br/skills/documentation_templates/SKILL.md +73 -0
  66. package/dist/.context/pt-br/skills/exploring_codebase/SKILL.md +52 -0
  67. package/dist/.context/pt-br/skills/mcp_builder/SKILL.md +64 -0
  68. package/dist/.context/pt-br/skills/patterns/compliance_check/SKILL.md +37 -0
  69. package/dist/.context/pt-br/skills/patterns/coverage_table/SKILL.md +57 -0
  70. package/dist/.context/pt-br/skills/patterns/exit_criteria/SKILL.md +38 -0
  71. package/dist/.context/pt-br/skills/patterns/failure_recovery/SKILL.md +30 -0
  72. package/dist/.context/pt-br/skills/patterns/quality_gate/SKILL.md +43 -0
  73. package/dist/.context/pt-br/skills/patterns/standards_workflow/SKILL.md +45 -0
  74. package/dist/.context/pt-br/skills/patterns/state_tracking/SKILL.md +31 -0
  75. package/dist/.context/pt-br/skills/patterns/task_tracking/SKILL.md +27 -0
  76. package/dist/.context/pt-br/skills/performance_profiling/SKILL.md +60 -0
  77. package/dist/.context/pt-br/skills/previce/SKILL.md +51 -0
  78. package/dist/.context/pt-br/skills/tdd/SKILL.md +59 -0
  79. package/dist/.context/pt-br/skills/using_git_worktrees/SKILL.md +45 -0
  80. package/dist/.context/pt-br/skills/vulnerability_scanner/SKILL.md +78 -0
  81. package/dist/.context/pt-br/skills/writing_plans/SKILL.md +85 -0
  82. package/dist/.context/workflow/.gitkeep +0 -0
  83. package/dist/commands/init.js +159 -0
  84. package/dist/commands/monitor.js +34 -0
  85. package/dist/index.js +20 -568
  86. package/dist/services/monitor-service.js +342 -0
  87. package/dist/services/scaffolder.js +177 -0
  88. package/package.json +16 -58
  89. package/LICENSE +0 -21
  90. package/dist/generators/agents/agentConfig.d.ts +0 -4
  91. package/dist/generators/agents/agentConfig.d.ts.map +0 -1
  92. package/dist/generators/agents/agentConfig.js +0 -180
  93. package/dist/generators/agents/agentConfig.js.map +0 -1
  94. package/dist/generators/agents/agentGenerator.d.ts +0 -9
  95. package/dist/generators/agents/agentGenerator.d.ts.map +0 -1
  96. package/dist/generators/agents/agentGenerator.js +0 -97
  97. package/dist/generators/agents/agentGenerator.js.map +0 -1
  98. package/dist/generators/agents/agentTypes.d.ts +0 -4
  99. package/dist/generators/agents/agentTypes.d.ts.map +0 -1
  100. package/dist/generators/agents/agentTypes.js +0 -25
  101. package/dist/generators/agents/agentTypes.js.map +0 -1
  102. package/dist/generators/agents/index.d.ts +0 -4
  103. package/dist/generators/agents/index.d.ts.map +0 -1
  104. package/dist/generators/agents/index.js +0 -12
  105. package/dist/generators/agents/index.js.map +0 -1
  106. package/dist/generators/agents/templates/index.d.ts +0 -4
  107. package/dist/generators/agents/templates/index.d.ts.map +0 -1
  108. package/dist/generators/agents/templates/index.js +0 -8
  109. package/dist/generators/agents/templates/index.js.map +0 -1
  110. package/dist/generators/agents/templates/indexTemplate.d.ts +0 -3
  111. package/dist/generators/agents/templates/indexTemplate.d.ts.map +0 -1
  112. package/dist/generators/agents/templates/indexTemplate.js +0 -36
  113. package/dist/generators/agents/templates/indexTemplate.js.map +0 -1
  114. package/dist/generators/agents/templates/playbookTemplate.d.ts +0 -4
  115. package/dist/generators/agents/templates/playbookTemplate.d.ts.map +0 -1
  116. package/dist/generators/agents/templates/playbookTemplate.js +0 -99
  117. package/dist/generators/agents/templates/playbookTemplate.js.map +0 -1
  118. package/dist/generators/agents/templates/types.d.ts +0 -14
  119. package/dist/generators/agents/templates/types.d.ts.map +0 -1
  120. package/dist/generators/agents/templates/types.js +0 -3
  121. package/dist/generators/agents/templates/types.js.map +0 -1
  122. package/dist/generators/documentation/documentationGenerator.d.ts +0 -15
  123. package/dist/generators/documentation/documentationGenerator.d.ts.map +0 -1
  124. package/dist/generators/documentation/documentationGenerator.js +0 -188
  125. package/dist/generators/documentation/documentationGenerator.js.map +0 -1
  126. package/dist/generators/documentation/guideRegistry.d.ts +0 -6
  127. package/dist/generators/documentation/guideRegistry.d.ts.map +0 -1
  128. package/dist/generators/documentation/guideRegistry.js +0 -82
  129. package/dist/generators/documentation/guideRegistry.js.map +0 -1
  130. package/dist/generators/documentation/index.d.ts +0 -2
  131. package/dist/generators/documentation/index.d.ts.map +0 -1
  132. package/dist/generators/documentation/index.js +0 -6
  133. package/dist/generators/documentation/index.js.map +0 -1
  134. package/dist/generators/documentation/templates/apiReferenceTemplate.d.ts +0 -2
  135. package/dist/generators/documentation/templates/apiReferenceTemplate.d.ts.map +0 -1
  136. package/dist/generators/documentation/templates/apiReferenceTemplate.js +0 -490
  137. package/dist/generators/documentation/templates/apiReferenceTemplate.js.map +0 -1
  138. package/dist/generators/documentation/templates/architectureTemplate.d.ts +0 -3
  139. package/dist/generators/documentation/templates/architectureTemplate.d.ts.map +0 -1
  140. package/dist/generators/documentation/templates/architectureTemplate.js +0 -66
  141. package/dist/generators/documentation/templates/architectureTemplate.js.map +0 -1
  142. package/dist/generators/documentation/templates/common.d.ts +0 -7
  143. package/dist/generators/documentation/templates/common.d.ts.map +0 -1
  144. package/dist/generators/documentation/templates/common.js +0 -58
  145. package/dist/generators/documentation/templates/common.js.map +0 -1
  146. package/dist/generators/documentation/templates/dataFlowTemplate.d.ts +0 -3
  147. package/dist/generators/documentation/templates/dataFlowTemplate.d.ts.map +0 -1
  148. package/dist/generators/documentation/templates/dataFlowTemplate.js +0 -40
  149. package/dist/generators/documentation/templates/dataFlowTemplate.js.map +0 -1
  150. package/dist/generators/documentation/templates/developmentWorkflowTemplate.d.ts +0 -2
  151. package/dist/generators/documentation/templates/developmentWorkflowTemplate.d.ts.map +0 -1
  152. package/dist/generators/documentation/templates/developmentWorkflowTemplate.js +0 -44
  153. package/dist/generators/documentation/templates/developmentWorkflowTemplate.js.map +0 -1
  154. package/dist/generators/documentation/templates/glossaryTemplate.d.ts +0 -3
  155. package/dist/generators/documentation/templates/glossaryTemplate.d.ts.map +0 -1
  156. package/dist/generators/documentation/templates/glossaryTemplate.js +0 -41
  157. package/dist/generators/documentation/templates/glossaryTemplate.js.map +0 -1
  158. package/dist/generators/documentation/templates/index.d.ts +0 -15
  159. package/dist/generators/documentation/templates/index.d.ts.map +0 -1
  160. package/dist/generators/documentation/templates/index.js +0 -30
  161. package/dist/generators/documentation/templates/index.js.map +0 -1
  162. package/dist/generators/documentation/templates/indexTemplate.d.ts +0 -3
  163. package/dist/generators/documentation/templates/indexTemplate.d.ts.map +0 -1
  164. package/dist/generators/documentation/templates/indexTemplate.js +0 -42
  165. package/dist/generators/documentation/templates/indexTemplate.js.map +0 -1
  166. package/dist/generators/documentation/templates/migrationTemplate.d.ts +0 -2
  167. package/dist/generators/documentation/templates/migrationTemplate.d.ts.map +0 -1
  168. package/dist/generators/documentation/templates/migrationTemplate.js +0 -422
  169. package/dist/generators/documentation/templates/migrationTemplate.js.map +0 -1
  170. package/dist/generators/documentation/templates/onboardingTemplate.d.ts +0 -2
  171. package/dist/generators/documentation/templates/onboardingTemplate.d.ts.map +0 -1
  172. package/dist/generators/documentation/templates/onboardingTemplate.js +0 -431
  173. package/dist/generators/documentation/templates/onboardingTemplate.js.map +0 -1
  174. package/dist/generators/documentation/templates/projectOverviewTemplate.d.ts +0 -3
  175. package/dist/generators/documentation/templates/projectOverviewTemplate.d.ts.map +0 -1
  176. package/dist/generators/documentation/templates/projectOverviewTemplate.js +0 -65
  177. package/dist/generators/documentation/templates/projectOverviewTemplate.js.map +0 -1
  178. package/dist/generators/documentation/templates/securityTemplate.d.ts +0 -2
  179. package/dist/generators/documentation/templates/securityTemplate.d.ts.map +0 -1
  180. package/dist/generators/documentation/templates/securityTemplate.js +0 -39
  181. package/dist/generators/documentation/templates/securityTemplate.js.map +0 -1
  182. package/dist/generators/documentation/templates/testingTemplate.d.ts +0 -2
  183. package/dist/generators/documentation/templates/testingTemplate.d.ts.map +0 -1
  184. package/dist/generators/documentation/templates/testingTemplate.js +0 -45
  185. package/dist/generators/documentation/templates/testingTemplate.js.map +0 -1
  186. package/dist/generators/documentation/templates/toolingTemplate.d.ts +0 -2
  187. package/dist/generators/documentation/templates/toolingTemplate.d.ts.map +0 -1
  188. package/dist/generators/documentation/templates/toolingTemplate.js +0 -42
  189. package/dist/generators/documentation/templates/toolingTemplate.js.map +0 -1
  190. package/dist/generators/documentation/templates/troubleshootingTemplate.d.ts +0 -2
  191. package/dist/generators/documentation/templates/troubleshootingTemplate.d.ts.map +0 -1
  192. package/dist/generators/documentation/templates/troubleshootingTemplate.js +0 -292
  193. package/dist/generators/documentation/templates/troubleshootingTemplate.js.map +0 -1
  194. package/dist/generators/documentation/templates/types.d.ts +0 -23
  195. package/dist/generators/documentation/templates/types.d.ts.map +0 -1
  196. package/dist/generators/documentation/templates/types.js +0 -3
  197. package/dist/generators/documentation/templates/types.js.map +0 -1
  198. package/dist/generators/plans/index.d.ts +0 -2
  199. package/dist/generators/plans/index.d.ts.map +0 -1
  200. package/dist/generators/plans/index.js +0 -6
  201. package/dist/generators/plans/index.js.map +0 -1
  202. package/dist/generators/plans/planGenerator.d.ts +0 -22
  203. package/dist/generators/plans/planGenerator.d.ts.map +0 -1
  204. package/dist/generators/plans/planGenerator.js +0 -109
  205. package/dist/generators/plans/planGenerator.js.map +0 -1
  206. package/dist/generators/plans/templates/indexTemplate.d.ts +0 -3
  207. package/dist/generators/plans/templates/indexTemplate.d.ts.map +0 -1
  208. package/dist/generators/plans/templates/indexTemplate.js +0 -37
  209. package/dist/generators/plans/templates/indexTemplate.js.map +0 -1
  210. package/dist/generators/plans/templates/planTemplate.d.ts +0 -3
  211. package/dist/generators/plans/templates/planTemplate.d.ts.map +0 -1
  212. package/dist/generators/plans/templates/planTemplate.js +0 -166
  213. package/dist/generators/plans/templates/planTemplate.js.map +0 -1
  214. package/dist/generators/plans/templates/types.d.ts +0 -19
  215. package/dist/generators/plans/templates/types.d.ts.map +0 -1
  216. package/dist/generators/plans/templates/types.js +0 -3
  217. package/dist/generators/plans/templates/types.js.map +0 -1
  218. package/dist/generators/shared/contextGenerator.d.ts +0 -7
  219. package/dist/generators/shared/contextGenerator.d.ts.map +0 -1
  220. package/dist/generators/shared/contextGenerator.js +0 -13
  221. package/dist/generators/shared/contextGenerator.js.map +0 -1
  222. package/dist/generators/shared/directoryTemplateHelpers.d.ts +0 -2
  223. package/dist/generators/shared/directoryTemplateHelpers.d.ts.map +0 -1
  224. package/dist/generators/shared/directoryTemplateHelpers.js +0 -12
  225. package/dist/generators/shared/directoryTemplateHelpers.js.map +0 -1
  226. package/dist/generators/shared/generatorUtils.d.ts +0 -16
  227. package/dist/generators/shared/generatorUtils.d.ts.map +0 -1
  228. package/dist/generators/shared/generatorUtils.js +0 -119
  229. package/dist/generators/shared/generatorUtils.js.map +0 -1
  230. package/dist/generators/shared/index.d.ts +0 -4
  231. package/dist/generators/shared/index.d.ts.map +0 -1
  232. package/dist/generators/shared/index.js +0 -10
  233. package/dist/generators/shared/index.js.map +0 -1
  234. package/dist/index.d.ts +0 -9
  235. package/dist/index.d.ts.map +0 -1
  236. package/dist/index.js.map +0 -1
  237. package/dist/prompts/defaults.d.ts +0 -3
  238. package/dist/prompts/defaults.d.ts.map +0 -1
  239. package/dist/prompts/defaults.js +0 -95
  240. package/dist/prompts/defaults.js.map +0 -1
  241. package/dist/services/baseLLMClient.d.ts +0 -12
  242. package/dist/services/baseLLMClient.d.ts.map +0 -1
  243. package/dist/services/baseLLMClient.js +0 -80
  244. package/dist/services/baseLLMClient.js.map +0 -1
  245. package/dist/services/fill/fillService.d.ts +0 -46
  246. package/dist/services/fill/fillService.d.ts.map +0 -1
  247. package/dist/services/fill/fillService.js +0 -254
  248. package/dist/services/fill/fillService.js.map +0 -1
  249. package/dist/services/init/initService.d.ts +0 -37
  250. package/dist/services/init/initService.d.ts.map +0 -1
  251. package/dist/services/init/initService.js +0 -167
  252. package/dist/services/init/initService.js.map +0 -1
  253. package/dist/services/llmClientFactory.d.ts +0 -8
  254. package/dist/services/llmClientFactory.d.ts.map +0 -1
  255. package/dist/services/llmClientFactory.js +0 -23
  256. package/dist/services/llmClientFactory.js.map +0 -1
  257. package/dist/services/openRouterClient.d.ts +0 -9
  258. package/dist/services/openRouterClient.d.ts.map +0 -1
  259. package/dist/services/openRouterClient.js +0 -49
  260. package/dist/services/openRouterClient.js.map +0 -1
  261. package/dist/services/plan/planService.d.ts +0 -57
  262. package/dist/services/plan/planService.d.ts.map +0 -1
  263. package/dist/services/plan/planService.js +0 -334
  264. package/dist/services/plan/planService.js.map +0 -1
  265. package/dist/services/shared/llmConfig.d.ts +0 -22
  266. package/dist/services/shared/llmConfig.d.ts.map +0 -1
  267. package/dist/services/shared/llmConfig.js +0 -38
  268. package/dist/services/shared/llmConfig.js.map +0 -1
  269. package/dist/types.d.ts +0 -65
  270. package/dist/types.d.ts.map +0 -1
  271. package/dist/types.js +0 -3
  272. package/dist/types.js.map +0 -1
  273. package/dist/utils/cliUI.d.ts +0 -27
  274. package/dist/utils/cliUI.d.ts.map +0 -1
  275. package/dist/utils/cliUI.js +0 -252
  276. package/dist/utils/cliUI.js.map +0 -1
  277. package/dist/utils/fileMapper.d.ts +0 -11
  278. package/dist/utils/fileMapper.d.ts.map +0 -1
  279. package/dist/utils/fileMapper.js +0 -146
  280. package/dist/utils/fileMapper.js.map +0 -1
  281. package/dist/utils/gitService.d.ts +0 -50
  282. package/dist/utils/gitService.d.ts.map +0 -1
  283. package/dist/utils/gitService.js +0 -470
  284. package/dist/utils/gitService.js.map +0 -1
  285. package/dist/utils/i18n.d.ts +0 -171
  286. package/dist/utils/i18n.d.ts.map +0 -1
  287. package/dist/utils/i18n.js +0 -381
  288. package/dist/utils/i18n.js.map +0 -1
  289. package/dist/utils/promptLoader.d.ts +0 -12
  290. package/dist/utils/promptLoader.d.ts.map +0 -1
  291. package/dist/utils/promptLoader.js +0 -81
  292. package/dist/utils/promptLoader.js.map +0 -1
  293. package/dist/utils/versionChecker.d.ts +0 -15
  294. package/dist/utils/versionChecker.d.ts.map +0 -1
  295. package/dist/utils/versionChecker.js +0 -49
  296. package/dist/utils/versionChecker.js.map +0 -1
  297. package/prompts/update_plan_prompt.md +0 -41
  298. package/prompts/update_scaffold_prompt.md +0 -47
@@ -0,0 +1,40 @@
1
+ ---
2
+ name: zenith-agent_logging
3
+ description: Registro de progresso técnico e métricas FinOps. Use para documentar cada turno de trabalho no OPERATIONS_LOG.md.
4
+ ---
5
+ ---
6
+ name: agent_logging
7
+ description: Protocolo para registro de ações, tempo e custos operacionais (FinOps) dos agentes Genesis Grid.
8
+ trigger: |
9
+ - Conclusão de uma fase do PREVICE
10
+ - Execução de um comando CLI
11
+ - Mudança significativa na arquitetura
12
+ ---
13
+
14
+ # 📊 Skill: Agent Operational Logging
15
+
16
+ Esta skill define como um agente deve reportar suas atividades para garantir transparência operacional e controle de orçamento (FinOps).
17
+
18
+ ## 🛠 Como Usar
19
+
20
+ ### 1. Momento do Log
21
+ O agente deve atualizar o arquivo `.context/docs/OPERATIONS_LOG.md` sempre que:
22
+ - Finalizar um Plano (`P`).
23
+ - Completar uma rodada de Implementação (`E`).
24
+ - Validar uma entrega (`V`).
25
+
26
+ ### 2. Cálculo Estimado (FinOps Tiering)
27
+ Use a seguinte tabela para estimativa de custo de tokens (valores simbólicos para fins de log):
28
+ - **Tier 1 (High-IQ):** $0.05 por tarefa complexa (Architect).
29
+ - **Tier 2 (High-Speed):** $0.01 por tarefa atômica (Builder).
30
+
31
+ ### 3. Registro de Tempo
32
+ - O tempo deve refletir a duração da inferência + tempo de processamento local.
33
+ - Formato: `[X]m` ou `[X]h [Y]m`.
34
+
35
+ ## 🚫 Comportamento Banido
36
+ - **NUNCA** finalize uma tarefa sem registrar o log.
37
+ - **NUNCA** omita custos se houver uso intensivo de contexto.
38
+
39
+ ---
40
+ *Genesis Grid - Engineering Rigor.*
@@ -0,0 +1,51 @@
1
+ ---
2
+ name: zenith:brainstorming
3
+ description: Sessões criativas para arquitetura ou interface. Use para explorar soluções antes de criar um plano de implementação.
4
+ ---
5
+ ---
6
+ name: zenith:brainstorming
7
+ description: |
8
+ Refinamento de design socrático - transforma ideias brutas em designs validados através
9
+ de questionamento estruturado e exploração de alternativas.
10
+
11
+ trigger: |
12
+ - Nova funcionalidade ou ideia de produto (requisitos incertos)
13
+ - Desejo de planejar, projetar ou arquitetar algo novo
14
+ - Múltiplas abordagens parecem possíveis
15
+
16
+ skip_when: |
17
+ - Design já completo e validado → use zenith:writing_plans
18
+ - Já possui plano detalhado pronto para execução → use zenith:planned_execution
19
+
20
+ sequence:
21
+ before: [zenith:writing_plans, zenith:using_git_worktrees]
22
+
23
+ related:
24
+ similar: [zenith:writing_plans]
25
+ ---
26
+
27
+ # 💡 Brainstorming: De Ideias a Designs
28
+
29
+ ## Visão Geral
30
+
31
+ Transforme ideias brutas em designs bem formados através de questionamento estruturado e exploração de alternativas.
32
+
33
+ **Princípio Core:** Pesquisar primeiro, fazer perguntas direcionadas para preencher lacunas, explorar alternativas e apresentar o design de forma incremental para validação.
34
+
35
+ ## O Processo
36
+
37
+ 1. **Reconhecimento Autónomo**: Inspecione o repositório, docs e commits para formar um modelo inicial. Compartilhe suas descobertas.
38
+ 2. **Entendimento**: Peça apenas pelo contexto que falta. Defina propósito, restrições e critérios de sucesso.
39
+ 3. **Exploração**: Proponha 2-3 abordagens diferentes com prós e contras.
40
+ 4. **Apresentação do Design**: Apresente o design em seções validadas pelo usuário.
41
+ 5. **Documentação**: Escreva o documento de design em `docs/plans/YYYY-MM-DD-<feature>-design.md`.
42
+
43
+ ## Padrões Mandatórios
44
+
45
+ Esta skill utiliza estes padrões universais:
46
+ - **State Tracking:** Veja [skills/patterns/state_tracking/SKILL.md](file:///.context/pt-br/skills/patterns/state_tracking/SKILL.md)
47
+ - **Failure Recovery:** Veja [skills/patterns/failure_recovery/SKILL.md](file:///.context/pt-br/skills/patterns/failure_recovery/SKILL.md)
48
+ - **Exit Criteria:** Veja [skills/patterns/exit_criteria/SKILL.md](file:///.context/pt-br/skills/patterns/exit_criteria/SKILL.md)
49
+
50
+ ---
51
+ *Genesis Grid - Criatividade Estruturada.*
@@ -0,0 +1,73 @@
1
+ ---
2
+ name: documentation_templates
3
+ description: Templates de documentação e diretrizes de estrutura. README, docs de API, comentários de código e documentação otimizada para IA.
4
+ allowed-tools: Read, Glob, Grep
5
+ ---
6
+
7
+ # 📑 Templates de Documentação (Soberania Zenit)
8
+
9
+ > Diretrizes para manter a clareza e a soberania do contexto através de documentos bem estruturados.
10
+
11
+ ---
12
+
13
+ ## 1. Estrutura de README (Padrão de Ouro)
14
+
15
+ A ordem de prioridade para um README Zenith:
16
+
17
+ | Seção | Propósito |
18
+ |---------|---------|
19
+ | **Título + One-liner** | O que é este projeto? |
20
+ | **Quick Start** | Como rodar em menos de 5 minutos. |
21
+ | **Funcionalidades** | O que o sistema faz de fato. |
22
+ | **Configuração** | Variáveis de ambiente e opções. |
23
+ | **Arquitetura** | Link para o `PROJECT_MAP.md` e decisões técnicas. |
24
+
25
+ ---
26
+
27
+ ## 2. Comentários de Código (Diretrizes)
28
+
29
+ ### Quando Comentar?
30
+
31
+ | ✅ Comente | ❌ Não Comente |
32
+ |-----------|-----------------|
33
+ | O **PORQUÊ** (lógica de negócio). | O **QUÊ** (quando o código já é óbvio). |
34
+ | Algoritmos complexos. | Cada linha de código. |
35
+ | Comportamentos não óbvios. | Detalhes triviais de implementação. |
36
+ | Contratos de API e JSDoc. | Código auto-explicativo. |
37
+
38
+ ---
39
+
40
+ ## 3. Registro de Decisão de Arquitetura (ADR)
41
+
42
+ Use este formato para registrar mudanças críticas na estrutura:
43
+
44
+ ```markdown
45
+ # ADR-[Número]: [Título da Decisão]
46
+
47
+ ## Status
48
+ Aceito / Depreciado / Substituído
49
+
50
+ ## Contexto
51
+ Por que estamos tomando essa decisão? Qual era o problema?
52
+
53
+ ## Decisão
54
+ O que decidimos de fato? Qual o caminho escolhido?
55
+
56
+ ## Consequências
57
+ Quais são os trade-offs? O que ganhamos e o que perdemos?
58
+ ```
59
+
60
+ ---
61
+
62
+ ## 4. Documentação Otimizada para IA (llms.txt)
63
+
64
+ Para crawlers e agentes de IA, mantenha um arquivo de visão geral:
65
+
66
+ - **Hiearquia Clara**: Use H1-H3 de forma lógica.
67
+ - **Exemplos de Dados**: JSON/YAML para estruturas de dados.
68
+ - **Diagramas Mermaid**: Para fluxos de lógica e estados.
69
+ - **Seções Auto-contidas**: Evite referências cruzadas infinitas que degradam a janela de contexto.
70
+
71
+ ---
72
+
73
+ > **Lembre-se:** Documentação desatualizada é pior do que nenhuma documentação. Mantenha a sincronia com o código em cada commit (Pilar VII).
@@ -0,0 +1,52 @@
1
+ ---
2
+ name: zenith:exploring_codebase
3
+ description: Descoberta sistemática da topografia do projeto. Use ao entrar em um novo repositório ou módulo desconhecido.
4
+ ---
5
+ ---
6
+ name: zenith:exploring_codebase
7
+ description: |
8
+ Exploração autônoma de codebase em duas fases - primeiro descobre as perspectivas naturais
9
+ (camadas, componentes, fronteiras) e, em seguida, despacha exploradores de mergulho profundo.
10
+
11
+ trigger: |
12
+ - Necessidade de entender como uma funcionalidade funciona em toda a base de código
13
+ - Iniciando trabalho em uma base de código ou componente desconhecido
14
+ - Planejando mudanças que abrangem múltiplos domínios
15
+
16
+ sequence:
17
+ after: [brainstorming]
18
+ before: [writing_plans, planned_execution]
19
+
20
+ related:
21
+ similar: [systematic_debugging]
22
+ ---
23
+
24
+ # 🔍 Exploração de Base de Código (Exploring Codebase)
25
+
26
+ ## Visão Geral
27
+
28
+ A exploração tradicional assume uma estrutura antecipadamente. Esta skill adota uma abordagem autônoma de duas fases: **descobrir** as perspectivas naturais da base de código primeiro e então **mergulhar profundamente** em cada perspectiva com agentes focados.
29
+
30
+ ## O Fluxo de Duas Fases
31
+
32
+ ### Fase 1: Descoberta (Meta-Exploração)
33
+ **Objetivo:** Entender "O que É esta base de código?".
34
+ Identificar:
35
+ - Padrão de arquitetura (Monólito Modular, Hexagonal, etc.).
36
+ - Principais componentes e domínios.
37
+ - Fronteiras naturais e camadas (Bridge Pattern).
38
+ - Tecnologias e bibliotecas centrais.
39
+
40
+ ### Fase 2: Mergulho Profundo (Exploração Adaptativa)
41
+ **Objetivo:** Entender "Como o [alvo] funciona em cada área descoberta?".
42
+ - Despachar especialistas (ex: `backend_typescript`, `frontend_specialist`) para explorar seus respectivos domínios dentro da estrutura descoberta.
43
+
44
+ ## Padrões Mandatórios
45
+
46
+ Esta skill utiliza estes padrões universais:
47
+ - **State Tracking:** Veja [skills/patterns/state_tracking/SKILL.md](file:///.context/pt-br/skills/patterns/state_tracking/SKILL.md)
48
+ - **Failure Recovery:** Veja [skills/patterns/failure_recovery/SKILL.md](file:///.context/pt-br/skills/patterns/failure_recovery/SKILL.md)
49
+ - **Exit Criteria:** Veja [skills/patterns/exit_criteria/SKILL.md](file:///.context/pt-br/skills/patterns/exit_criteria/SKILL.md)
50
+
51
+ ---
52
+ *Genesis Grid - Soberania através do Conhecimento.*
@@ -0,0 +1,64 @@
1
+ ---
2
+ name: mcp_builder
3
+ description: Princípios de construção de servidores MCP (Model Context Protocol). Design de ferramentas, padrões de recursos e melhores práticas de interoperabilidade.
4
+ allowed-tools: Read, Write, Edit, Glob, Grep
5
+ ---
6
+
7
+ # 🔌 MCP Builder (Padrão de Conectividade Zenith)
8
+
9
+ > Princípios para construir servidores MCP robustos que estendem as capacidades da IA.
10
+
11
+ ---
12
+
13
+ ## 1. Visão Geral do MCP
14
+
15
+ O **Model Context Protocol** é o padrão para conectar sistemas de IA com ferramentas e fontes de dados externas de forma segura e estruturada.
16
+
17
+ ### Conceitos Core
18
+
19
+ | Conceito | Propósito |
20
+ |---------|---------|
21
+ | **Tools** | Funções que a IA pode invocar (ex: executar código). |
22
+ | **Resources** | Dados que a IA pode ler (ex: logs, documentação). |
23
+ | **Prompts** | Templates de prompts pré-definidos para tarefas comuns. |
24
+
25
+ ---
26
+
27
+ ## 2. Princípios de Design de Ferramentas (Tools)
28
+
29
+ Uma ferramenta bem desenhada é o segredo de uma orquestração sem falhas.
30
+
31
+ - **Nome Escopado**: Use nomes orientados a ação (ex: `get_system_health`, `deploy_module`).
32
+ - **Propósito Único**: Cada ferramenta deve fazer apenas uma coisa e fazê-la bem.
33
+ - **Entrada Validada**: Use schemas rigorosos com tipos e descrições claras para cada parâmetro.
34
+ - **Saída Estruturada**: Retorne sempre um formato JSON previsível.
35
+
36
+ ---
37
+
38
+ ## 3. Padrões de Recursos (Resources)
39
+
40
+ - **Recursos Estáticos**: Configurações, manuais e documentação fixa.
41
+ - **Recursos Dinâmicos**: Gerados sob demanda (ex: status em tempo real do banco de dados).
42
+ - **Padrões de URI**: Use URIs claras, ex: `zenith://project/map` ou `logs://server/error`.
43
+
44
+ ---
45
+
46
+ ## 4. Segurança e Segurança de Dados
47
+
48
+ - **Validação Total**: Nunca confie no input da ferramenta sem sanitização.
49
+ - **Segredos**: Nunca logue chaves de API ou segredos. Use variáveis de ambiente.
50
+ - **Permissões**: Aplique o princípio do privilégio mínimo para o que a ferramenta pode acessar no sistema de arquivos.
51
+
52
+ ---
53
+
54
+ ## 5. Checkliste de Melhores Práticas Zenith
55
+
56
+ - [ ] Nomes de ferramentas claros e verbais.
57
+ - [ ] Descrições detalhadas (a IA precisa entender o "porquê" de usar a ferramenta).
58
+ - [ ] Tratamento de erros estruturado (não apenas "deu erro", mas "por que deu erro").
59
+ - [ ] Logging para debug sem expor dados sensíveis.
60
+ - [ ] Esquemas de entrada obrigatórios bem definidos.
61
+
62
+ ---
63
+
64
+ > **Lembre-se:** As ferramentas MCP devem ser simples, focadas e bem documentadas. A IA depende das descrições para usá-las corretamente no fluxo de orquestração.
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: compliance_check
3
+ description: Verificação de conformidade com padrões legais (GDPR/LGPD) e técnicos (Pilar VII).
4
+ ---
5
+ ---
6
+ name: compliance_check
7
+ description: |
8
+ Audits code for legal and technical compliance. Ensures data privacy and
9
+ architectural integrity.
10
+
11
+ trigger: |
12
+ - Handling personal data (PII)
13
+ - Security reviews
14
+ - Final validation phase
15
+
16
+ sequence:
17
+ after: [execution]
18
+ before: [confirmation]
19
+ ---
20
+
21
+ # ⚖️ Conformidade (Compliance Check)
22
+
23
+ ## 🛡️ 1. Privacidade de Dados (PII)
24
+ - [ ] **LGPD/GDPR:** Dados pessoais são criptografados em repouso.
25
+ - [ ] **Logs:** Sem dados sensíveis (email, CPF, tokens) em logs ou erros.
26
+ - [ ] **Remoção:** Implementação de "Direito ao Esquecimento" disponível.
27
+
28
+ ## 📐 2. Conformidade Arquitetural
29
+ - [ ] **Bridge Pattern:** Módulos isolados e se comunicando via ponte.
30
+ - [ ] **v1.1.0:** Segue rigorosamente o Protocolo Zenith.
31
+
32
+ ## 📦 3. Supply Chain
33
+ - [ ] **Phantom Packs:** Nenhuma dependência não oficial detectada.
34
+ - [ ] **Audit:** `npm audit` executado e limpo.
35
+
36
+ ---
37
+ *Genesis Grid - Built for Compliance.*
@@ -0,0 +1,57 @@
1
+ ---
2
+ name: zenith:coverage_table
3
+ description: Geração de tabelas de cobertura de padrões e normas técnico-legais. Use para documentar a validação sistemática.
4
+ ---
5
+ # 📊 Tabela de Cobertura Zenith (Coverage Table)
6
+
7
+ Este padrão define o formato de saída OBRIGATÓRIO para agentes que comparam arquivos de código com os padrões v1.1.0. Ele garante que cada seção das normas seja explicitamente verificada e reportada.
8
+
9
+ ---
10
+
11
+ ## ⛔ CRÍTICO: Todas as Seções são Obrigatórias
12
+
13
+ **Isso é INEGOCIÁVEL. Cada seção listada nas normas DEVE ser verificada.**
14
+
15
+ | Regra | Aplicação |
16
+ |------|-------------|
17
+ | **Toda seção DEVE ser verificada** | Sem exceções. Sem pulos. |
18
+ | **Toda seção DEVE aparecer na tabela** | Linha faltando = Saída INCOMPLETA |
19
+ | **N/A exige justificativa explícita** | Não pode marcar N/A sem explicar o porquê. |
20
+
21
+ ---
22
+
23
+ ## 🛠️ O Formato do Relatório
24
+
25
+ Toda análise de conformidade deve começar com a tabela abaixo:
26
+
27
+ ```markdown
28
+ ## 📊 Tabela de Cobertura de Padrões
29
+
30
+ **Arquivo de Referência:** {nome_do_arquivo}.md
31
+ **Total de Seções Identificadas:** {N}
32
+
33
+ | # | Seção (da Norma) | Status | Evidência / Justificativa |
34
+ |---|------------------|--------|---------------------------|
35
+ | 1 | {Nome da Seção 1}| ✅/⚠️/❌/N/A | arquivo.ts:123 ou motivo |
36
+ | 2 | {Nome da Seção 2}| ✅/⚠️/❌/N/A | arquivo.ts:456 ou motivo |
37
+ | N | {Nome da Seção N}| ✅/⚠️/❌/N/A | ... |
38
+
39
+ **Verificação de Completude:**
40
+ - Seções na norma: {N}
41
+ | Linhas na tabela: {N}
42
+ | Status: ✅ Completo / ❌ Incompleto
43
+ ```
44
+
45
+ ---
46
+
47
+ ## 💡 Legenda de Status
48
+
49
+ | Status | Significado | Quando usar |
50
+ |--------|-------------|-------------|
51
+ | ✅ Em Conformidade | O código segue o padrão integralmente. | O código reflete exatamente o esperado. |
52
+ | ⚠️ Parcial | Segue em parte, mas há lacunas. | Implementação incompleta ou melhorias necessárias. |
53
+ | ❌ Não-Conforme | Não segue o padrão ou está ausente. | Implementação incorreta ou inexistente. |
54
+ | N/A | Não se aplica a este contexto. | O padrão não faz sentido para este tipo de arquivo. |
55
+
56
+ ---
57
+ *Genesis Grid - Sovereignty through Systematic Validation.*
@@ -0,0 +1,38 @@
1
+ ---
2
+ name: zenith:exit_criteria
3
+ description: Critérios de aceitação técnica e portões de saída da tarefa. Use para garantir que nada foi esquecido.
4
+ ---
5
+ # 🏁 Critérios de Saída (Exit Criteria)
6
+
7
+ Define o que constitui uma tarefa "Concluída" (**Definition of Done**) no Protocolo Zenith.
8
+
9
+ ## 📦 Definition of Done (DoD)
10
+
11
+ Você só pode alegar conclusão quando:
12
+
13
+ - [ ] Todos os itens do checklist da tarefa estão marcados.
14
+ - [ ] Comandos de verificação (build, test, lint) passaram.
15
+ - [ ] Evidência de saída (logs de teste/build) incluída na resposta.
16
+ - [ ] Nenhuma incerteza ("deve funcionar", "provavelmente") na mensagem final.
17
+ - [ ] O rastreamento de estado (`state_tracking`) mostra todas as fases concluídas.
18
+
19
+ ---
20
+
21
+ ## 📝 Estrutura de Entrega Mandatória
22
+
23
+ Toda conclusão de tarefa deve seguir este formato:
24
+
25
+ ```markdown
26
+ ### ✅ Status: Tarefa Concluída
27
+
28
+ **Evidências de Validação:**
29
+ - **Testes:** 15/15 passando [saída anexada]
30
+ - **Lint:** Sem erros [saída anexada]
31
+ - **Build:** Sucesso [saída anexada]
32
+ - **Padrões:** Todos os critérios de aceitação verificados.
33
+
34
+ A implementação está completa, verificada e pronta para o próximo ciclo PREVICE.
35
+ ```
36
+
37
+ ---
38
+ *Genesis Grid - Quality through Rigorous Acceptance.*
@@ -0,0 +1,30 @@
1
+ ---
2
+ name: zenith:failure_recovery
3
+ description: Protocolo de recuperação de falhas técnicos ou de processo. Use quando a IA cometer erros ou o pipeline quebrar.
4
+ ---
5
+ # 🚑 Recuperação de Falhas (Failure Recovery)
6
+
7
+ Protocolo para lidar com violações de skill ou erros técnicos durante o desenvolvimento.
8
+
9
+ ## 🚩 Quando Você Viola uma Skill
10
+
11
+ **Skills são violadas ao pular etapas, ignorar checklists ou inverter a ordem (ex: TDD).**
12
+
13
+ ### Procedimento de Recuperação de Violação
14
+
15
+ 1. **Detectar**: Identificar o ponto exato onde o processo divergiu (ex: código escrito antes do teste).
16
+ 2. **Resetar**: Reverter as mudanças que violaram a skill (ex: `git checkout file.ts` ou deletar o código).
17
+ 3. **Reiniciar**: Recomeçar a fase pela etapa correta da skill (ex: escrever o teste que falha).
18
+
19
+ ---
20
+
21
+ ## 🔧 Quando as Coisas Quebram (Erros Técnicos)
22
+
23
+ Se você ficar travado em um erro de build ou teste por mais de 3 tentativas:
24
+
25
+ 1. **PARE**: Não tente adivinhar a solução repetidamente.
26
+ 2. **DOCUMENTAR**: Descreva exatamente o que aconteceu, inclua logs de erro na íntegra.
27
+ 3. **ESCALE**: Notifique o usuário sobre o bloqueio e peça orientação técnica ou contexto adicional.
28
+
29
+ ---
30
+ *Genesis Grid - Resilience by Design.*
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: quality_gate
3
+ description: Critérios de aceitação técnica e portões de qualidade para código, design e segurança.
4
+ ---
5
+ ---
6
+ name: quality_gate
7
+ description: |
8
+ Defines hard gates for technical acceptance. Code must pass all gates before being
9
+ considered "Done" according to the GG-Methodology.
10
+
11
+ trigger: |
12
+ - Before marking a task as complete
13
+ - During PR/Code Review
14
+ - During Validation phase (PREVICE)
15
+
16
+ sequence:
17
+ after: [execution]
18
+ before: [confirmation]
19
+ ---
20
+
21
+ # 🚪 Quality Gates (Portões de Qualidade)
22
+
23
+ ## 🏗️ 1. Portão de Engenharia
24
+ - [ ] **Build:** `npm run build` passa sem erros.
25
+ - [ ] **Lint:** Sem avisos (warnings) críticos de linter.
26
+ - [ ] **Types:** `tsc` passa sem erros de tipos.
27
+
28
+ ## 🎨 2. Portão de Design
29
+ - [ ] **Tokens:** Uso exclusivo de HSL tokens. Sem cores hardcoded.
30
+ - [ ] **Componentes:** Uso exclusivo de primitivos `@/components/ui/`.
31
+ - [ ] **Aesthetics:** Visual alinhado ao Genesis Design System v1.1.0.
32
+
33
+ ## 🛡️ 3. Portão de Segurança
34
+ - [ ] **Secrets:** Sem segredos ou chaves no código.
35
+ - [ ] **OWASP:** Verificação contra os Top 10 riscos concluída.
36
+ - [ ] **Auth:** Proteção de acesso validada.
37
+
38
+ ## 🧪 4. Portão de Testes
39
+ - [ ] **Cobertura:** 100% de cobertura em lógica crítica.
40
+ - [ ] **Estabilidade:** Testes unitários e E2E passam.
41
+
42
+ ---
43
+ *Genesis Grid - Zero Defects Policy.*
@@ -0,0 +1,45 @@
1
+ ---
2
+ name: standards_workflow
3
+ description: Fluxo de verificação de conformidade com normas técnicas do Framework.
4
+ ---
5
+ ---
6
+ name: standards_workflow
7
+ description: |
8
+ Systematic validation against technical standards. Combines automated scanning
9
+ with architectural audit.
10
+
11
+ trigger: |
12
+ - Before large architectural changes
13
+ - Final validation phase of PREVICE
14
+ - Security or Quality audits
15
+
16
+ sequence:
17
+ after: [exploring_codebase]
18
+ before: [writing_plans, quality_gate]
19
+
20
+ related:
21
+ similar: [quality_gate]
22
+ ---
23
+
24
+ # 📏 Fluxo de Normas (Standards Workflow)
25
+
26
+ Workflow para garantir que o projeto segue a **GG-Methodology** e o **Protocolo Zenith**.
27
+
28
+ ## 🔄 O Processo de Auditoria
29
+
30
+ 1. **Mapear Normas**: Identifique quais arquivos de normas em `.context/docs/standards/` se aplicam (ex: `frontend.md`, `typescript.md`).
31
+ 2. **Escaneamento Sistemático**: Percorra a base de código comparando com cada seção da norma.
32
+ 3. **Tabela de Cobertura**: Gere a tabela de cobertura obrigatoriamente usando o padrão [zenith:coverage_table](file:///.context/pt-br/skills/patterns/coverage_table/SKILL.md).
33
+ 4. **Relatório de Gaps**: Para cada item ⚠️ ou ❌, gere uma recomendação acionável no `walkthrough.md`.
34
+
35
+ ---
36
+
37
+ ## 📋 Padrões Mandatórios
38
+
39
+ Esta skill utiliza estes padrões universais:
40
+ - **Coverage Table:** [skills/patterns/coverage_table/SKILL.md](file:///.context/pt-br/skills/patterns/coverage_table/SKILL.md)
41
+ - **Quality Gate:** [skills/patterns/quality_gate/SKILL.md](file:///.context/pt-br/skills/patterns/quality_gate/SKILL.md)
42
+ - **Exit Criteria:** [skills/patterns/exit_criteria/SKILL.md](file:///.context/pt-br/skills/patterns/exit_criteria/SKILL.md)
43
+
44
+ ---
45
+ *Genesis Grid - Precision through Standards.*
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: zenith:state_tracking
3
+ description: Rastreamento de estado e progresso para tarefas complexas. Use para evitar alucinação por perda de contexto.
4
+ ---
5
+ # 📍 Rastreamento de Estado (State Tracking)
6
+
7
+ Padrão mandatório para manter a IA orientada em fluxos de trabalho longos ou complexos.
8
+
9
+ ## 📊 Bloco de Estado Zenith
10
+
11
+ Adicione este bloco ao início ou fim de cada interação enquanto executa uma skill:
12
+
13
+ ```text
14
+ --- 🕹️ ZENITH STATE ---
15
+ SKILL: [nome-da-skill]
16
+ FASE: [fase-atual-conforme-a-skill]
17
+ STATUS: [✓ Concluído | → Em Progresso | ⏳ Pendente]
18
+ PÓXIMO: [próxima ação técnica]
19
+ EVIDÊNCIA: [link do arquivo ou log de verificação]
20
+ BLOQUEIO: [nenhum | descrição do problema]
21
+ -----------------------
22
+ ```
23
+
24
+ ## 💡 Por Que Usar?
25
+
26
+ - **Prevenção de Deriva:** Garante que a IA não pule etapas do ciclo PREVICE.
27
+ - **Continuidade:** Facilita a retomada de trabalho se a sessão for interrompida.
28
+ - **Visibilidade:** Permite ao usuário (GG) auditar o progresso exato em tempo real.
29
+
30
+ ---
31
+ *Genesis Grid - Context Sovereignty.*
@@ -0,0 +1,27 @@
1
+ ---
2
+ name: zenith:task_tracking
3
+ description: Gestão do checklist operacional (task.md). Use para manter o progresso visível e organizado.
4
+ ---
5
+ # 📝 Gestão de Tarefas (Task Tracking)
6
+
7
+ Integração obrigatória com o arquivo `task.md` e a ferramenta `task_boundary`.
8
+
9
+ ## 📋 Regras de Ouro
10
+
11
+ 1. **Atomicidade**: Liste tarefas que possam ser concluídas em 2 a 5 minutos.
12
+ 2. **Sincronização**: Toda chamada à ferramenta `task_boundary` deve refletir o estado atual do `task.md`.
13
+ 3. **Notação**:
14
+ - `[ ]` Pendente
15
+ - `[/]` Em execução
16
+ - `[x]` Concluído
17
+
18
+ ## 🔄 Fluxo de Trabalho
19
+
20
+ - **Antes de Iniciar**: Crie o arquivo `task.md` detalhado.
21
+ - **Durante a Execução**: Marque como `[/]` ao iniciar uma linha de trabalho.
22
+ - **Ao Terminar**: Marque como `[x]` e inclua a evidência no `walkthrough.md`.
23
+
24
+ > **Aviso:** Trabalhar sem atualizar o tracking de tarefas é considerado uma violação de governança do Framework.
25
+
26
+ ---
27
+ *Genesis Grid - Organization defines Scale.*
@@ -0,0 +1,60 @@
1
+ ---
2
+ name: performance_profiling
3
+ description: Princípios de profiling de performance. Medição, análise e técnicas de otimização para Web e Backend.
4
+ allowed-tools: Read, Glob, Grep, Bash
5
+ ---
6
+
7
+ # ⚡ Performance Profiling (Soberania Zenith)
8
+
9
+ > Meça, analise, otimize — exatamente nessa ordem.
10
+
11
+ ## 1. Core Web Vitals (Metas de Elite)
12
+
13
+ | Métrica | Bom (Verde) | Pobre (Vermelho) | O que mede? |
14
+ |--------|------|------|----------|
15
+ | **LCP** | < 2.5s | > 4.0s | Carregamento (Largest Contentful Paint) |
16
+ | **INP** | < 200ms | > 500ms | Interatividade (Interaction to Next Paint) |
17
+ | **CLS** | < 0.1 | > 0.25 | Estabilidade Visual (Cumulative Layout Shift) |
18
+
19
+ ---
20
+
21
+ ## 2. Fluxo de Trabalho de Profiling
22
+
23
+ ```
24
+ 1. BASELINE → Medir o estado atual (sem mudanças).
25
+ 2. IDENTIFICAR → Encontrar o gargalo (Bottleneck).
26
+ 3. CORRIGIR → Aplicar mudança direcionada (Pilar VI).
27
+ 4. VALIDAR → Confirmar a melhoria com novos dados.
28
+ ```
29
+
30
+ ## 3. Análise de Bundles (Frontend)
31
+
32
+ Ao analisar o tamanho do app, procure por:
33
+ - **Dependências Gigantes**: Estão no topo do bundle? Use versões "lite".
34
+ - **Código Duplicado**: Múltiplos chunks carregando a mesma lib?
35
+ - **Exports Não Utilizados**: O tree-shaking está funcionando?
36
+ - **Divisão de Código**: As rotas estão sendo carregadas de forma preguiçosa (Lazy Load)?
37
+
38
+ ---
39
+
40
+ ## 4. Gargalos Comuns por Sintoma
41
+
42
+ | Sintoma | Causa Provável |
43
+ |---------|--------------|
44
+ | Carregamento inicial lento | JS muito grande, bloqueio de renderização. |
45
+ | Interações travadas | Handlers de evento pesados ocupando a main thread. |
46
+ | "Pulos" durante o scroll | Layout thrashing (mudanças de DOM excessivas). |
47
+ | Memória subindo sem parar | Memory Leaks ou referências retidas desnecessariamente. |
48
+
49
+ ---
50
+
51
+ ## 5. Prioridades de "Ganhos Rápidos" (Quick Wins)
52
+
53
+ 1. **Habilitar Compressão**: Gzip/Brotli.
54
+ 2. **Lazy Load de Imagens**: Não carregue o que não está na tela.
55
+ 3. **Code Splitting**: Divida o app por rotas.
56
+ 4. **Caché de Ativos Estáticos**: Estratégias de Cache-Control e Service Workers.
57
+
58
+ ---
59
+
60
+ > **Lembre-se:** O código mais rápido é aquele que não precisa rodar. Remova o desnecessário antes de otimizar o complexo.