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

package/Dev/i18n/pt/Flutter/commands/analyze-performance.md

@@ -1,76 +1,361 @@
 ---
-description: Analisar Performance do Aplicativo Flutter
+description: Análise de Performance Flutter
+argument-hint: [arguments]
 ---
 
-# Analisar Performance do Aplicativo Flutter
+# Análise de Performance Flutter
 
-Analise a performance do aplicativo Flutter, identifique gargalos de renderização, problemas de memória e oportunidades de otimização.
+Você é um especialista em performance Flutter. Você deve analisar o desempenho da aplicação, identificar problemas (jank, vazamentos de memória, rebuilds desnecessários) e propor otimizações.
 
-## Ações a Realizar
+## Argumentos
+$ARGUMENTS
 
-### 1. Análise de Renderização
+Argumentos:
+- (Opcional) Foco: rendering, memory, network, all
+
+Exemplo: `/flutter:analyze-performance rendering`
+
+## Plan Mode
+
+> O modo de planejamento é ativado automaticamente quando o escopo abrange múltiplos módulos ou requer uma investigação transversal.
+
+## MISSÃO
+
+### Etapa 1: Coleta de Métricas
 
 ```bash
 # Executar em modo profile
 flutter run --profile
 
-# No DevTools, verificar:
-# - Frame rendering time
-# - Rebuild Count
-# - Layer Count
+# DevTools
+flutter pub global activate devtools
+dart devtools
+
+# Analisar o código
+dart analyze --fatal-infos
 ```
 
-### 2. Análise de Memória
+### Etapa 2: Análise de Renderização
 
-```bash
-# Memory profiler no DevTools
-# Verificar:
-# - Memory leaks
-# - Heap snapshots
-# - Allocation tracking
+#### Identificar Rebuilds Desnecessários
+
+```dart
+// Adicionar no main.dart para debug
+import 'package:flutter/rendering.dart';
+
+void main() {
+  debugProfileBuildsEnabled = true;  // Log dos builds
+  debugPrintRebuildDirtyWidgets = true;  // Log dos rebuilds
+  runApp(const MyApp());
+}
 ```
 
-### 3. Verificar Otimização de Widgets
+#### Problemas Comuns e Soluções
 
-```bash
-# Buscar widgets sem const
-grep -r "Widget build" lib/ | grep -v "const"
+##### 1. Rebuilds em Cascata
 
-# Buscar ListView sem builder
-grep -r "ListView(" lib/ | grep -v "ListView.builder"
+```dart
+// ❌ BAD - Tudo reconstrói a cada mudança
+class ParentWidget extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return Consumer<MyModel>(
+      builder: (context, model, _) => Column(
+        children: [
+          HeaderWidget(title: model.title),
+          BodyWidget(items: model.items),
+          FooterWidget(), // Rebuild desnecessário!
+        ],
+      ),
+    );
+  }
+}
+
+// ✅ GOOD - Granularidade fina
+class ParentWidget extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        Selector<MyModel, String>(
+          selector: (_, model) => model.title,
+          builder: (_, title, __) => HeaderWidget(title: title),
+        ),
+        Selector<MyModel, List<Item>>(
+          selector: (_, model) => model.items,
+          builder: (_, items, __) => BodyWidget(items: items),
+        ),
+        const FooterWidget(), // const = sem rebuild
+      ],
+    );
+  }
+}
 ```
 
-### 4. Análise de Build
+##### 2. ListView Não Otimizada
 
