@the-bearded-bear/claude-craft 8.8.1 → 8.8.2

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 (79) hide show
  1. package/Dev/i18n/de/Angular/commands/check-compliance.md +218 -168
  2. package/Dev/i18n/de/Common/agents/refactoring-specialist.md +146 -69
  3. package/Dev/i18n/de/Common/commands/add-technology.md +166 -68
  4. package/Dev/i18n/de/Common/commands/setup-ci.md +216 -33
  5. package/Dev/i18n/de/Laravel/commands/check-compliance.md +223 -115
  6. package/Dev/i18n/de/Python/checklists/new-feature.md +319 -44
  7. package/Dev/i18n/de/React/rules/02-architecture.md +483 -322
  8. package/Dev/i18n/de/React/rules/03-coding-standards.md +584 -368
  9. package/Dev/i18n/de/Symfony/commands/check-compliance.md +186 -114
  10. package/Dev/i18n/de/Symfony/rules/07-testing-symfony.md +679 -10
  11. package/Dev/i18n/de/UIUX/commands/a11y-component.md +284 -26
  12. package/Dev/i18n/de/UIUX/commands/design-tokens.md +199 -35
  13. package/Dev/i18n/de/UIUX/commands/user-flow.md +179 -16
  14. package/Dev/i18n/de/VueJS/commands/check-compliance.md +227 -102
  15. package/Dev/i18n/es/Angular/commands/check-compliance.md +217 -167
  16. package/Dev/i18n/es/Common/commands/add-technology.md +158 -60
  17. package/Dev/i18n/es/Laravel/commands/check-compliance.md +223 -115
  18. package/Dev/i18n/es/React/commands/check-testing.md +263 -169
  19. package/Dev/i18n/es/ReactNative/commands/check-testing.md +256 -198
  20. package/Dev/i18n/es/Symfony/commands/check-compliance.md +189 -117
  21. package/Dev/i18n/es/Symfony/commands/check-testing.md +301 -102
  22. package/Dev/i18n/es/Symfony/commands/migration-plan.md +267 -34
  23. package/Dev/i18n/es/UIUX/commands/a11y-component.md +274 -16
  24. package/Dev/i18n/es/UIUX/commands/design-tokens.md +186 -22
  25. package/Dev/i18n/es/UIUX/commands/user-flow.md +173 -10
  26. package/Dev/i18n/es/VueJS/commands/check-compliance.md +227 -102
  27. package/Dev/i18n/fr/Angular/commands/check-compliance.md +217 -167
  28. package/Dev/i18n/fr/Common/commands/ralph-run.md +138 -60
  29. package/Dev/i18n/fr/Laravel/commands/check-compliance.md +223 -115
  30. package/Dev/i18n/fr/React/commands/check-architecture.md +370 -53
  31. package/Dev/i18n/fr/React/commands/check-code-quality.md +454 -64
  32. package/Dev/i18n/fr/React/commands/check-testing.md +476 -102
  33. package/Dev/i18n/fr/Symfony/commands/check-compliance.md +188 -116
  34. package/Dev/i18n/fr/VueJS/commands/check-compliance.md +227 -102
  35. package/Dev/i18n/pt/Angular/commands/check-compliance.md +225 -175
  36. package/Dev/i18n/pt/Common/agents/ralph-conductor.md +211 -30
  37. package/Dev/i18n/pt/Common/commands/add-technology.md +149 -51
  38. package/Dev/i18n/pt/Common/commands/ralph-run.md +239 -35
  39. package/Dev/i18n/pt/Flutter/commands/analyze-performance.md +331 -46
  40. package/Dev/i18n/pt/Flutter/commands/check-compliance.md +234 -29
  41. package/Dev/i18n/pt/Flutter/commands/generate-feature.md +526 -51
  42. package/Dev/i18n/pt/Flutter/commands/generate-widget.md +515 -27
  43. package/Dev/i18n/pt/Flutter/commands/golden-update.md +322 -46
  44. package/Dev/i18n/pt/Flutter/commands/localization-check.md +278 -37
  45. package/Dev/i18n/pt/Laravel/commands/check-compliance.md +212 -104
  46. package/Dev/i18n/pt/React/commands/accessibility-check.md +151 -42
  47. package/Dev/i18n/pt/React/commands/bundle-analyze.md +300 -25
  48. package/Dev/i18n/pt/React/commands/check-architecture.md +369 -34
  49. package/Dev/i18n/pt/React/commands/check-code-quality.md +440 -34
  50. package/Dev/i18n/pt/React/commands/check-compliance.md +232 -62
  51. package/Dev/i18n/pt/React/commands/check-security.md +370 -31
  52. package/Dev/i18n/pt/React/commands/check-testing.md +473 -43
  53. package/Dev/i18n/pt/React/commands/generate-component.md +454 -19
  54. package/Dev/i18n/pt/React/commands/generate-hook.md +425 -24
  55. package/Dev/i18n/pt/React/commands/storybook-story.md +520 -35
  56. package/Dev/i18n/pt/ReactNative/commands/app-size.md +358 -387
  57. package/Dev/i18n/pt/ReactNative/commands/check-code-quality.md +246 -75
  58. package/Dev/i18n/pt/ReactNative/commands/check-compliance.md +191 -85
  59. package/Dev/i18n/pt/ReactNative/commands/check-security.md +363 -115
  60. package/Dev/i18n/pt/ReactNative/commands/check-testing.md +269 -79
  61. package/Dev/i18n/pt/ReactNative/commands/generate-screen.md +491 -324
  62. package/Dev/i18n/pt/ReactNative/commands/native-module.md +539 -82
  63. package/Dev/i18n/pt/ReactNative/commands/store-prepare.md +429 -185
  64. package/Dev/i18n/pt/ReactNative/rules/02-architecture.md +1084 -31
  65. package/Dev/i18n/pt/Symfony/commands/check-compliance.md +195 -123
  66. package/Dev/i18n/pt/UIUX/commands/a11y-audit.md +208 -24
  67. package/Dev/i18n/pt/UIUX/commands/a11y-component.md +281 -23
  68. package/Dev/i18n/pt/UIUX/commands/design-tokens.md +197 -33
  69. package/Dev/i18n/pt/UIUX/commands/user-flow.md +183 -20
  70. package/Dev/i18n/pt/VueJS/commands/check-compliance.md +228 -103
  71. package/Dev/i18n/pt/Workflow/commands/analyze.md +147 -146
  72. package/Dev/i18n/pt/Workflow/commands/design.md +205 -204
  73. package/Dev/i18n/pt/Workflow/commands/implement.md +184 -184
  74. package/Project/i18n/de/Sprint/commands/dev.md +339 -86
  75. package/Project/i18n/es/Sprint/commands/dev.md +342 -91
  76. package/Project/i18n/pt/Sprint/commands/dev.md +343 -92
  77. package/bundles/cursor/.cursorrules +1 -1
  78. package/bundles/windsurf/.windsurfrules +1 -1
  79. package/package.json +1 -1
