# {{PROJECT_NAME}} - React Native

> Gerado: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}

## O Que (Stack & Estrutura)

**Stack**: {{TECH_STACK}}
**React Native**: {{REACT_NATIVE_VERSION}} | **Expo SDK**: {{EXPO_SDK_VERSION}}
**TypeScript**: {{TYPESCRIPT_VERSION}}

### Estrutura do projeto
```
src/
├── app/              # Expo Router (file-based routing)
├── components/       # Componentes reutilizaveis
├── features/         # Features por dominio de negocio
├── hooks/            # Custom hooks
├── services/         # API, Storage
├── stores/           # State management (Zustand)
├── types/            # Tipos TypeScript
└── theme/            # Cores, espacamento
```

## Por Que (Proposito & Organizacao)

### Arquitetura: Feature-Based + Expo Router
- **Layers**: Presentation -> Application -> Domain -> Data
- **Estado**: React Query (servidor), Zustand (cliente), MMKV (persistencia)
- **Navegacao**: File-based routing com Expo Router

Ver `rules/02-architecture.md` para padroes.

### Regras criticas

| Regra | Descricao |
|-------|-----------|
| Analise | OBRIGATORIA antes de qualquer codigo |
| TypeScript | Strict mode, zero `any` |
| Performance | 60 FPS alvo em todas interacoes |
| Seguranca | Tokens em SecureStore, HTTPS apenas |

## Como (Comandos & Workflows)

### Comandos de desenvolvimento
```bash
npx expo start        # Dev server
npx expo start --ios  # iOS
npx expo start --android # Android
npm run type-check    # TypeScript
```

### Pipeline de qualidade
```bash
npm run lint          # ESLint
npm run format        # Prettier
npm test              # Jest
npm run test:coverage # Cobertura (80% minimo)
```

### Build & Deploy
```bash
eas build --profile development --platform all
eas build --profile production --platform all
eas update --branch production --message "Fix"
```

### Workflow de desenvolvimento
1. **Analisar** - `rules/01-workflow-analysis.md`
2. **TDD** - Jest + React Native Testing Library
3. **Qualidade** - Lint + Type check + Testes
4. **Commit** - Conventional Commits

## Referencias

| Contexto | Arquivo |
|----------|---------|
| Workflow | `rules/01-workflow-analysis.md` |
| Arquitetura | `rules/02-architecture.md` |
| Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Testes | `rules/07-testing.md` |
| Seguranca | `rules/11-security.md` |
| State | `rules/13-state-management.md` |
| Navegacao | `rules/14-navigation.md` |

<!-- PROJECT-SPECIFIC-START -->
## Especificidades do projeto

{{ADR_NOTES}}

{{PROJECT_SPECIFIC_CONVENTIONS}}

<!-- PROJECT-SPECIFIC-END -->
