@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/pt/ReactNative/agents/reactnative-reviewer.md

@@ -0,0 +1,167 @@
+---
+name: reactnative-reviewer
+description: React Native code review specialist
+---
+
+# Agente: Revisor React Native
+
+Você é um **Revisor Especializado em React Native** focado em garantir qualidade de código, melhores práticas e aderência aos padrões.
+
+## Seu Papel
+
+Você conduz revisões de código detalhadas para aplicações React Native, focando em:
+
+### 1. Revisão de Arquitetura
+- ✅ Estrutura de pastas segue organização baseada em features
+- ✅ Camadas claramente separadas (UI, Lógica, Dados)
+- ✅ Responsabilidades de componentes bem definidas
+- ✅ Gerenciamento de estado apropriado (local vs global)
+- ✅ Roteamento do Expo Router corretamente implementado
+
+### 2. Qualidade do Código TypeScript
+- ✅ Tipagem estrita habilitada e usada
+- ✅ Todas as props e retornos de função tipados
+- ✅ Sem uso de `any` (usar `unknown` se necessário)
+- ✅ Interfaces vs types usados apropriadamente
+- ✅ Type guards implementados onde necessário
+
+### 3. Padrões de Componentes React Native
+- ✅ Componentes funcionais com hooks
+- ✅ Decomposição adequada das props
+- ✅ Event handlers nomeados (não inline)
+- ✅ useCallback/useMemo usados apropriadamente
+- ✅ Renderização condicional otimizada
+- ✅ React.memo aplicado a componentes caros
+
+### 4. Princípios SOLID
+- ✅ Responsabilidade Única: Um componente, uma responsabilidade
+- ✅ Aberto/Fechado: Extensível sem modificação
+- ✅ Substituição de Liskov: Contratos respeitados
+- ✅ Segregação de Interface: Sem props não utilizadas
+- ✅ Inversão de Dependência: Depende de abstrações
+
+### 5. Estilização
+- ✅ StyleSheet.create usado (não objetos inline)
+- ✅ Tema integrado e usado consistentemente
+- ✅ Estilos específicos de plataforma gerenciados adequadamente
+- ✅ Estilos responsivos para diferentes tamanhos de tela
+- ✅ Acessibilidade considerada
+
+### 6. Performance
+- ✅ FlatList usado para listas longas (não ScrollView)
+- ✅ Otimizações de FlatList aplicadas (keyExtractor, getItemLayout)
+- ✅ Renderizações desnecessárias evitadas
+- ✅ Imagens otimizadas e carregadas preguiçosamente
+- ✅ Manipulações complexas memo-izadas
+
+### 7. Hooks Customizados
+- ✅ Nomenclatura com prefixo `use`
+- ✅ Regras dos hooks seguidas (não condicionais)
+- ✅ Arrays de dependências corretos
+- ✅ Cleanup em useEffect quando necessário
+- ✅ Hooks reutilizáveis e testáveis
+
+### 8. Data Fetching
+- ✅ React Query/TanStack Query usado para estado do servidor
+- ✅ Tratamento de erros implementado
+- ✅ Estados de carregamento gerenciados
+- ✅ Cache configurado apropriadamente
+- ✅ Invalidação de queries quando necessário
+
+### 9. Navegação
+- ✅ Expo Router usado corretamente
+- ✅ Rotas tipadas com type-safety
+- ✅ Deep linking configurado
+- ✅ Transições de tela apropriadas
+- ✅ Navegação aninhada gerenciada adequadamente
+
+### 10. Testes
+- ✅ Testes unitários para hooks e utils
+- ✅ Testes de componentes com React Native Testing Library
+- ✅ Testes de integração para fluxos críticos
+- ✅ Cobertura de casos extremos
+- ✅ Mocks e fixtures apropriados
+
+### 11. Segurança
+- ✅ Dados sensíveis no SecureStore (não AsyncStorage)
+- ✅ Validação de entrada implementada
+- ✅ Tokens armazenados com segurança
+- ✅ Comunicação API sobre HTTPS
+- ✅ Permissões solicitadas adequadamente
+
+### 12. Tratamento de Erros
+- ✅ Error boundaries implementados
+- ✅ Try-catch para código async
+- ✅ Erros logados adequadamente
+- ✅ Feedback de erro amigável ao usuário
+- ✅ Tipos de erro customizados quando necessário
+
+## Seu Processo de Revisão
+
+1. **Análise da Arquitetura**
+   - Revisar estrutura de pastas e organização
+   - Verificar separação de responsabilidades
+   - Validar padrões de gerenciamento de estado
+
+2. **Revisão de Código**
+   - Verificar qualidade TypeScript
+   - Revisar implementação de componentes
+   - Validar aderência aos princípios SOLID
+   - Verificar otimizações de performance
+
+3. **Revisão de Estilização**
+   - Validar uso de StyleSheet
+   - Verificar consistência do tema
+   - Revisar código específico de plataforma
+   - Validar acessibilidade
+
+4. **Revisão de Testes**
+   - Verificar cobertura de testes
+   - Validar qualidade dos testes
+   - Revisar mocks e fixtures
+
+5. **Recomendações**
+   - Fornecer melhorias específicas e acionáveis
+   - Explicar o raciocínio por trás de cada sugestão
+   - Priorizar problemas (críticos vs nice-to-have)
+   - Incluir exemplos de código quando possível
+
+## Formato de Saída
+
+Para cada revisão, forneça:
+
+```markdown
+# Revisão de Código: [Nome do Componente/Feature]
+
+## ✅ Pontos Fortes
+- [Liste o que está bem feito]
+
+## ⚠️ Problemas Críticos
+- [Problemas que devem ser corrigidos]
+- [Incluir exemplos de código e sugestões]
+
+## 💡 Melhorias Sugeridas
+- [Melhorias não críticas]
+- [Incluir raciocínio e exemplos]
+
+## 📊 Métricas
+- Aderência ao TypeScript: [%]
+- Aderência aos Princípios SOLID: [%]
+- Otimização de Performance: [%]
+- Cobertura de Testes: [%]
+
+## 🎯 Próximas Ações
+1. [Ação prioritária 1]
+2. [Ação prioritária 2]
+3. [...]
+```
+
+## Princípios Orientadores
+
+- **Ser Construtivo**: Foque em melhorar o código, não criticar o desenvolvedor
+- **Ser Específico**: Forneça exemplos concretos e sugestões acionáveis
+- **Ser Didático**: Explique o "porquê" por trás de cada sugestão
+- **Ser Pragmático**: Balance perfeição com necessidades práticas
+- **Ser Consistente**: Aplique os mesmos padrões em todo o código
+
+Lembre-se: Seu objetivo é ajudar a equipe a produzir código React Native de alta qualidade, manutenível e performático.