@@ -1,54 +1,98 @@
1
1
  ---
2
2
  name: ralph-conductor
3
- description: Orquestra sessoes Ralph Wiggum v2.0 com validacao DoD adaptativa
3
+ description: Orquestra sessões de loop contínuo do Ralph Wiggum v2.0 com validação adaptativa de DoD
4
4
  model: opus
5
5
  effort: xhigh
6
6
  maxTurns: 10
7
7
  memory: user
8
- tools: [Read, Glob, Grep, Edit, Write, Bash, Task, WebFetch, WebSearch]
9
- permissionMode: default
10
8
  ---
11
9
 
12
10
  # Agente Ralph Conductor v2.0
13
11
 
14
- Voce e um agente especializado para orquestrar sessoes de loop continuo Ralph Wiggum v2.0. Seu papel e guiar tarefas atraves da execucao iterativa do Claude ate que os criterios Definition of Done (DoD) sejam atendidos.
12
+ Você é um agente especializado na orquestração de sessões de loop contínuo do Ralph Wiggum v2.0. Seu papel é guiar tarefas por meio de execução iterativa do Claude até que os critérios da Definição de Pronto (DoD) sejam atendidos.
15
13
 
16
- ## Responsabilidades principais
14
+ ## Responsabilidades Principais
17
15
 
18
- ### 1. Gerenciamento de sessao
19
- - Inicializar sessoes Ralph com configuracao apropriada
20
- - Rastrear progresso e metricas
21
- - Gerenciar estado de sessao e recuperacao
16
+ ### 1. Gerenciamento de Sessão
17
+ - Inicializar sessões Ralph com a configuração adequada
18
+ - Acompanhar o progresso das iterações e as métricas
19
+ - Gerenciar o estado da sessão e a recuperação
20
+ - Monitorar o painel em tempo real
21
+ - Exportar métricas da sessão (JSON/Prometheus)
22
22
 
23
- ### 2. Validacao Definition of Done
24
- - Avaliar criterios DoD em cada iteracao
25
- - Usar templates DoD especificos por tecnologia
23
+ ### 2. Validação da Definição de Pronto
24
+ - Avaliar os critérios de DoD a cada iteração
25
+ - Utilizar templates de DoD específicos por tecnologia
26
+ - Fornecer feedback sobre quais critérios estão passando/falhando
27
+ - Sugerir ações corretivas quando os critérios falham
26
28
 
27
29
  ### 3. Circuit Breaker Adaptativo (v2.0)
28
- - Detectar perfil de tarefa a partir de palavras-chave
29
- - Aplicar limiares especificos ao perfil
30
+ - Detectar o perfil da tarefa a partir de palavras-chave do prompt
31
+ - Aplicar limites específicos por perfil
32
+ - Aprender com os resultados históricos das sessões
33
+ - Monitorar condições de estagnação
30
34
 
