# {{PROJECT_NAME}} - React TypeScript

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

## Que (Stack y Estructura)

**Stack**: {{TECH_STACK}}
**Framework**: React {{REACT_VERSION}} + TypeScript {{TYPESCRIPT_VERSION}}
**Build Tool**: {{BUILD_TOOL}}

### Estructura del proyecto
```
src/
├── components/       # Componentes reutilizables (Atomic Design)
│   ├── atoms/        # Botones, inputs, labels
│   ├── molecules/    # FormField, SearchBar, Card
│   └── organisms/    # Header, DataTable, Form
├── features/         # Funcionalidades de negocio
│   └── [feature]/
│       ├── components/  hooks/  services/  types/
├── hooks/            # Hooks globales reutilizables
├── services/         # Servicios compartidos (API, storage)
├── store/            # State management global
└── types/            # Tipos globales
```

## Por que (Proposito y Organizacion)

### Arquitectura: Feature-Based + Atomic Design
- Features aisladas por dominio de negocio
- Componentes reutilizables siguiendo Atomic Design
- TypeScript strict mode obligatorio

Ver `rules/02-architecture.md` para patrones detallados.

### Reglas criticas

| Regla | Descripcion |
|-------|-------------|
| Analisis primero | OBLIGATORIO antes de cualquier codigo |
| TypeScript strict | `noImplicitAny`, `strictNullChecks` |
| Cobertura | Minimo 80% en lineas, funciones, branches |
| ESLint | 0 warnings, 0 errors |

## Como (Comandos y Flujos de trabajo)

### Comandos de desarrollo
```bash
{{PACKAGE_MANAGER}} install    # Instalacion
{{PACKAGE_MANAGER}} run dev    # Servidor desarrollo
{{PACKAGE_MANAGER}} run build  # Build produccion
```

### Pipeline de calidad
```bash
{{PACKAGE_MANAGER}} run lint       # Linter
{{PACKAGE_MANAGER}} run type-check # Verificar tipos
{{PACKAGE_MANAGER}} run test       # Tests unitarios
{{PACKAGE_MANAGER}} run quality    # Todas las verificaciones
```

### Flujo de desarrollo
1. **Analizar** - `rules/01-workflow-analysis.md`
2. **TDD** - Tests en paralelo con codigo
3. **Calidad** - `quality` antes de commit
4. **Commit** - Conventional Commits

## Referencias

| Contexto | Archivo |
|----------|---------|
| Antes de modificar | `rules/01-workflow-analysis.md` |
| Arquitectura | `rules/02-architecture.md` |
| Estandares codigo | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Tests | `rules/07-testing.md` |
| Seguridad | `rules/11-security.md` |
| State Management | `rules/13-state-management.md` |

<!-- PROJECT-SPECIFIC-START -->
## Especificidades del proyecto

<!-- Agregar configuracion especifica del proyecto aqui -->

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