@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.
- package/README.md +25 -181
- package/dist/.context/docs/GENESIS_SYSTEM_PROMPT.md +61 -0
- package/dist/.context/eng/agents/architect.md +68 -0
- package/dist/.context/eng/agents/backend_typescript.md +1000 -0
- package/dist/.context/eng/agents/bug_hunter.md +49 -0
- package/dist/.context/eng/agents/code_archaeologist.md +83 -0
- package/dist/.context/eng/agents/code_reviewer.md +90 -0
- package/dist/.context/eng/agents/devops_specialist.md +718 -0
- package/dist/.context/eng/agents/frontend_specialist.md +1027 -0
- package/dist/.context/eng/agents/orchestrator.md +89 -0
- package/dist/.context/eng/agents/penetration_tester.md +59 -0
- package/dist/.context/eng/agents/qa_specialist.md +1234 -0
- package/dist/.context/eng/agents/security_reviewer.md +92 -0
- package/dist/.context/eng/agents/ui_specialist.md +16 -0
- package/dist/.context/eng/docs/AGENT_HANDOFF_PROMPT.md +44 -0
- package/dist/.context/eng/docs/GENESIS_DESIGN_SYSTEM.md +88 -0
- package/dist/.context/eng/docs/GG_METHODOLOGY.md +48 -0
- package/dist/.context/eng/docs/OPERATIONS_LOG.md +31 -0
- package/dist/.context/eng/docs/PROJECT_MAP.md +35 -0
- package/dist/.context/eng/docs/standards/devops.md +0 -0
- package/dist/.context/eng/docs/standards/frontend.md +0 -0
- package/dist/.context/eng/docs/standards/typescript.md +12 -0
- package/dist/.context/eng/skills/agent_logging/SKILL.md +22 -0
- package/dist/.context/eng/skills/brainstorming/SKILL.md +51 -0
- package/dist/.context/eng/skills/documentation_templates/SKILL.md +73 -0
- package/dist/.context/eng/skills/exploring_codebase/SKILL.md +52 -0
- package/dist/.context/eng/skills/mcp_builder/SKILL.md +64 -0
- package/dist/.context/eng/skills/patterns/compliance_check/SKILL.md +37 -0
- package/dist/.context/eng/skills/patterns/coverage_table/SKILL.md +57 -0
- package/dist/.context/eng/skills/patterns/exit_criteria/SKILL.md +35 -0
- package/dist/.context/eng/skills/patterns/failure_recovery/SKILL.md +78 -0
- package/dist/.context/eng/skills/patterns/quality_gate/SKILL.md +43 -0
- package/dist/.context/eng/skills/patterns/standards_workflow/SKILL.md +395 -0
- package/dist/.context/eng/skills/patterns/state_tracking/SKILL.md +34 -0
- package/dist/.context/eng/skills/patterns/task_tracking/SKILL.md +42 -0
- package/dist/.context/eng/skills/performance_profiling/SKILL.md +60 -0
- package/dist/.context/eng/skills/previce/SKILL.md +49 -0
- package/dist/.context/eng/skills/tdd/SKILL.md +59 -0
- package/dist/.context/eng/skills/using_git_worktrees/SKILL.md +45 -0
- package/dist/.context/eng/skills/vulnerability_scanner/SKILL.md +78 -0
- package/dist/.context/eng/skills/writing_plans/SKILL.md +85 -0
- package/dist/.context/plans/.gitkeep +0 -0
- package/dist/.context/pt-br/agents/architect.md +68 -0
- package/dist/.context/pt-br/agents/backend_typescript.md +1002 -0
- package/dist/.context/pt-br/agents/bug_hunter.md +49 -0
- package/dist/.context/pt-br/agents/code_archaeologist.md +82 -0
- package/dist/.context/pt-br/agents/code_reviewer.md +88 -0
- package/dist/.context/pt-br/agents/devops_specialist.md +718 -0
- package/dist/.context/pt-br/agents/frontend_specialist.md +1029 -0
- package/dist/.context/pt-br/agents/orchestrator.md +87 -0
- package/dist/.context/pt-br/agents/penetration_tester.md +59 -0
- package/dist/.context/pt-br/agents/qa_specialist.md +1234 -0
- package/dist/.context/pt-br/agents/security_reviewer.md +92 -0
- package/dist/.context/pt-br/agents/ui_specialist.md +55 -0
- package/dist/.context/pt-br/docs/AGENT_HANDOFF_PROMPT.md +44 -0
- package/dist/.context/pt-br/docs/GENESIS_DESIGN_SYSTEM.md +88 -0
- package/dist/.context/pt-br/docs/GG_METHODOLOGY.md +48 -0
- package/dist/.context/pt-br/docs/OPERATIONS_LOG.md +31 -0
- package/dist/.context/pt-br/docs/PROJECT_MAP.md +37 -0
- package/dist/.context/pt-br/docs/standards/devops.md +707 -0
- package/dist/.context/pt-br/docs/standards/frontend.md +748 -0
- package/dist/.context/pt-br/docs/standards/typescript.md +1150 -0
- package/dist/.context/pt-br/skills/agent_logging/SKILL.md +40 -0
- package/dist/.context/pt-br/skills/brainstorming/SKILL.md +51 -0
- package/dist/.context/pt-br/skills/documentation_templates/SKILL.md +73 -0
- package/dist/.context/pt-br/skills/exploring_codebase/SKILL.md +52 -0
- package/dist/.context/pt-br/skills/mcp_builder/SKILL.md +64 -0
- package/dist/.context/pt-br/skills/patterns/compliance_check/SKILL.md +37 -0
- package/dist/.context/pt-br/skills/patterns/coverage_table/SKILL.md +57 -0
- package/dist/.context/pt-br/skills/patterns/exit_criteria/SKILL.md +38 -0
- package/dist/.context/pt-br/skills/patterns/failure_recovery/SKILL.md +30 -0
- package/dist/.context/pt-br/skills/patterns/quality_gate/SKILL.md +43 -0
- package/dist/.context/pt-br/skills/patterns/standards_workflow/SKILL.md +45 -0
- package/dist/.context/pt-br/skills/patterns/state_tracking/SKILL.md +31 -0
- package/dist/.context/pt-br/skills/patterns/task_tracking/SKILL.md +27 -0
- package/dist/.context/pt-br/skills/performance_profiling/SKILL.md +60 -0
- package/dist/.context/pt-br/skills/previce/SKILL.md +51 -0
- package/dist/.context/pt-br/skills/tdd/SKILL.md +59 -0
- package/dist/.context/pt-br/skills/using_git_worktrees/SKILL.md +45 -0
- package/dist/.context/pt-br/skills/vulnerability_scanner/SKILL.md +78 -0
- package/dist/.context/pt-br/skills/writing_plans/SKILL.md +85 -0
- package/dist/.context/workflow/.gitkeep +0 -0
- package/dist/commands/init.js +159 -0
- package/dist/commands/monitor.js +34 -0
- package/dist/index.js +20 -568
- package/dist/services/monitor-service.js +342 -0
- package/dist/services/scaffolder.js +177 -0
- package/package.json +16 -58
- package/LICENSE +0 -21
- package/dist/generators/agents/agentConfig.d.ts +0 -4
- package/dist/generators/agents/agentConfig.d.ts.map +0 -1
- package/dist/generators/agents/agentConfig.js +0 -180
- package/dist/generators/agents/agentConfig.js.map +0 -1
- package/dist/generators/agents/agentGenerator.d.ts +0 -9
- package/dist/generators/agents/agentGenerator.d.ts.map +0 -1
- package/dist/generators/agents/agentGenerator.js +0 -97
- package/dist/generators/agents/agentGenerator.js.map +0 -1
- package/dist/generators/agents/agentTypes.d.ts +0 -4
- package/dist/generators/agents/agentTypes.d.ts.map +0 -1
- package/dist/generators/agents/agentTypes.js +0 -25
- package/dist/generators/agents/agentTypes.js.map +0 -1
- package/dist/generators/agents/index.d.ts +0 -4
- package/dist/generators/agents/index.d.ts.map +0 -1
- package/dist/generators/agents/index.js +0 -12
- package/dist/generators/agents/index.js.map +0 -1
- package/dist/generators/agents/templates/index.d.ts +0 -4
- package/dist/generators/agents/templates/index.d.ts.map +0 -1
- package/dist/generators/agents/templates/index.js +0 -8
- package/dist/generators/agents/templates/index.js.map +0 -1
- package/dist/generators/agents/templates/indexTemplate.d.ts +0 -3
- package/dist/generators/agents/templates/indexTemplate.d.ts.map +0 -1
- package/dist/generators/agents/templates/indexTemplate.js +0 -36
- package/dist/generators/agents/templates/indexTemplate.js.map +0 -1
- package/dist/generators/agents/templates/playbookTemplate.d.ts +0 -4
- package/dist/generators/agents/templates/playbookTemplate.d.ts.map +0 -1
- package/dist/generators/agents/templates/playbookTemplate.js +0 -99
- package/dist/generators/agents/templates/playbookTemplate.js.map +0 -1
- package/dist/generators/agents/templates/types.d.ts +0 -14
- package/dist/generators/agents/templates/types.d.ts.map +0 -1
- package/dist/generators/agents/templates/types.js +0 -3
- package/dist/generators/agents/templates/types.js.map +0 -1
- package/dist/generators/documentation/documentationGenerator.d.ts +0 -15
- package/dist/generators/documentation/documentationGenerator.d.ts.map +0 -1
- package/dist/generators/documentation/documentationGenerator.js +0 -188
- package/dist/generators/documentation/documentationGenerator.js.map +0 -1
- package/dist/generators/documentation/guideRegistry.d.ts +0 -6
- package/dist/generators/documentation/guideRegistry.d.ts.map +0 -1
- package/dist/generators/documentation/guideRegistry.js +0 -82
- package/dist/generators/documentation/guideRegistry.js.map +0 -1
- package/dist/generators/documentation/index.d.ts +0 -2
- package/dist/generators/documentation/index.d.ts.map +0 -1
- package/dist/generators/documentation/index.js +0 -6
- package/dist/generators/documentation/index.js.map +0 -1
- package/dist/generators/documentation/templates/apiReferenceTemplate.d.ts +0 -2
- package/dist/generators/documentation/templates/apiReferenceTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/apiReferenceTemplate.js +0 -490
- package/dist/generators/documentation/templates/apiReferenceTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/architectureTemplate.d.ts +0 -3
- package/dist/generators/documentation/templates/architectureTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/architectureTemplate.js +0 -66
- package/dist/generators/documentation/templates/architectureTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/common.d.ts +0 -7
- package/dist/generators/documentation/templates/common.d.ts.map +0 -1
- package/dist/generators/documentation/templates/common.js +0 -58
- package/dist/generators/documentation/templates/common.js.map +0 -1
- package/dist/generators/documentation/templates/dataFlowTemplate.d.ts +0 -3
- package/dist/generators/documentation/templates/dataFlowTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/dataFlowTemplate.js +0 -40
- package/dist/generators/documentation/templates/dataFlowTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/developmentWorkflowTemplate.d.ts +0 -2
- package/dist/generators/documentation/templates/developmentWorkflowTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/developmentWorkflowTemplate.js +0 -44
- package/dist/generators/documentation/templates/developmentWorkflowTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/glossaryTemplate.d.ts +0 -3
- package/dist/generators/documentation/templates/glossaryTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/glossaryTemplate.js +0 -41
- package/dist/generators/documentation/templates/glossaryTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/index.d.ts +0 -15
- package/dist/generators/documentation/templates/index.d.ts.map +0 -1
- package/dist/generators/documentation/templates/index.js +0 -30
- package/dist/generators/documentation/templates/index.js.map +0 -1
- package/dist/generators/documentation/templates/indexTemplate.d.ts +0 -3
- package/dist/generators/documentation/templates/indexTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/indexTemplate.js +0 -42
- package/dist/generators/documentation/templates/indexTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/migrationTemplate.d.ts +0 -2
- package/dist/generators/documentation/templates/migrationTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/migrationTemplate.js +0 -422
- package/dist/generators/documentation/templates/migrationTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/onboardingTemplate.d.ts +0 -2
- package/dist/generators/documentation/templates/onboardingTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/onboardingTemplate.js +0 -431
- package/dist/generators/documentation/templates/onboardingTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/projectOverviewTemplate.d.ts +0 -3
- package/dist/generators/documentation/templates/projectOverviewTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/projectOverviewTemplate.js +0 -65
- package/dist/generators/documentation/templates/projectOverviewTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/securityTemplate.d.ts +0 -2
- package/dist/generators/documentation/templates/securityTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/securityTemplate.js +0 -39
- package/dist/generators/documentation/templates/securityTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/testingTemplate.d.ts +0 -2
- package/dist/generators/documentation/templates/testingTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/testingTemplate.js +0 -45
- package/dist/generators/documentation/templates/testingTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/toolingTemplate.d.ts +0 -2
- package/dist/generators/documentation/templates/toolingTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/toolingTemplate.js +0 -42
- package/dist/generators/documentation/templates/toolingTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/troubleshootingTemplate.d.ts +0 -2
- package/dist/generators/documentation/templates/troubleshootingTemplate.d.ts.map +0 -1
- package/dist/generators/documentation/templates/troubleshootingTemplate.js +0 -292
- package/dist/generators/documentation/templates/troubleshootingTemplate.js.map +0 -1
- package/dist/generators/documentation/templates/types.d.ts +0 -23
- package/dist/generators/documentation/templates/types.d.ts.map +0 -1
- package/dist/generators/documentation/templates/types.js +0 -3
- package/dist/generators/documentation/templates/types.js.map +0 -1
- package/dist/generators/plans/index.d.ts +0 -2
- package/dist/generators/plans/index.d.ts.map +0 -1
- package/dist/generators/plans/index.js +0 -6
- package/dist/generators/plans/index.js.map +0 -1
- package/dist/generators/plans/planGenerator.d.ts +0 -22
- package/dist/generators/plans/planGenerator.d.ts.map +0 -1
- package/dist/generators/plans/planGenerator.js +0 -109
- package/dist/generators/plans/planGenerator.js.map +0 -1
- package/dist/generators/plans/templates/indexTemplate.d.ts +0 -3
- package/dist/generators/plans/templates/indexTemplate.d.ts.map +0 -1
- package/dist/generators/plans/templates/indexTemplate.js +0 -37
- package/dist/generators/plans/templates/indexTemplate.js.map +0 -1
- package/dist/generators/plans/templates/planTemplate.d.ts +0 -3
- package/dist/generators/plans/templates/planTemplate.d.ts.map +0 -1
- package/dist/generators/plans/templates/planTemplate.js +0 -166
- package/dist/generators/plans/templates/planTemplate.js.map +0 -1
- package/dist/generators/plans/templates/types.d.ts +0 -19
- package/dist/generators/plans/templates/types.d.ts.map +0 -1
- package/dist/generators/plans/templates/types.js +0 -3
- package/dist/generators/plans/templates/types.js.map +0 -1
- package/dist/generators/shared/contextGenerator.d.ts +0 -7
- package/dist/generators/shared/contextGenerator.d.ts.map +0 -1
- package/dist/generators/shared/contextGenerator.js +0 -13
- package/dist/generators/shared/contextGenerator.js.map +0 -1
- package/dist/generators/shared/directoryTemplateHelpers.d.ts +0 -2
- package/dist/generators/shared/directoryTemplateHelpers.d.ts.map +0 -1
- package/dist/generators/shared/directoryTemplateHelpers.js +0 -12
- package/dist/generators/shared/directoryTemplateHelpers.js.map +0 -1
- package/dist/generators/shared/generatorUtils.d.ts +0 -16
- package/dist/generators/shared/generatorUtils.d.ts.map +0 -1
- package/dist/generators/shared/generatorUtils.js +0 -119
- package/dist/generators/shared/generatorUtils.js.map +0 -1
- package/dist/generators/shared/index.d.ts +0 -4
- package/dist/generators/shared/index.d.ts.map +0 -1
- package/dist/generators/shared/index.js +0 -10
- package/dist/generators/shared/index.js.map +0 -1
- package/dist/index.d.ts +0 -9
- package/dist/index.d.ts.map +0 -1
- package/dist/index.js.map +0 -1
- package/dist/prompts/defaults.d.ts +0 -3
- package/dist/prompts/defaults.d.ts.map +0 -1
- package/dist/prompts/defaults.js +0 -95
- package/dist/prompts/defaults.js.map +0 -1
- package/dist/services/baseLLMClient.d.ts +0 -12
- package/dist/services/baseLLMClient.d.ts.map +0 -1
- package/dist/services/baseLLMClient.js +0 -80
- package/dist/services/baseLLMClient.js.map +0 -1
- package/dist/services/fill/fillService.d.ts +0 -46
- package/dist/services/fill/fillService.d.ts.map +0 -1
- package/dist/services/fill/fillService.js +0 -254
- package/dist/services/fill/fillService.js.map +0 -1
- package/dist/services/init/initService.d.ts +0 -37
- package/dist/services/init/initService.d.ts.map +0 -1
- package/dist/services/init/initService.js +0 -167
- package/dist/services/init/initService.js.map +0 -1
- package/dist/services/llmClientFactory.d.ts +0 -8
- package/dist/services/llmClientFactory.d.ts.map +0 -1
- package/dist/services/llmClientFactory.js +0 -23
- package/dist/services/llmClientFactory.js.map +0 -1
- package/dist/services/openRouterClient.d.ts +0 -9
- package/dist/services/openRouterClient.d.ts.map +0 -1
- package/dist/services/openRouterClient.js +0 -49
- package/dist/services/openRouterClient.js.map +0 -1
- package/dist/services/plan/planService.d.ts +0 -57
- package/dist/services/plan/planService.d.ts.map +0 -1
- package/dist/services/plan/planService.js +0 -334
- package/dist/services/plan/planService.js.map +0 -1
- package/dist/services/shared/llmConfig.d.ts +0 -22
- package/dist/services/shared/llmConfig.d.ts.map +0 -1
- package/dist/services/shared/llmConfig.js +0 -38
- package/dist/services/shared/llmConfig.js.map +0 -1
- package/dist/types.d.ts +0 -65
- package/dist/types.d.ts.map +0 -1
- package/dist/types.js +0 -3
- package/dist/types.js.map +0 -1
- package/dist/utils/cliUI.d.ts +0 -27
- package/dist/utils/cliUI.d.ts.map +0 -1
- package/dist/utils/cliUI.js +0 -252
- package/dist/utils/cliUI.js.map +0 -1
- package/dist/utils/fileMapper.d.ts +0 -11
- package/dist/utils/fileMapper.d.ts.map +0 -1
- package/dist/utils/fileMapper.js +0 -146
- package/dist/utils/fileMapper.js.map +0 -1
- package/dist/utils/gitService.d.ts +0 -50
- package/dist/utils/gitService.d.ts.map +0 -1
- package/dist/utils/gitService.js +0 -470
- package/dist/utils/gitService.js.map +0 -1
- package/dist/utils/i18n.d.ts +0 -171
- package/dist/utils/i18n.d.ts.map +0 -1
- package/dist/utils/i18n.js +0 -381
- package/dist/utils/i18n.js.map +0 -1
- package/dist/utils/promptLoader.d.ts +0 -12
- package/dist/utils/promptLoader.d.ts.map +0 -1
- package/dist/utils/promptLoader.js +0 -81
- package/dist/utils/promptLoader.js.map +0 -1
- package/dist/utils/versionChecker.d.ts +0 -15
- package/dist/utils/versionChecker.d.ts.map +0 -1
- package/dist/utils/versionChecker.js +0 -49
- package/dist/utils/versionChecker.js.map +0 -1
- package/prompts/update_plan_prompt.md +0 -41
- 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.
|