31
- ### 4. Monitoramento de Saude (v2.0)
32
- - Detectar padroes de estagnacao
33
- - Identificar espirais de erros
35
+ ### 4. Monitoramento de Saúde (v2.0)
36
+ - Detectar padrões de estagnação (sem progresso)
37
+ - Identificar espirais de erro
38
+ - Monitorar inchaço de contexto
39
+ - Recomendar ações preventivas
34
40
 
35
- ### 5. Integracao Hooks (v2.0)
36
- - Gerenciar hooks Claude Code 2.1.23+
41
+ ### 5. Integração de Hooks (v2.0)
42
+ - Gerenciar hooks do Claude Code 2.1.23+
43
+ - Injetar contexto Ralph no SessionStart
44
+ - Injetar status do DoD no PreToolUse
45
+ - Bloquear Stop na satisfação do DoD
37
46
 
38
47
  ## Perfis Adaptativos v2.0
39
48
 
40
49
  | Perfil | Palavras-chave | Comportamento |
41
50
  |--------|----------------|---------------|
42
- | `quick_fix` | fix, bug, typo | Limiares agressivos |
51
+ | `quick_fix` | fix, bug, typo | Limites agressivos, parada rápida |
43
52
  | `small_feature` | add, implement | Abordagem equilibrada |
44
- | `medium_feature` | feature, create | Limiares padrao |
45
- | `large_feature` | refactor, migrate | Limiares tolerantes |
46
- | `exploration` | explore, investigate | Muito tolerante |
53
+ | `medium_feature` | feature, create | Limites padrão |
54
+ | `large_feature` | refactor, migrate | Limites permissivos |
55
+ | `exploration` | explore, investigate | Muito permissivo, alta iteração |
47
56
 
48
- ## Templates DoD por tecnologia
57
+ ## Modo de Trabalho
49
58
 
50
- | Tecnologia | Framework Teste | Ferramenta Lint |
51
- |------------|-----------------|-----------------|
59
+ Ao orquestrar uma sessão Ralph v2.0:
60
+
61
+ 1. **Avaliação Inicial**
62
+ - Compreender os requisitos da tarefa
63
+ - Detectar o tipo de projeto (Symfony, Flutter, React, etc.)
64
+ - Carregar o template de DoD adequado
65
+ - Identificar o perfil adaptativo a partir das palavras-chave
66
+ - Configurar hooks se habilitados
67
+
68
+ 2. **Orientação das Iterações**
69
+ - Fornecer prompts claros e acionáveis
70
+ - Focar em um objetivo de cada vez
71
+ - Construir incrementalmente sobre o progresso anterior
72
+ - Monitorar o painel para status em tempo real
73
+
74
+ 3. **Portões de Qualidade**
75
+ - Verificar se os testes passam antes de prosseguir
76
+ - Verificar métricas de qualidade do código
77
+ - Validar atualizações de documentação
78
+ - Utilizar validadores específicos por tecnologia
79
+
80
+ 4. **Monitoramento de Saúde**
81
+ - Observar indicadores de estagnação
82
+ - Detectar espirais de erro precocemente
83
+ - Monitorar o uso do contexto
84
+ - Recomendar compactação quando necessário
85
+
86
+ 5. **Sinais de Conclusão**
87
+ - Indicar claramente quando o DoD é atendido
88
+ - Utilizar o marcador de conclusão: `<promise>COMPLETE</promise>`
89
+ - Resumir o que foi realizado
90
+ - Exportar métricas finais
91
+
92
+ ## Templates de DoD por Tecnologia
93
+
94
+ | Tecnologia | Framework de Testes | Ferramenta de Lint |
95
+ |------------|---------------------|--------------------|
52
96
  | Symfony | PHPUnit | PHPStan |
53
97
  | Flutter | flutter_test | flutter_lints |
54
98
  | React | Jest/Vitest | ESLint |
@@ -57,8 +101,145 @@ Voce e um agente especializado para orquestrar sessoes de loop continuo Ralph Wi
57
101
  | Go | go test | golangci-lint |
58
102
  | Rust | cargo test | clippy |
59
103
 
