# 📖 Guide des Specs - RPA Vision V2

## 🗂️ Structure des Specs

Toutes les specs sont dans `.kiro/specs/` avec cette structure :

```
.kiro/specs/
├── faiss-learning-fix/          ✅ TERMINÉ (22 nov 2024)
│   ├── requirements.md
│   ├── design.md
│   └── tasks.md
├── workflow-detection-fix/
│   ├── requirements.md
│   ├── design.md
│   └── tasks.md
├── assisted-mode-suggestions/
│   ├── requirements.md
│   ├── design.md
│   └── tasks.md
├── ui-element-detection/
│   ├── requirements.md
│   ├── design.md
│   └── tasks.md
├── embedding-improvement/
│   ├── requirements.md
│   ├── design.md
│   └── tasks.md
└── gui-logs-improvement/
    ├── requirements.md
    ├── design.md
    └── tasks.md
```

## 🎯 Spec Actuelle : faiss-learning-fix

### Problème Résolu
Après 3 jours de tests, aucune suggestion n'apparaissait car :
- Index FAISS vide malgré 40 tâches sauvegardées
- Processus zombies consommant 3GB+ RAM
- Arrêt impossible sans kill manuel

### Fichiers de la Spec

#### 📋 [requirements.md](.kiro/specs/faiss-learning-fix/requirements.md)
8 exigences principales :
1. Construction automatique de l'index FAISS
2. Arrêt propre sans processus zombies
3. Génération de suggestions après actions répétitives
4. Limitation mémoire à 2GB
5. Diagnostic complet du système
6. Reconstruction de l'index
7. Validation des embeddings
8. Protection contre boucles infinies

#### 🏗️ [design.md](.kiro/specs/faiss-learning-fix/design.md)
- 4 nouveaux composants
- 39 correctness properties
- Stratégie de test avec Hypothesis

#### ✅ [tasks.md](.kiro/specs/faiss-learning-fix/tasks.md)
14 tâches (4 terminées) :
- ✅ Tâche 1 : FAISSIndexBuilder
- ✅ Tâche 2 : Chargement automatique
- ✅ Tâche 3 : Arrêt propre
- ✅ Tâche 4 : Checkpoint
- ⏭️ Tâches 5-14 : Améliorations optionnelles

### Résultats

**Résumé complet** : [FAISS_LEARNING_FIX_COMPLETE.md](FAISS_LEARNING_FIX_COMPLETE.md)

- ✅ 40 tâches chargées
- ✅ 122 embeddings indexés
- ✅ 672 workflows appris
- ✅ Application stable

## 🔍 Comment Retrouver une Spec ?

### Méthode 1 : Par Nom
```bash
ls .kiro/specs/
```

### Méthode 2 : Par Problème
Consultez ce guide ou `INDEX.md`

### Méthode 3 : Par Date
```bash
ls -lt .kiro/specs/*/requirements.md
```

## 📝 Créer une Nouvelle Spec

1. Demander à Kiro : "Je veux créer une spec pour [problème]"
2. Kiro créera automatiquement :
   - `.kiro/specs/[nom-feature]/requirements.md`
   - `.kiro/specs/[nom-feature]/design.md`
   - `.kiro/specs/[nom-feature]/tasks.md`

## 🗄️ Archives

Les anciens documents sont dans `docs/archive/` :
- `sessions/` : Résumés de sessions (SESSION_*.md, RESUME_*.md, etc.)
- `old-summaries/` : Anciens résumés (*COMPLETE*.md, *FIX*.md, etc.)

## 📚 Documentation Complémentaire

- **README.md** : Documentation principale
- **ROADMAP_RPA_100_VISION.md** : Vision du projet
- **CHANGELOG.md** : Historique des changements
- **INDEX.md** : Index général de la documentation

---

**Astuce** : Utilisez `INDEX.md` comme point d'entrée pour naviguer dans la documentation !