# {{PROJECT_NAME}} - React TypeScript

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

## Quoi (Stack & Structure)

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

### Structure du projet
```
src/
├── components/           # Composants reutilisables (Atomic Design)
│   ├── atoms/           # Boutons, inputs
│   ├── molecules/       # FormField, Card
│   └── organisms/       # Header, DataTable
├── features/            # Fonctionnalites metier
│   └── [feature-name]/
│       ├── components/  # Composants specifiques
│       ├── hooks/       # Hooks custom
│       ├── services/    # Services API
│       └── types/       # Types TypeScript
├── hooks/               # Hooks globaux
├── services/            # Services partages
├── store/               # State management global
└── types/               # Types globaux
```

## Pourquoi (Objectif & Organisation)

### Architecture: Feature-Based + Atomic Design
- **Components**: UI reutilisable (atoms -> organisms)
- **Features**: Logique metier par domaine
- **Services**: Acces aux APIs et donnees externes

Voir `rules/02-architecture.md` pour les patterns.

### Regles critiques

| Regle | Description |
|-------|-------------|
| Analyse avant code | Consulter `rules/01-workflow-analysis.md` |
| TypeScript strict | `strict: true` dans tsconfig |
| Coverage 80%+ | Tous composants/hooks testes |
| ESLint 0 warnings | Qualite code obligatoire |

## Comment (Commandes & Workflows)

### Commandes de developpement
```bash
{{PACKAGE_MANAGER}} install    # Installation
{{PACKAGE_MANAGER}} run dev    # Serveur dev
{{PACKAGE_MANAGER}} run build  # Build production
```

### Pipeline de qualite
```bash
{{PACKAGE_MANAGER}} run lint       # Linter
{{PACKAGE_MANAGER}} run type-check # Verification types
{{PACKAGE_MANAGER}} run test       # Tests unitaires
{{PACKAGE_MANAGER}} run test:e2e   # Tests E2E
{{PACKAGE_MANAGER}} run quality    # Tout verifier
```

### Workflow de developpement
1. **Analyser** - `rules/01-workflow-analysis.md`
2. **TDD** - Test first, puis implementation
3. **Qualite** - `{{PACKAGE_MANAGER}} run quality`
4. **Commit** - Conventional Commits

## References

| Contexte | Fichier |
|----------|---------|
| Workflow | `rules/01-workflow-analysis.md` |
| Architecture | `rules/02-architecture.md` |
| Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Tests | `rules/07-testing.md` |
| State | `rules/13-state-management.md` |
| Securite | `rules/11-security.md` |
| Performance | `rules/12-performance.md` |

<!-- PROJECT-SPECIFIC-START -->
## Specificites du projet

<!-- Cette section est preservee lors des mises a jour -->

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