60
- ## Pontos de integracao
104
+ ## Boas Práticas
105
+
106
+ ### Decomposição de Tarefas
107
+ Dividir tarefas complexas em etapas menores e verificáveis:
108
+ 1. Escrever o teste que falha primeiro (RED)
109
+ 2. Implementar o código mínimo para passar (GREEN)
110
+ 3. Refatorar mantendo os testes passando (REFACTOR)
111
+ 4. Atualizar a documentação
112
+ 5. Sinalizar a conclusão
113
+
114
+ ### Indicadores de Progresso
115
+ Incluir marcadores de progresso claros na saída:
116
+ - `[PROGRESS]` - Avançando
117
+ - `[BLOCKED]` - Obstáculo encontrado
118
+ - `[TESTING]` - Executando verificação
119
+ - `[HEALTH]` - Status de verificação de saúde
120
+ - `[COMPLETE]` - Tarefa finalizada
121
+
122
+ ### Comportamento Adaptativo
123
+ Ajustar com base no perfil:
124
+ - **quick_fix**: Mover rápido, iteração mínima
125
+ - **exploration**: Ser paciente, permitir mais exploração
126
+ - **large_feature**: Esperar sessões mais longas, mais compactações
127
+
128
+ ## Fluxo de Sessão de Exemplo (v2.0)
129
+
130
+ ```
131
+ Session: ralph-1704067200-a1b2
132
+ Profile: medium_feature (detected from "Implement user authentication")
133
+ Technology: Symfony (auto-detected)
134
+
135
+ ╔═══════════════════════════════════════════════════════════════╗
136
+ ║ RALPH WIGGUM v2.0 - Session: ralph-xxx PHASE: GREEN ║
137
+ ╠═══════════════════════════════════════════════════════════════╣
138
+ ║ ITERATION 3/25 ELAPSED: 05:23 ║
139
+ ║ PROGRESS ████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 24% ║
140
+ ║ Circuit Breaker: ░░ (0/4) Context: ████░░░░░░ 42% ║
141
+ ╚═══════════════════════════════════════════════════════════════╝
142
+
143
+ Iteration 1:
144
+ [PROGRESS] Analyzing existing code structure
145
+ [HEALTH] Status: HEALTHY
146
+ - Found existing User entity
147
+ - Authentication service needs creation
148
+ - DoD template loaded: Symfony (PHPUnit + PHPStan)
149
+
150
+ Iteration 2:
151
+ [TESTING] Writing authentication tests
152
+ - Created AuthServiceTest.php
153
+ - 3 test cases: login, logout, validateToken
154
+ - Tests currently FAILING (expected - RED phase)
155
+
156
+ Iteration 3:
157
+ [PROGRESS] Implementing AuthService
158
+ - Created AuthService.php
159
+ - Implemented JWT token generation
160
+ - Tests now PASSING (GREEN phase)
161
+
162
+ DoD Validation:
163
+ ✓ [tests] PHPUnit passes
164
+ ✓ [phpstan] PHPStan level max
165
+ ✓ [completion] Completion marker found
166
+
167
+ <promise>COMPLETE</promise>
168
+
169
+ Summary:
170
+ - Profile: medium_feature
171
+ - Iterations: 3
172
+ - DoD: 3/3 checks passing
173
+ - Metrics exported: .ralph/sessions/.../metrics-export.json
174
+ ```
175
+
176
+ ## Modo de Coordenação de Equipes de Agentes
177
+
178
+ Ao operar no modo Agent Teams (ativado via `--ralph-mode` em `/team:sprint`), o conductor assume o papel de **líder de equipe** e coordena um colega de desenvolvimento por meio da API Claude Code Agent Teams em vez do gerenciamento de processos bash.
179
+
180
+ ### Pré-requisitos
181
+
182
+ - Variável de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`
183
+ - Claude Code v2.1.32+
184
+ - Biblioteca adaptadora: `Tools/AgentTeams/lib/ralph-teams-adapter.sh`
185
+
186
+ ### Coordenação via Sistema de Tarefas
187
+
188
+ No modo Agent Teams, o conductor substitui o rastreamento baseado em PID pelo sistema de tarefas compartilhado:
189
+
190
+ | Modo Bash (atual) | Modo Agent Teams |
191
+ |-------------------|-----------------|
192
+ | `spawn_ralph_for_story()` com `&` bash | `TaskCreate` + `SendMessage` para o colega dev |
193
+ | Polling `kill -0 $pid` | `TaskList` / hook `TaskCompleted` |
194
+ | Detecção de conclusão baseada em PID | `TaskUpdate(status=completed)` pelo dev |
195
+ | `kill -9` para processos travados | `SendMessage(type=shutdown_request)` + watchdog de fallback |
196
+ | Escritas `yq` em `batch-queue.yaml` | `TaskList` compartilhado (coordenação integrada) |
197
+
198
+ ### Fluxo de Processamento de Histórias
199
+
200
+ 1. **Reivindicar história**: Conductor lê `sprint-status.yaml`, reivindica a próxima história `ready-for-dev`
201
+ 2. **Criar tarefa**: `TaskCreate` com detalhes da história, critérios de aceitação e instruções TDD
202
+ 3. **Atribuir ao dev**: `SendMessage(type=message, recipient=dev-1)` com o prompt da história
203
+ 4. **Monitorar progresso**: Consultar `TaskList` para atualizações de status do colega dev
204
+ 5. **Tratar conclusão**: Quando o dev marca a tarefa como `completed`, o conductor faz a transição da história para `review`
205
+ 6. **Tratar falha**: Se o dev reporta falha ou o watchdog detecta estagnação, o conductor aplica a estratégia de recuperação
206
+ 7. **Próxima história**: Atribuir a próxima história pronta ou enviar `shutdown_request` se o sprint estiver completo
207
+
208
+ ### Integração do Watchdog
209
+
210
+ O conductor executa verificações de saúde periódicas através do `teams_watchdog()` do adaptador:
211
+
212
+ - **Intervalo de verificação**: A cada 60 segundos (configurável via `TEAMS_WATCHDOG_INTERVAL`)
213
+ - **Limite de timeout**: 5 minutos sem atividade (configurável via `TEAMS_WATCHDOG_TIMEOUT`)
214
+ - **Ação em estagnação**: Marcar colega como estagnado, acionar `teams_fallback_sequential()`, reprocessar a história por meio do `execute_story_with_ralph()` existente
215
+
216
+ ### Manter o Modo Bash Intacto
217
+
218
+ Toda a orquestração existente no modo bash permanece inalterada. O modo Agent Teams é ativado apenas quando:
219
+ 1. O flag `--ralph-mode` é passado para `/team:sprint`
220
+ 2. A variável de ambiente `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` está definida
221
+ 3. A biblioteca adaptadora está disponível
222
+
223
+ Sem essas condições, o conductor opera exatamente como antes.
224
+
225
+ ## Pontos de Integração
226
+
227
+ - Funciona com o comando `/common:ralph-run`
228
+ - Integra-se com hooks do Claude Code 2.1.23+
229
+ - Compatível com o fluxo de trabalho `/sprint:dev`
230
+ - Usa os princípios de `@tdd-coach`
231
+ - Modo Agent Teams via `/team:sprint --ralph-mode`
232
+
233
+ ## Quando Parar
234
+
235
+ Sinalizar conclusão e parar de iterar quando:
236
+ 1. Todos os critérios de DoD obrigatórios passam
237
+ 2. Os objetivos da tarefa são totalmente atendidos
238
+ 3. Os testes verificam a funcionalidade
239
+ 4. A documentação está atualizada
61
240
 
62
- - Funciona com `/common:ralph-run`
63
- - Integra com hooks Claude Code 2.1.23+
64
- - Compativel com `/sprint:dev`
241
+ NÃO continuar se:
242
+ - Limites do circuit breaker foram atingidos
243
+ - O monitor de saúde detecta problemas críticos
244
+ - Falhas repetidas indicam problema fundamental
245
+ - Intervenção humana é necessária
@@ -1,28 +1,28 @@
1
1
  ---
2
- description: Adicionar uma nova tecnologia ao claude-craft com best practices do Context7 e pesquisa web
3
- argument-hint: <nome-tecnologia>
2
+ description: Adicionar uma nova tecnologia ao claude-craft com boas práticas do Context7 e pesquisa web
3
+ argument-hint: <technology-name>
4
4
  ---
5
5
 
6
6
  # Adicionar Tecnologia
7
7
 
8
- Você é um especialista integrador de tecnologias para claude-craft. Sua missão é adicionar uma nova stack tecnológica:
9
- 1. Pesquisando best practices usando Context7 MCP e pesquisa web
10
- 2. Gerando todos os arquivos necessários (rules, commands, templates, skills, agents)
8
+ Você é um integrador de tecnologia especialista para o claude-craft. Sua missão é adicionar uma nova stack de tecnologia:
9
+ 1. Pesquisando boas práticas usando o Context7 MCP e pesquisa web
10
+ 2. Gerando todos os arquivos necessários (regras, comandos, templates, skills, agentes)
11
11
  3. Criando o script de instalação
12
- 4. Atualizando documentação e página de apresentação
12
+ 4. Atualizando a documentação e a landing page
13
13
 
14
14
  ## Argumentos
15
15
  $ARGUMENTS
16
16
 
17
17
  Argumentos:
18
- - `nome-tecnologia`: Nome da tecnologia a adicionar (ex: "nextjs", "nestjs", "golang", "laravel")
19
- - (Opcional) `categoria`: Categoria da tecnologia (frontend, backend, mobile, devops, fullstack)
18
+ - `technology-name`: Nome da tecnologia a ser adicionada (ex.: "nextjs", "nestjs", "golang", "laravel")
19
+ - (Opcional) `category`: Categoria da tecnologia (frontend, backend, mobile, devops, fullstack)
20
20
 
21
21
  Exemplo: `/common:add-technology "nestjs"` ou `/common:add-technology "golang" backend`
22
22
 
23
- ## Modo Plano
23
+ ## Modo de Planejamento
24
24
 
25
- > **O modo plano é obrigatório.** Antes de executar, Claude ativa o modo plano para analisar o código impactado, propor um plano de implementação e aguardar sua validação antes de realizar qualquer alteração.
25
+ > **O modo de planejamento é obrigatório.** Antes de executar, o Claude ativa o modo de planejamento para analisar o código impactado, propor um plano de implementação e aguardar sua validação antes de fazer qualquer alteração.
26
26
 
27
27
  ## MISSÃO
28
28
 
@@ -32,50 +32,50 @@ Identificar:
32
32
  - Nome oficial e aliases comuns
33
33
  - Tipo: framework, biblioteca, linguagem, ferramenta
34
34
  - Categoria: frontend, backend, mobile, devops, fullstack
35
- - Ecossistema: ferramentas relacionadas, frameworks de teste, opções de deploy
35
+ - Ecossistema: ferramentas relacionadas, frameworks de teste, opções de implantação
36
36
  - Público-alvo: web, mobile, API, CLI, etc.
37
37
 
38
- ### Passo 2: Pesquisar com Context7 (MCP)
38
+ ### Passo 2: Pesquisa com Context7 (MCP)
39
39
 
40
- **Usar Context7 para acessar documentação oficial:**
40
+ **Usar o Context7 para acessar a documentação oficial:**
41
41
 
42
42
  ```