-```bash
-# Analisar tamanho do bundle
-flutter build apk --analyze-size
-flutter build appbundle --analyze-size
+```dart
+// ❌ BAD - Cria todos os widgets de uma vez
+ListView(
+  children: items.map((item) => ItemWidget(item: item)).toList(),
+)
+
+// ✅ GOOD - Lazy loading
+ListView.builder(
+  itemCount: items.length,
+  itemBuilder: (context, index) => ItemWidget(item: items[index]),
+  // Otimizações adicionais
+  cacheExtent: 500, // Pré-renderização
+  addAutomaticKeepAlives: false, // Se não precisar manter o estado
+)
+
+// ✅ AINDA MELHOR - Com tamanho fixo
+ListView.builder(
+  itemCount: items.length,
+  itemExtent: 80, // Altura fixa = cálculo otimizado
+  itemBuilder: (context, index) => ItemWidget(item: items[index]),
+)
+```
+
+##### 3. Imagens Não Otimizadas
+
+```dart
+// ❌ BAD
+Image.network(
+  'https://example.com/large_image.jpg',
+)
+
+// ✅ GOOD - Com cache e redimensionamento
+CachedNetworkImage(
+  imageUrl: 'https://example.com/large_image.jpg',
+  cacheWidth: 300, // Redimensionamento em memória
+  cacheHeight: 300,
+  memCacheWidth: 300,
+  placeholder: (context, url) => const Shimmer(),
+  errorWidget: (context, url, error) => const Icon(Icons.error),
+)
+```
+
+### Etapa 3: Análise de Memória
+
+#### Detectar Vazamentos de Memória
+
+```dart
+// Verificar os dispose() ausentes
+class _MyWidgetState extends State<MyWidget> {
+  late StreamSubscription _subscription;
+  late AnimationController _controller;
+  Timer? _timer;
+
+  @override
+  void initState() {
+    super.initState();
+    _subscription = stream.listen((_) {});
+    _controller = AnimationController(vsync: this);
+    _timer = Timer.periodic(Duration(seconds: 1), (_) {});
+  }
+
+  @override
+  void dispose() {
+    _subscription.cancel();  // ✅ Importante!
+    _controller.dispose();   // ✅ Importante!
+    _timer?.cancel();        // ✅ Importante!
+    super.dispose();
+  }
+}
+```
+
+#### Padrões Problemáticos
+
+```dart
+// ❌ BAD - Closure captura o context
+onPressed: () async {
+  await longOperation();
+  Navigator.of(context).pop(); // context pode ser inválido!
+}
+
+// ✅ GOOD - Verificar o mounted
+onPressed: () async {
+  await longOperation();
+  if (mounted) {
+    Navigator.of(context).pop();
+  }
+}
+```
+
+### Etapa 4: Otimizações Recomendadas
 
-# Web bundle
-flutter build web --source-maps
+#### Checklist de Otimização de Widgets
+
+```dart
+// 1. Usar const sempre que possível
+const MyWidget(); // ✅
+
+// 2. RepaintBoundary para partes custosas
+RepaintBoundary(
+  child: ExpensiveWidget(),
+)
+
+// 3. Separar os widgets que mudam com frequência
+class OptimizedWidget extends StatelessWidget {
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: [
+        const StaticHeader(),      // Nunca reconstrói
+        const AnimatedCounter(),   // Isolado
+        const StaticFooter(),      // Nunca reconstrói
+      ],
+    );
+  }
+}
+
+// 4. Evitar builds dentro de builds
+// ❌ BAD
+build(context) {
+  final items = generateItems(); // Chamado a cada build!
+  return ListView.builder(...);
+}
+
+// ✅ GOOD
+late final items = generateItems(); // Apenas uma vez
+
+// 5. Usar Keys corretamente
+ListView.builder(
+  itemBuilder: (context, index) => ItemWidget(
+    key: ValueKey(items[index].id), // Key estável
+    item: items[index],
+  ),
+)
+```
+
+### Etapa 5: Gerar o Relatório
+
+```
+══════════════════════════════════════════════════════════════
+📊 RELATÓRIO DE PERFORMANCE FLUTTER
+══════════════════════════════════════════════════════════════
+
+──────────────────────────────────────────────────────────────
+🎯 MÉTRICAS DE RENDERIZAÇÃO
+──────────────────────────────────────────────────────────────
+
+| Página  | Build Time | Raster Time | FPS | Status |
+|---------|------------|-------------|-----|--------|
+| Home    | 8ms        | 12ms        | 60  | ✅     |
+| List    | 45ms       | 35ms        | 45  | ⚠️     |
+| Detail  | 15ms       | 18ms        | 58  | ✅     |
+
+Limites:
+- Build < 16ms : ✅
+- Build > 16ms : ⚠️ Jank possível
+- Build > 32ms : ❌ Jank visível
+
+──────────────────────────────────────────────────────────────
+🧠 MÉTRICAS DE MEMÓRIA
+──────────────────────────────────────────────────────────────
+
+| Métrica        | Valor  | Limite   | Status |
+|----------------|--------|----------|--------|
+| Heap Used      | 85MB   | < 150MB  | ✅     |
+| Heap Capacity  | 120MB  | < 200MB  | ✅     |
+| External       | 25MB   | < 50MB   | ✅     |
+| RSS            | 180MB  | < 300MB  | ✅     |
+
+──────────────────────────────────────────────────────────────
+⚠️ PROBLEMAS DETECTADOS
+──────────────────────────────────────────────────────────────
+
+### Crítico
+1. **Rebuilds excessivos** - ProductListPage
+   - 150 rebuilds/seg detectados
+   - Causa: Provider no nível errado
+   - Correção: Usar Selector ou Consumer granular
+
+### Importante
+2. **ListView não otimizada** - OrderHistoryPage
+   - Sem itemExtent definido
+   - 500+ itens sem lazy loading
+   - Correção: ListView.builder com itemExtent
+
+3. **Imagens sem cache** - ProductCard
+   - Image.network sem cache
+   - Correção: Usar cached_network_image
+
+### Menor
+4. **Widgets não const** - AppBar customizada
+   - 5 widgets podem ser const
+   - Correção: Adicionar a palavra-chave const
+
+──────────────────────────────────────────────────────────────
+🔧 OTIMIZAÇÕES SUGERIDAS
+──────────────────────────────────────────────────────────────
+
+### 1. ProductListPage - Rebuilds (Impacto: Alto)
+```dart
+// Antes
+Consumer<CartModel>(
+  builder: (_, cart, __) => ProductList(cart: cart),
+)
+
+// Depois
+Selector<CartModel, int>(
+  selector: (_, cart) => cart.itemCount,
+  builder: (_, count, child) => child!,
+  child: const ProductList(),
+)
 ```
 
