Initial commit

GUIDE_SPECS.md

@@ -0,0 +1,116 @@
+# 📖 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 !