43
43
  Consultar Context7 para:
44
- 1. Guia oficial de início
44
+ 1. Guia oficial de introdução
45
45
  2. Estrutura de projeto recomendada
46
- 3. Best practices e design patterns
46
+ 3. Boas práticas e padrões de design
47
47
  4. Estratégias de teste (unitário, integração, e2e)
48
- 5. Best practices de segurança
48
+ 5. Boas práticas de segurança
49
49
  6. Dicas de otimização de performance
50
- 7. Recomendações de deploy
50
+ 7. Recomendações de implantação
51
51
  ```
52
52
 
53
53
  #### Informações a Extrair
54
54
 
55
- | Tema | Detalhes a Encontrar |
56
- |------|---------------------|
55
+ | Tópico | Detalhes a Encontrar |
56
+ |--------|----------------------|
57
57
  | Arquitetura | Padrões recomendados (MVC, Clean, Hexagonal, etc.) |
58
- | Padrões de Código | Guia de estilo, convenções de nomenclatura, estrutura de arquivos |
58
+ | Padrões de Codificação | Guia de estilo, convenções de nomeação, estrutura de arquivos |
59
59
  | Ferramentas | Ferramentas CLI, formatadores, linters, bundlers |
60
60
  | Testes | Frameworks de teste, ferramentas de cobertura, estratégias de mock |
61
61
  | Segurança | Autenticação, autorização, vulnerabilidades comuns |
62
- | Qualidade | Análise estática, verificação de tipos, práticas de review |
62
+ | Qualidade | Análise estática, verificação de tipos, práticas de revisão de código |
63
63
 
64
64
  ### Passo 3: Complementar com Pesquisa Web
65
65
 
66
- **Buscar tendências 2026 e práticas da comunidade:**
66
+ **Pesquisar tendências de 2026 e práticas da comunidade:**
67
67
 
68
68
  1. **Últimas Tendências**
69
69
  - Versão estável atual
70
70
  - Recursos futuros
71
- - Avisos de deprecação
71
+ - Avisos de depreciação
72
72
  - Guias de migração
73
73
 
74
- 2. **Best Practices da Comunidade**
74
+ 2. **Boas Práticas da Comunidade**
75
75
  - Boilerplates populares
76
76
  - Configurações de produção
77
77
  - Benchmarks de performance
78
- - Arquiteturas reais
78
+ - Arquiteturas do mundo real
79
79
 
80
80
  3. **Armadilhas Comuns**
81
81
  - Erros frequentes
@@ -91,7 +91,7 @@ Consultar Context7 para:
91
91
 
92
92
  ### Passo 4: Gerar Arquivos da Tecnologia
93
93
 
94
- **Criar estrutura completa em 5 idiomas (en, fr, es, de, pt):**
94
+ **Criar a estrutura de arquivos completa em todos os 5 idiomas (en, fr, es, de, pt):**
95
95
 
96
96
  ```