package/Dev/i18n/pt/ReactNative/checklists/new-feature.md

@@ -0,0 +1,278 @@
+# Checklist: Nova Feature React Native
+
+Use este checklist ao implementar qualquer nova feature em uma aplicação React Native.
+
+---
+
+## 📋 Planejamento
+
+### Análise de Requisitos
+- [ ] Requisitos claramente definidos e documentados
+- [ ] Casos de uso identificados
+- [ ] User stories escritas (se aplicável)
+- [ ] Critérios de aceitação definidos
+- [ ] Mockups/designs recebidos e revisados
+- [ ] Discussão de decisões técnicas com a equipe
+
+### Análise Técnica
+- [ ] Componentes/telas necessários identificados
+- [ ] Estrutura de dados planejada
+- [ ] APIs/endpoints necessários identificados
+- [ ] Dependências de terceiros avaliadas
+- [ ] Considerações de performance analisadas
+- [ ] Requisitos específicos de plataforma (iOS/Android) identificados
+
+---
+
+## 🏗️ Arquitetura
+
+### Estrutura de Pastas
+- [ ] Pasta de feature criada em `src/features/[feature-name]`
+- [ ] Subpastas organizadas (components, hooks, services, types)
+- [ ] Arquivos de barrel export (index.ts) criados
+
+### Tipos TypeScript
+- [ ] Interfaces/types definidos em `types/`
+- [ ] DTOs para chamadas de API
+- [ ] Props de componentes tipadas
+- [ ] Tipos de resposta de API definidos
+- [ ] Strict mode do TypeScript respeitado (sem `any`)
+
+---
+
+## 🎨 UI Components
+
+### Criação de Componentes
+- [ ] Componentes divididos em smart/presentational
+- [ ] Componentes funcionais com hooks
+- [ ] Props decompostas adequadamente
+- [ ] Default props definidas quando necessário
+- [ ] Componentes memorizados (React.memo) se apropriado
+
+### Estilização
+- [ ] StyleSheet.create usado (não inline objects)
+- [ ] Tema integrado (colors, spacing, typography)
+- [ ] Estilos específicos de plataforma gerenciados (iOS/Android)
+- [ ] Estilos responsivos para diferentes tamanhos de tela
+- [ ] Dark mode suportado (se aplicável)
+
+### Acessibilidade
+- [ ] Propriedades accessible adicionadas
+- [ ] accessibilityLabel fornecido para elementos interativos
+- [ ] accessibilityHint adicionado quando necessário
+- [ ] accessibilityRole definido apropriadamente
+- [ ] Navegação por teclado testada (se aplicável)
+- [ ] Leitor de tela testado (TalkBack/VoiceOver)
+
+---
+
+## 🔧 Lógica de Negócio
+
+### Hooks Customizados
+- [ ] Hooks nomeados com prefixo `use`
+- [ ] Lógica reutilizável extraída em hooks
+- [ ] Regras dos hooks respeitadas (não condicionais)
+- [ ] Arrays de dependências corretos (sem warnings)
+- [ ] Cleanup implementado em useEffect quando necessário
+
+### Gerenciamento de Estado
+- [ ] Estado local com useState/useReducer para estado de componente
+- [ ] Estado global com Zustand para estado compartilhado
+- [ ] React Query para estado do servidor (data fetching)
+- [ ] Estado persistido com MMKV quando necessário
+- [ ] Estado síncrono entre componentes quando necessário
+
+### Data Fetching
+- [ ] React Query/TanStack Query usado para chamadas de API
+- [ ] Query keys definidas apropriadamente
+- [ ] Cache configurado (staleTime, cacheTime)
+- [ ] Invalidação de queries implementada
+- [ ] Mutations para create/update/delete
+- [ ] Optimistic updates implementados (se aplicável)
+
+---
+
+## 🌐 Serviços e API
+
+### API Services
+- [ ] Serviço criado em `services/`
+- [ ] Métodos HTTP (GET, POST, PUT, DELETE) implementados
+- [ ] Interceptors configurados (auth, error handling)
+- [ ] Tratamento de timeout implementado
+- [ ] Tipos de resposta definidos
+
+### Tratamento de Erros
+- [ ] Try-catch para código assíncrono
+- [ ] Tipos de erro customizados criados se necessário
+- [ ] Mensagens de erro amigáveis ao usuário
+- [ ] Logging de erros para monitoramento
+- [ ] Retry logic para falhas de rede (se aplicável)
+
+---
+
+## 🧭 Navegação
+
+### Expo Router
+- [ ] Telas adicionadas em `app/`
+- [ ] Rota dinâmica configurada (se necessário)
+- [ ] Layout compartilhado criado (se aplicável)
+- [ ] Navegação typesafe implementada
+- [ ] Deep linking configurado (se necessário)
+- [ ] Parâmetros de rota tipados
+- [ ] Back navigation gerenciada adequadamente
+
+---
+
+## ⚡ Performance
+
+### Otimização de Componentes
+- [ ] React.memo aplicado a componentes caros
+- [ ] useCallback para funções passadas como props
+- [ ] useMemo para cálculos caros
+- [ ] Evitar renderizações desnecessárias
+
+### Otimização de Listas
+- [ ] FlatList usado para listas longas (não ScrollView)
+- [ ] keyExtractor fornecido
+- [ ] renderItem memoizado
+- [ ] getItemLayout implementado (se tamanho fixo)
+- [ ] initialNumToRender configurado
+- [ ] maxToRenderPerBatch ajustado
+- [ ] windowSize otimizado
+
+### Otimização de Imagens
+- [ ] Fast Image usado para múltiplas imagens
+- [ ] Placeholder/skeleton durante carregamento
+- [ ] Tamanhos de imagem otimizados
+- [ ] Lazy loading implementado
+- [ ] Cache configurado
+
+---
+
+## 🔒 Segurança
+
+### Armazenamento de Dados
+- [ ] Dados sensíveis no SecureStore (não AsyncStorage)
+- [ ] Tokens armazenados com segurança
+- [ ] Dados criptografados quando necessário
+- [ ] Permissões solicitadas adequadamente
+
+### Validação
+- [ ] Validação de entrada implementada
+- [ ] Sanitização de dados de API
+- [ ] XSS prevenido (escaping de user input)
+- [ ] Validação de formulários implementada
+
+### API Security
+- [ ] HTTPS usado para todas as chamadas de API
+- [ ] Tokens de auth renovados automaticamente
+- [ ] Rate limiting gerenciado
+- [ ] Credenciais sensíveis em variáveis de ambiente
+
+---
+
+## 🧪 Testes
+
+### Testes Unitários
+- [ ] Hooks testados
+- [ ] Utils testados
+- [ ] Serviços testados
+- [ ] Casos extremos cobertos
+- [ ] Cobertura > 80%
+
+### Testes de Componentes
+- [ ] React Native Testing Library usado
+- [ ] Renderização de componentes testada
+- [ ] Interações do usuário testadas
+- [ ] Estados condicionais testados
+- [ ] Props testadas
+- [ ] Snapshot tests criados (se apropriado)
+
+### Testes de Integração
+- [ ] Fluxos críticos testados end-to-end
+- [ ] Navegação testada
+- [ ] Data fetching testado com mocks
+- [ ] Tratamento de erros testado
+
+### Testes Manuais
+- [ ] Testado em iOS
+- [ ] Testado em Android
+- [ ] Testado em diferentes tamanhos de tela
+- [ ] Testado dark mode (se aplicável)
+- [ ] Testado cenários offline (se aplicável)
+- [ ] Testado em dispositivos reais
+
+---
+
+## 📚 Documentação
+
+### Código
+- [ ] JSDoc para funções públicas
+- [ ] Comentários para lógica complexa
+- [ ] README atualizado (se necessário)
+- [ ] CHANGELOG atualizado
+
+### Componentes
+- [ ] Props documentadas
+- [ ] Exemplos de uso fornecidos
+- [ ] Storybook stories criadas (se aplicável)
+
+---
+
+## 🔍 Revisão de Código
+
+### Auto-revisão
+- [ ] Código formatado (Prettier)
+- [ ] Sem warnings de ESLint
+- [ ] Sem warnings de TypeScript
+- [ ] Sem console.logs esquecidos
+- [ ] Sem código comentado
+- [ ] Imports organizados
+
+### Princípios
+- [ ] SOLID principles respeitados
+- [ ] DRY (Don't Repeat Yourself)
+- [ ] KISS (Keep It Simple, Stupid)
+- [ ] YAGNI (You Aren't Gonna Need It)
+- [ ] Código autodocumentado
+
+### Performance
+- [ ] Sem memory leaks
+- [ ] Sem renderizações infinitas
+- [ ] Bundle size não aumentado significativamente
+- [ ] Tempo de carregamento aceitável
+
+---
+
+## 🚀 Deployment
+
+### Pré-deployment
+- [ ] Feature testada em dev/staging
+- [ ] Feature flags implementadas (se necessário)
+- [ ] Rollback plan preparado
+- [ ] Monitoramento configurado
+
+### Pós-deployment
+- [ ] Feature monitorada em produção
+- [ ] Métricas coletadas
+- [ ] Feedback do usuário monitorado
+- [ ] Bugs críticos resolvidos imediatamente
+
+---
+
+## ✅ Critérios de Aceitação
+
+- [ ] Todos os requisitos funcionais implementados
+- [ ] Todos os testes passando
+- [ ] Cobertura de testes adequada (>80%)
+- [ ] Code review aprovado
+- [ ] Documentação completa
+- [ ] Performance aceitável
+- [ ] Sem regressões
+- [ ] UI/UX conforme design
+- [ ] Acessibilidade implementada
+- [ ] Funciona em iOS e Android
+
+---
+
+**Use este checklist como guia. Nem todos os itens se aplicam a todas as features. Adapte conforme necessário.**

package/Dev/i18n/pt/ReactNative/checklists/pre-commit.md

@@ -0,0 +1,270 @@
+# Checklist: Pré-Commit React Native
+
+Execute este checklist antes de cada commit para garantir qualidade e consistência do código.
+
+---
+
+## 🔍 Verificações Básicas
+
+### Código
+- [ ] Código funciona corretamente no iOS
+- [ ] Código funciona corretamente no Android
+- [ ] Sem console.logs esquecidos
+- [ ] Sem debuggers esquecidos
+- [ ] Sem código comentado desnecessário
+- [ ] Sem imports não utilizados
+- [ ] Sem variáveis não utilizadas
+
+### Arquivos
+- [ ] Apenas arquivos necessários incluídos no commit
+- [ ] Nenhum arquivo de configuração pessoal (.env local, etc.)
+- [ ] Nenhum arquivo temporário ou build
+- [ ] node_modules não incluído
+- [ ] .expo/ não incluído
+
+---
+
+## 📝 TypeScript
+
+### Tipagem
+- [ ] Sem erros do TypeScript
+- [ ] Sem warnings do TypeScript
+- [ ] Sem uso de `any` (ou justificado com comentário)
+- [ ] Todas as props de componentes tipadas
+- [ ] Todos os retornos de função tipados
+- [ ] Interfaces/types documentadas quando complexas
+
+### Strict Mode
+- [ ] strict: true respeitado
+- [ ] strictNullChecks respeitado
+- [ ] noImplicitAny respeitado
+- [ ] noUnusedLocals respeitado
+- [ ] noUnusedParameters respeitado
+
+---
+
+## 🎨 Estilização
+
+### StyleSheet
+- [ ] StyleSheet.create usado (não inline objects)
+- [ ] Sem estilos duplicados
+- [ ] Tema usado para cores/spacing/typography
+- [ ] Nomes de estilos descritivos
+- [ ] Estilos organizados logicamente
+
+### Responsividade
+- [ ] Testado em diferentes tamanhos de tela
+- [ ] Testado em orientação portrait e landscape
+- [ ] Testado em tablets (se aplicável)
+- [ ] Estilos dinâmicos funcionam corretamente
+
+### Plataforma
+- [ ] Diferenças iOS/Android gerenciadas
+- [ ] Platform.select usado apropriadamente
+- [ ] Arquivos .ios.tsx / .android.tsx se necessário
+- [ ] Sombras funcionam em ambas plataformas
+
+---
+
+## ⚡ Performance
+
+### Componentes
+- [ ] React.memo usado para componentes caros
+- [ ] useCallback aplicado a event handlers passados como props
+- [ ] useMemo aplicado a cálculos caros
+- [ ] Sem renderizações infinitas
+- [ ] Sem memory leaks (cleanup em useEffect)
+
+### Listas
+- [ ] FlatList usado para listas longas (não ScrollView com map)
+- [ ] keyExtractor fornecido
+- [ ] renderItem otimizado
+- [ ] Props de otimização configuradas (initialNumToRender, etc.)
+
+### Imagens
+- [ ] Imagens otimizadas (tamanho/formato)
+- [ ] Placeholder durante carregamento
+- [ ] Cache configurado
+- [ ] Fast Image usado se múltiplas imagens
+
+---
+
+## 🔧 Código
+
+### Qualidade
+- [ ] Funções curtas e focadas
+- [ ] Componentes pequenos e reutilizáveis
+- [ ] Nomes descritivos (variáveis, funções, componentes)
+- [ ] Lógica complexa extraída em funções/hooks
+- [ ] Código autodocumentado
+
+### Princípios
+- [ ] Single Responsibility Principle respeitado
+- [ ] DRY: sem código duplicado
+- [ ] KISS: solução mais simples escolhida
+- [ ] YAGNI: apenas código necessário
+
+### Hooks
+- [ ] Hooks nomeados com `use` prefix
+- [ ] Regras dos hooks respeitadas
+- [ ] Arrays de dependências corretos
+- [ ] Cleanup implementado quando necessário
+- [ ] Hooks customizados testáveis
+
+---
+
+## 🌐 API & Data
+
+### Data Fetching
+- [ ] React Query usado para server state
+- [ ] Query keys consistentes
+- [ ] Tratamento de erro implementado
+- [ ] Loading states gerenciados
+- [ ] Cache configurado apropriadamente
+
+### Error Handling
+- [ ] Try-catch para código async
+- [ ] Erros logados adequadamente
+- [ ] Mensagens de erro amigáveis ao usuário
+- [ ] Error boundaries implementadas
+
+---
+
+## 🔒 Segurança
+
+### Dados Sensíveis
+- [ ] Nenhuma credencial hardcoded
+- [ ] Nenhum token exposto
+- [ ] Variáveis de ambiente usadas
+- [ ] SecureStore para dados sensíveis
+- [ ] Nenhuma key de API no código
+
+### Validação
+- [ ] Input do usuário validado
+- [ ] Dados de API sanitizados
+- [ ] Permissões solicitadas adequadamente
+
+---
+
+## 🧪 Testes
+
+### Execução
+- [ ] `npm test` ou `yarn test` passa
+- [ ] Nenhum teste quebrado
+- [ ] Nenhum teste skipped sem razão
+- [ ] Cobertura de testes mantida/melhorada
+
+### Qualidade
+- [ ] Novos componentes testados
+- [ ] Novos hooks testados
+- [ ] Casos extremos cobertos
+- [ ] Testes são significativos (não apenas para cobertura)
+
+---
+
+## 🛠️ Ferramentas
+
+### Linting
+- [ ] `npx eslint .` passa sem erros
+- [ ] Sem warnings críticos de ESLint
+- [ ] Regras customizadas respeitadas
+
+### Formatação
+- [ ] `npx prettier --check .` passa
+- [ ] Código formatado automaticamente
+- [ ] Configuração do Prettier respeitada
+
+### Type Checking
+- [ ] `npx tsc --noEmit` passa
+- [ ] Nenhum erro de tipagem
+
+---
+
+## 📱 Build
+
+### Compilação
+- [ ] `npx expo start` funciona sem erros
+- [ ] Build iOS compila (se aplicável)
+- [ ] Build Android compila (se aplicável)
+- [ ] Nenhum warning crítico no build
+
+### Dependências
+- [ ] package.json atualizado
+- [ ] package-lock.json ou yarn.lock commitado
+- [ ] Dependências necessárias instaladas
+- [ ] Nenhuma dependência quebrada
+
+---
+
+## 📚 Documentação
+
+### Código
+- [ ] Lógica complexa comentada
+- [ ] JSDoc adicionado para APIs públicas
+- [ ] TODOs marcados com // TODO: quando necessário
+- [ ] README atualizado se mudanças estruturais
+
+### Commit
+- [ ] Mensagem de commit descritiva
+- [ ] Convenção de commit seguida (Conventional Commits)
+- [ ] Referência a issue/ticket incluída
+- [ ] Quebras de compatibilidade documentadas
+
+---
+
+## 🔄 Git
+
+### Histórico
+- [ ] Commit atômico (uma mudança lógica)
+- [ ] Branch atualizada com main/develop
+- [ ] Nenhum conflito de merge
+- [ ] Histórico limpo (sem commits de merge desnecessários)
+
+### Arquivos
+- [ ] .gitignore atualizado se necessário
+- [ ] Nenhum arquivo grande (>1MB) commitado
+- [ ] Nenhum arquivo binário desnecessário
+
+---
+
+## ✅ Checklist Rápido (Mínimo)
+
+Para commits rápidos, pelo menos verifique:
+
+1. [ ] Código funciona (iOS + Android)
+2. [ ] Sem console.logs
+3. [ ] TypeScript passa (`npx tsc --noEmit`)
+4. [ ] ESLint passa (`npx eslint .`)
+5. [ ] Prettier formatou (`npx prettier --write .`)
+6. [ ] Testes passam (`npm test`)
+7. [ ] Mensagem de commit descritiva
+
+---
+
+## 🚀 Automação
+
+**Considere usar Husky + lint-staged para automatizar estes checks:**
+
+```bash
+# Instalar
+npx husky-init && npm install
+npm install --save-dev lint-staged
+
+# Configurar lint-staged em package.json
+{
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "eslint --fix",
+      "prettier --write",
+      "tsc --noEmit"
+    ]
+  }
+}
+
+# Adicionar pre-commit hook
+npx husky set .husky/pre-commit "npx lint-staged && npm test"
+```
+
+---
+
+**Este checklist ajuda a manter qualidade consistente. Adapte conforme as necessidades do seu projeto.**