-## Modo Plano
+### 2. OrderHistoryPage - ListView (Impacto: Alto)
+```dart
+// Antes
+ListView(children: orders.map((o) => OrderTile(o)).toList())
 
-> O modo plano é ativado automaticamente quando o escopo abrange vários módulos ou requer investigação transversal.
+// Depois
+ListView.builder(
+  itemCount: orders.length,
+  itemExtent: 72,
+  itemBuilder: (_, i) => OrderTile(orders[i]),
+)
+```
+
+### 3. ProductCard - Imagens (Impacto: Médio)
+```dart
+// Antes
+Image.network(product.imageUrl)
 
-## Relatório de Saída
+// Depois
+CachedNetworkImage(
+  imageUrl: product.imageUrl,
+  cacheWidth: 200,
+  memCacheWidth: 200,
+)
+```
 
-Gere um relatório contendo:
+──────────────────────────────────────────────────────────────
+📈 IMPACTO ESTIMADO
+──────────────────────────────────────────────────────────────
 
-1. **Problemas de Performance Identificados**
-   - Widgets não otimizados
-   - Rebuilds desnecessários
-   - Problemas de memória
+| Otimização               | Antes | Depois | Ganho |
+|--------------------------|-------|--------|-------|
+| ProductListPage FPS      | 45    | 60     | +33%  |
+| Memória de imagens       | 85MB  | 45MB   | -47%  |
+| Time to interactive      | 2.5s  | 1.8s   | -28%  |
 