97
97
  Dev/i18n/{lang}/{TECHNOLOGY}/
@@ -110,24 +110,45 @@ Dev/i18n/{lang}/{TECHNOLOGY}/
110
110
  │ ├── check-code-quality.md
111
111
  │ ├── check-testing.md
112
112
  │ ├── check-security.md
113
- │ └── [generate-*.md se aplicável]
113
+ │ └── [generate-*.md if applicable]
114
114
  ├── templates/
115
- │ └── [templates específicos da tecnologia]
115
+ │ └── [technology-specific templates]
116
116
  ├── checklists/
117
117
  │ ├── pre-commit.md
118
118
  │ └── new-feature.md
119
119
  ├── agents/
120
120
  │ └── {tech}-reviewer.md
121
121
  └── skills/
122
- └── [skills específicos da tecnologia]
122
+ └── [technology-specific skills]
123
123
  ```
124
124
 
125
+ #### Regras a Gerar
126
+
127
+ | Arquivo | Conteúdo |
128
+ |---------|----------|
129
+ | `02-architecture-{tech}.md` | Padrões de arquitetura, estrutura de pastas, princípios de arquitetura limpa |
130
+ | `03-coding-standards.md` | Guia de estilo, convenções de nomeação, organização de arquivos |
131
+ | `06-tooling.md` | Comandos CLI, formatadores, linters, ferramentas de build |
132
+ | `07-testing-{tech}.md` | Estratégias de teste, frameworks, requisitos de cobertura |
133
+ | `08-quality-tools.md` | Análise estática, verificação de tipos, integração CI/CD |
134
+ | `11-security-{tech}.md` | Práticas de segurança, vulnerabilidades comuns, autenticação |
135
+
136
+ #### Comandos a Gerar
137
+
138
+ | Comando | Propósito |
139
+ |---------|-----------|
140
+ | `check-compliance.md` | Auditoria completa de conformidade (pontuação /100) |
141
+ | `check-architecture.md` | Revisão de arquitetura |
142
+ | `check-code-quality.md` | Análise de qualidade do código |
143
+ | `check-testing.md` | Cobertura e qualidade de testes |
144
+ | `check-security.md` | Auditoria de segurança |
145
+
125
146
  ### Passo 5: Criar Script de Instalação
126
147
 
127
148
  **Gerar `Dev/scripts/install-{tech}-rules.sh`:**
128
149
 
129
150
  Seguir o padrão dos scripts existentes:
130
- - Suporte às opções `--lang`, `--force`, `--update`, `--dry-run`, `--backup`
151
+ - Suportar as opções `--lang`, `--force`, `--update`, `--dry-run`, `--backup`
131
152
  - Copiar regras genéricas de Common/
132
153
  - Copiar regras específicas da tecnologia
133
154
  - Gerar CLAUDE.md e 00-project-context.md
@@ -140,34 +161,58 @@ Seguir o padrão dos scripts existentes:
140
161
  | Arquivo | Alterações |
141
162
  |---------|------------|
142
163
  | `README.md` | Adicionar tecnologia à lista de stacks suportadas |
143
- | `docs/index.html` | Incrementar stats, adicionar card da tecnologia |
164
+ | `docs/index.html` | Incrementar estatísticas, adicionar card de tecnologia |
144
165
  | `docs/COMMANDS.md` | Documentar novos comandos |
145
166
  | `Makefile` | Adicionar target `install-{tech}` |
146
167
 
168
+ #### Atualizações da Landing Page (docs/index.html)
169
+
170
+ 1. **Seção de Estatísticas**: Incrementar o contador "Tech Stacks"
171
+ 2. **Grade de Tecnologias**: Adicionar novo card de tecnologia:
172
+
173
+ ```html
174
+ <div class="bg-slate-800/50 p-6 rounded-xl border border-white/5 hover:border-brand-500/50 transition-colors text-center group">
175
+ <div class="h-16 w-16 mx-auto bg-black rounded-full flex items-center justify-center mb-4 shadow-lg group-hover:scale-110 transition-transform">
176
+ <span class="text-2xl font-bold text-white">{ICON}</span>
177
+ </div>
178
+ <h3 class="font-bold text-white">{TECH_NAME}</h3>
179
+ <p class="text-xs text-slate-400 mt-2" data-i18n="tech_{tech}_desc">{DESCRIPTION}</p>
180
+ </div>
181
+ ```
182
+
183
+ 3. **Traduções**: Adicionar chaves i18n para todos os 5 idiomas
184
+
185
+ #### Target do Makefile
186
+
187
+ ```makefile
188
+ install-{tech}:
189
+ ./Dev/scripts/install-{tech}-rules.sh --lang=$(RULES_LANG) $(OPTIONS) $(TARGET)
190
+ ```
191
+
147
192
  ### Passo 7: Validação
148
193
 
149
- #### Checklist Definition of Done
194
+ #### Checklist de Definição de Pronto
150
195
 
151
196
  ```
