Geniusia_v2/GUIDE_SPECS.md

📖 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

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

• 4 nouveaux composants
• 39 correctness properties
• Stratégie de test avec Hypothesis

✅ 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

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

🔍 Comment Retrouver une Spec ?

Méthode 1 : Par Nom

ls .kiro/specs/

Méthode 2 : Par Problème

Consultez ce guide ou INDEX.md

Méthode 3 : Par Date

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 !