-2. **Métricas**
-   - Tempo médio de frame
-   - Uso de memória
-   - Tamanho do app
+──────────────────────────────────────────────────────────────
+📋 COMANDOS ÚTEIS
+──────────────────────────────────────────────────────────────
 
-3. **Recomendações**
-   - Adicionar const
-   - Usar builders
-   - RepaintBoundary onde necessário
-   - Otimização de imagens
+# Profiling
+flutter run --profile
+flutter analyze
+
+# DevTools
+flutter pub global activate devtools
+dart devtools
+
+# Performance overlay
+MaterialApp(
+  showPerformanceOverlay: true,
+)
+```

package/Dev/i18n/pt/Flutter/commands/check-compliance.md

@@ -1,48 +1,253 @@
 ---
-description: Verificar Conformidade com Padrões Flutter
+description: Verificar Conformidade Completa do Flutter
+argument-hint: [arguments]
 ---
 
-# Verificar Conformidade com Padrões Flutter
+# Verificar Conformidade Completa do Flutter
 
-Verifique se o projeto está em conformidade com os padrões e guidelines oficiais do Flutter e Dart.
+## Argumentos
 
-## Verificações
+$ARGUMENTS (opcional: caminho para o projeto a analisar)
 
-### 1. Effective Dart
+## Modo de Planejamento
 
-- [ ] Style guide seguido
-- [ ] Documentation presente
-- [ ] Usage guidelines respeitados
-- [ ] Design patterns apropriados
+> O modo de planejamento é ativado automaticamente quando o escopo abrange múltiplos módulos ou requer investigação transversal.
 
-### 2. Flutter Best Practices
+## MISSÃO
 
-- [ ] Widget composition adequada
-- [ ] Estado gerenciado corretamente
-- [ ] BuildContext usado apropriadamente
-- [ ] Keys usadas quando necessário
+Realizar uma auditoria de conformidade completa do projeto Flutter orquestrando as 4 verificações principais: Arquitetura, Qualidade de Código, Testes e Segurança. Produzir um relatório consolidado com uma pontuação geral de 100 pontos.
 
-### 3. Dependências
+### Etapa 1: Preparação da Auditoria
 
-```bash
-# Verificar dependências
-flutter pub outdated
+Preparar o ambiente de auditoria:
+- [ ] Identificar o caminho do projeto a auditar
+- [ ] Verificar a presença dos arquivos de configuração (pubspec.yaml, analysis_options.yaml)
+- [ ] Listar os diretórios principais (lib/, test/, android/, ios/, etc.)
+- [ ] Identificar a estrutura do projeto e a versão do Flutter
+
+**Nota**: Se $ARGUMENTS for fornecido, usá-lo como caminho do projeto; caso contrário, usar o diretório atual.
+
+### Etapa 2: Auditoria de Arquitetura (25 pontos)
+
+Executar a verificação completa de arquitetura:
+
+**Comando**: Usar o slash command `/flutter:check-architecture` ou seguir manualmente as etapas em `check-architecture.md`
+
+**Critérios Avaliados**:
+- Organização das camadas de Clean Architecture (6 pts)
+- Separação Domain/Data/Presentation (6 pts)
+- Injeção de dependências (get_it, injectable, riverpod) (4 pts)
+- Estrutura modular baseada em features (4 pts)
+- Princípios SOLID na arquitetura (3 pts)
+- Utilitários Core/Shared (2 pts)
+
+**Referência**: `check-architecture.md`
+
+### Etapa 3: Auditoria de Qualidade de Código (25 pontos)
+
+Executar a verificação de qualidade de código:
+
+**Comando**: Usar o slash command `/flutter:check-code-quality` ou seguir manualmente as etapas em `check-code-quality.md`
+
+**Critérios Avaliados**:
+- Convenções Effective Dart (5 pts)
+- Flutter analyze (zero avisos) (5 pts)
+- Rigor de linting e analysis_options (4 pts)
+- Princípios KISS/DRY/YAGNI (4 pts)
+- Documentação com comentários /// (4 pts)
+- Tratamento de erros (3 pts)
+
+**Referência**: `check-code-quality.md`
+
+### Etapa 4: Auditoria de Testes (25 pontos)
+
+Executar a verificação de testes:
+
+**Comando**: Usar o slash command `/flutter:check-testing` ou seguir manualmente as etapas em `check-testing.md`
+
+**Critérios Avaliados**:
+- Cobertura de código (7 pts)
+- Testes unitários para domain e data (6 pts)
+- Testes de widget para UI (4 pts)
+- Testes de integração (3 pts)
+- Qualidade dos testes e padrão AAA (3 pts)
+- Mocks (mockito/mocktail) e fixtures (2 pts)
+
+**Referência**: `check-testing.md`
+
+### Etapa 5: Auditoria de Segurança (25 pontos)
+
+Executar a verificação de segurança:
+
+**Comando**: Usar o slash command `/flutter:check-security` ou seguir manualmente as etapas em `check-security.md`
+
+**Critérios Avaliados**:
+- Segredos e credenciais hardcoded (6 pts)
+- Segurança de rede (HTTPS, SSL/TLS) (5 pts)
+- Armazenamento de dados sensíveis (flutter_secure_storage) (4 pts)
+- Vulnerabilidades de dependências (4 pts)
+- Permissões de plataforma (Android/iOS) (3 pts)
+- Validação de entrada (2 pts)
+- Ofuscação no release (1 pt)
+
+**Referência**: `check-security.md`
+
+### Etapa 6: Consolidação e Pontuação Global
+
+Calcular a pontuação geral e produzir o relatório consolidado:
+- [ ] Somar as 4 pontuações (máximo 100 pontos)
+- [ ] Identificar categorias críticas (<50%)
+- [ ] Listar todos os problemas transversais críticos
+- [ ] Priorizar ações por impacto/esforço
+- [ ] Produzir o relatório final consolidado
+
+**Escala de Avaliação**:
+- 90-100: Excelente - Projeto de referência
+- 75-89: Muito Bom - Pequenas melhorias necessárias
+- 60-74: Aceitável - Requer melhorias
+- 40-59: Insuficiente - Refatoração significativa necessária
+- 0-39: Crítico - Reformulação completa necessária
+
+### Etapa 7: Recomendações e Plano de Ação
+
+Produzir recomendações finais:
+- [ ] Identificar as 3 ações prioritárias em todas as categorias
+- [ ] Estimar esforço (Baixo/Médio/Alto) para cada ação
+- [ ] Estimar impacto (Baixo/Médio/Alto) para cada ação
+- [ ] Propor ordem de implementação
+- [ ] Sugerir quick wins (alta relação impacto/esforço)
+
+## FORMATO DE SAÍDA
 