152
197
  ══════════════════════════════════════════════════════════════
153
- DEFINITION OF DONE: Adicionar Tecnologia [{NOME_TECH}]
198
+ DEFINIÇÃO DE PRONTO: Adicionar Tecnologia [{TECH_NAME}]
154
199
  ══════════════════════════════════════════════════════════════
155
200
 
156
201
  📁 ARQUIVOS CRIADOS
157
202
  ──────────────────────────────────────────────────────────────
158
- - [ ] Rules (7 arquivos × 5 idiomas = 35 arquivos)
159
- - [ ] Commands (5 arquivos × 5 idiomas = 25 arquivos)
160
- - [ ] Templates (pelo menos 2 por idioma)
203
+ - [ ] Regras (7 arquivos × 5 idiomas = 35 arquivos)
204
+ - [ ] Comandos (5 arquivos × 5 idiomas = 25 arquivos)
205
+ - [ ] Templates (mínimo 2 por idioma)
161
206
  - [ ] Checklists (2 arquivos × 5 idiomas = 10 arquivos)
162
- - [ ] Agent {tech}-reviewer (1 arquivo × 5 idiomas = 5 arquivos)
207
+ - [ ] Agente {tech}-reviewer (1 arquivo × 5 idiomas = 5 arquivos)
163
208
  - [ ] CLAUDE.md.template (× 5 idiomas)
164
209
  - [ ] Script de instalação (Dev/scripts/install-{tech}-rules.sh)
165
210
 
166
211
  📄 DOCUMENTAÇÃO ATUALIZADA
167
212
  ──────────────────────────────────────────────────────────────
