# {{PROJECT_NAME}} - React TypeScript

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

## O Que (Stack & Estrutura)

**Stack**: React {{REACT_VERSION}} + TypeScript {{TYPESCRIPT_VERSION}}
**Build Tool**: {{BUILD_TOOL}}
**Package Manager**: {{PACKAGE_MANAGER}}

### Estrutura do projeto
```
src/
├── components/        # Componentes reutilizaveis (Atomic Design)
│   ├── atoms/        # Botoes, inputs
│   ├── molecules/    # FormField, Card
│   └── organisms/    # Header, DataTable
├── features/         # Funcionalidades de negocio
│   └── [feature]/
│       ├── components/
│       ├── hooks/
│       ├── services/
│       └── types/
├── hooks/            # Hooks globais
├── services/         # Servicos API
└── store/            # State management
```

## Por Que (Proposito & Organizacao)

### Arquitetura: Feature-Based + Atomic Design
- **Features**: Logica de negocio isolada por dominio
- **Components**: UI reutilizavel em niveis atomicos
- TypeScript strict mode obrigatorio

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

### Regras criticas

| Regra | Descricao |
|-------|-----------|
| Analise | OBRIGATORIA antes de qualquer codigo |
| TypeScript | strict mode, sem `any` |
| Testes | 80% cobertura minima |
| State | React Query (server), Zustand (client) |

## Como (Comandos & Workflows)

### Comandos de desenvolvimento
```bash
{{PACKAGE_MANAGER}} install      # Instalar
{{PACKAGE_MANAGER}} run dev      # Servidor de desenvolvimento
{{PACKAGE_MANAGER}} run build    # Build producao
```

### Pipeline de qualidade
```bash
{{PACKAGE_MANAGER}} run lint     # ESLint
{{PACKAGE_MANAGER}} run type-check # TypeScript
{{PACKAGE_MANAGER}} run test:coverage # Testes com cobertura
{{PACKAGE_MANAGER}} run quality  # Todas verificacoes
```

### Workflow de desenvolvimento
1. **Analisar** - `rules/01-workflow-analysis.md`
2. **TDD** - Testes antes do codigo
3. **Qualidade** - `{{PACKAGE_MANAGER}} run quality`
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` |

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

<!-- Adicionar configuracao especifica do projeto aqui -->

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