-# Verificar licenças
-flutter pub deps --json | jq '.packages[].license'
 ```
+AUDITORIA DE CONFORMIDADE FLUTTER - RELATÓRIO COMPLETO
+=============================================
+
+PONTUAÇÃO GERAL: XX/100
+
+NÍVEL DE CONFORMIDADE: [Excelente/Muito Bom/Aceitável/Insuficiente/Crítico]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+PONTUAÇÕES POR CATEGORIA:
 
-### 4. Configurações de Build
+ARQUITETURA        : XX/25  [██████████░░░░░░░░░░] XX%
+QUALIDADE DE CÓDIGO: XX/25  [██████████░░░░░░░░░░] XX%
+TESTES             : XX/25  [██████████░░░░░░░░░░] XX%
+SEGURANÇA          : XX/25  [██████████░░░░░░░░░░] XX%
 
-- [ ] analysis_options.yaml presente e configurado
-- [ ] pubspec.yaml bem estruturado
-- [ ] README.md completo
-- [ ] CHANGELOG.md atualizado
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-## Modo Plano
+PONTOS FORTES GERAIS:
+1. [Ponto forte identificado em múltiplas categorias]
+2. [Outro ponto forte importante]
+3. [Terceiro ponto forte]
 
-> O modo plano é ativado automaticamente quando o escopo abrange vários módulos ou requer investigação transversal.
+MELHORIAS GERAIS:
+1. [Melhoria transversal menor]
+2. [Outra melhoria recomendada]
+3. [Terceira melhoria]
+
+PROBLEMAS CRÍTICOS:
+1. [Problema crítico #1 - categoria afetada]
+2. [Problema crítico #2 - categoria afetada]
+3. [Problema crítico #3 - categoria afetada]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+DETALHES POR CATEGORIA:
+
+┌─────────────────────────────────────────────┐
+│ ARQUITETURA (XX/25)                         │
+└─────────────────────────────────────────────┘
+
+Sub-pontuações:
+  • Camadas Clean Architecture   : XX/6
+  • Separação de camadas         : XX/6
+  • Injeção de dependências      : XX/4
+  • Módulos baseados em features : XX/4
+  • Princípios SOLID             : XX/3
+  • Utilitários Core/Shared      : XX/2
+
+Pontos Fortes:
+- [Pontos fortes de arquitetura]
+
+Problemas:
+- [Problemas de arquitetura]
+
+[Seções similares para Qualidade de Código, Testes e Segurança...]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+TOP 3 AÇÕES PRIORITÁRIAS (TODAS AS CATEGORIAS):
+
+1. CRÍTICO - [Ação #1]
+   Categoria : [Arquitetura/Qualidade/Testes/Segurança]
+   Impacto   : [Alto/Médio/Baixo]
+   Esforço   : [Alto/Médio/Baixo]
+   Prioridade: IMEDIATA
+
+   Descrição detalhada:
+   [Explicação do problema e solução proposta]
+
+   Arquivos afetados:
+   - [arquivo:linha]
+
+   Exemplo de correção:
+   [Código ou comando de correção]
+
+2. IMPORTANTE - [Ação #2]
+   [Mesmo formato...]
+
+3. RECOMENDADO - [Ação #3]
+   [Mesmo formato...]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+QUICK WINS (Alto Impacto / Baixo Esforço):
+
+- [Quick win #1] - Categoria: [X] - Impacto: [X] - Esforço: [X]
+- [Quick win #2] - Categoria: [X] - Impacto: [X] - Esforço: [X]
+- [Quick win #3] - Categoria: [X] - Impacto: [X] - Esforço: [X]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+PLANO DE AÇÃO RECOMENDADO:
+
+SEMANA 1 (Imediato):
+- [ ] [Ação crítica #1]
+- [ ] [Quick win prioritário]
+
+SEMANAS 2-4 (Curto prazo):
+- [ ] [Ação importante #2]
+- [ ] [Outros quick wins]
+
+MESES 2-3 (Médio prazo):
+- [ ] [Ação recomendada #3]
+- [ ] [Melhorias progressivas]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+RESUMO EXECUTIVO:
+
+[Parágrafo de resumo sobre o estado geral do projeto, pontos fortes
+principais, principais fraquezas e trajetória recomendada para melhorar
+a conformidade. Indicar se o projeto está pronto para produção,
+requer correções ou precisa de refatoração.]
+
+Recomendação Geral: [Pronto para produção / Correções menores /
+Refatoração significativa / Reformulação necessária]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
 
-## Relatório
+## NOTAS IMPORTANTES
 
-Gere checklist de conformidade indicando status de cada área.
+- Este comando orquestra as 4 auditorias especializadas
+- Usar Docker para todas as ferramentas de análise
+- Fornecer exemplos concretos com arquivo:linha para cada problema
+- Priorizar ações com base na matriz de Impacto/Esforço
+- Problemas de segurança são SEMPRE a prioridade máxima
+- Propor correções automatizáveis (scripts, pre-commit hooks)
+- O relatório deve ser acionável, não apenas descritivo
+- Adaptar as recomendações ao contexto de negócio do projeto