168
- - [ ] README.md: Tecnologia adicionada às stacks suportadas
169
- - [ ] docs/index.html: Stats incrementadas
170
- - [ ] docs/index.html: Card da tecnologia adicionado
213
+ - [ ] README.md: Tecnologia adicionada à lista de stacks suportadas
214
+ - [ ] docs/index.html: Estatísticas incrementadas
215
+ - [ ] docs/index.html: Card de tecnologia adicionado
171
216
  - [ ] docs/index.html: Traduções i18n adicionadas (5 idiomas)
172
217
  - [ ] docs/COMMANDS.md: Novos comandos documentados
173
218
  - [ ] Makefile: Target install-{tech} adicionado
@@ -175,25 +220,78 @@ Seguir o padrão dos scripts existentes:
175
220
  🧪 VERIFICAÇÃO
176
221
  ──────────────────────────────────────────────────────────────
177
222
  - [ ] Script de instalação executa sem erros
178
- - [ ] Todos os arquivos estão corretamente formatados
179
- - [ ] Comandos são funcionais
180
- - [ ] Documentação está correta
223
+ - [ ] Todos os arquivos estão devidamente formatados
224
+ - [ ] Os comandos são funcionais
225
+ - [ ] A documentação é precisa
226
+
227
+ ══════════════════════════════════════════════════════════════
228
+ ```
229
+
230
+ ### Formato de Saída
231
+
232
+ Após concluir todos os passos, fornecer:
233
+
234
+ ```
235
+ ══════════════════════════════════════════════════════════════
236
+ 🎉 TECNOLOGIA ADICIONADA: {TECH_NAME}
237
+ ══════════════════════════════════════════════════════════════
238
+
239
+ 📊 RESUMO
240
+ ──────────────────────────────────────────────────────────────
241
+ Tecnologia: {TECH_NAME}
242
+ Categoria: {CATEGORY}
243
+ Versão: {CURRENT_VERSION}
244
+
245
+ Arquivos criados: {COUNT}
246
+ - Regras: 35 arquivos
247
+ - Comandos: 25 arquivos
248
+ - Templates: {COUNT}
249
+ - Checklists: 10 arquivos
250
+ - Agentes: 5 arquivos
251
+
252
+ 📁 ESTRUTURA
253
+ ──────────────────────────────────────────────────────────────
254
+ Dev/i18n/
255
+ ├── en/{TECH}/
256
+ ├── fr/{TECH}/
257
+ ├── es/{TECH}/
258
+ ├── de/{TECH}/
259
+ └── pt/{TECH}/
260
+
261
+ Dev/scripts/
262
+ └── install-{tech}-rules.sh
263
+
264
+ 🔧 INSTALAÇÃO
265
+ ──────────────────────────────────────────────────────────────
266
+ # Via Makefile
267
+ make install-{tech} TARGET=~/my-project RULES_LANG=en
268
+
269
+ # Script direto
270
+ ./Dev/scripts/install-{tech}-rules.sh ~/my-project
271
+
272
+ 📚 DOCUMENTAÇÃO
273
+ ──────────────────────────────────────────────────────────────
274
+ - README.md ✅ Atualizado
275
+ - docs/index.html ✅ Atualizado
276
+ - docs/COMMANDS.md ✅ Atualizado
277
+ - Makefile ✅ Atualizado
181
278
 
279
+ ✅ DEFINIÇÃO DE PRONTO: CONCLUÍDA
182
280
  ══════════════════════════════════════════════════════════════
183
281
  ```
184
282
 
185
283
  ### Diretrizes Importantes
186
284
 
187
- 1. **Pesquisar primeiro** - Sempre usar Context7 e pesquisa web antes de gerar arquivos
188
- 2. **Seguir padrões** - Usar tecnologias existentes (React, Symfony, Flutter) como modelos
189
- 3. **5 idiomas** - Gerar conteúdo para en, fr, es, de, pt
190
- 4. **Qualidade sobre velocidade** - Garantir que todos os arquivos estejam formatados corretamente
191
- 5. **Atualizar tudo** - Não esquecer documentação e página inicial
285
+ 1. **Pesquisar Primeiro** - Sempre usar o Context7 e a pesquisa web antes de gerar arquivos
286
+ 2. **Seguir Padrões** - Usar tecnologias existentes (React, Symfony, Flutter) como modelos
287
+ 3. **Todos os 5 Idiomas** - Gerar conteúdo para en, fr, es, de, pt
288
+ 4. **Qualidade antes da Velocidade** - Garantir que todos os arquivos estejam devidamente formatados e funcionais
289
+ 5. **Atualizar Tudo** - Não esquecer a documentação e a landing page
192
290
 
193
291
  ### Tratamento de Erros
194
292
 
195
293
  Se a pesquisa falhar:
196
- - Indicar claramente qual informação está faltando
294
+ - Indicar claramente quais informações estão faltando
197
295
  - Propor fontes alternativas
198
- - Pedir esclarecimentos ao usuário se necessário
199
- - NUNCA gerar arquivos com conteúdo placeholder ou inventado
296
+ - Pedir esclarecimento ao usuário se necessário
297
+ - NUNCA gerar arquivos com conteúdo de placeholder ou inventado