Update README documentation for current architecture

- Update objective to reflect N agents (3-50) instead of fixed 7 roles
- Update AI layer to reference mistral-large-2411 model
- Add section-based editing and convergence details
- Remove outdated 'network monitoring' feature
- Add session discovery features
- Update features list to include: dynamic agents, random names, raised hand animation, real-time visualization
- Update usage guide to reflect new session discovery UI
- Update example to use dynamic agents with random names
- Clarify automatic process and consensus convergence
- Add info about accessing previous sessions
This commit is contained in:
Augustin ROUX 2025-10-18 23:53:02 +02:00
parent 1dde7dfc5b
commit 33e2434e71

View File

@ -19,17 +19,13 @@ Aucune génération de code direct n'est effectuée : seules des **explications,
## Objectif
Reproduire une **table ronde d'IA spécialistes**, chaque agent IA représentant un rôle spécifique :
Reproduire une **table ronde d'IA spécialistes**, avec un nombre d'agents flexible et configurable :
- Lead Architect (Architecte logiciel)
- Backend Engineer (Développeur backend)
- Frontend Engineer (Développeur frontend)
- UI Designer (Designer UI/UX)
- DevOps Engineer (Ingénieur DevOps)
- Product Manager (Chef de projet)
- Security Specialist (Spécialiste sécurité)
- **Agents dynamiques** (3-50) avec des noms aléatoires pour la diversité
- Chaque agent à une perspective unique sur l'architecture logicielle
- Les agents se spécialisent naturellement dans différents domaines
L'aspect le plus crucial de ces IA réside dans leur capacité à **collaborer itérativement** pour améliorer collectivement la spécification architecturale jusqu'à convergence naturelle (quand plus aucune amélioration n'est proposée).
L'aspect le plus crucial de ces IA réside dans leur capacité à **collaborer itérativement** pour améliorer collectivement la spécification architecturale. Le processus s'arrête naturellement quand **tous les agents convergent** (plus aucune amélioration n'est proposée sur N tours consécutifs).
---
@ -57,9 +53,10 @@ Elles discutent pour converger vers un consensus, puis produisent une **fiche co
- **Frontend**: Vue.js 3 + Vite
- **Backend**: Node.js + Express
- **AI Layer**: Multi-agent système avec Mistral API
- **Storage**: SQLite + JSON backup
- **Diagrammes**: Mermaid.js
- **AI Layer**: Multi-agent système avec Mistral API (mistral-large-2411)
- **Storage**: SQLite pour persistance complète
- **Real-time**: WebSocket pour streaming temps réel des modifications
- **Design**: Glassmorphism avec animations fluides
### Architecture globale
@ -79,28 +76,36 @@ graph TD
### Conception Collaborative par IA
- **7 agents spécialisés** : Architecte, Backend Engineer, Frontend Engineer, UI Designer, DevOps Engineer, Product Manager, Security Specialist
- **Création itérative** : Lead Architect crée le document initial
- **Tours de table** : Chaque agent revoit et propose des améliorations
- **N agents dynamiques** (3-50) : Nombre configurable pour chaque session
- **Noms aléatoires** : Chaque agent a un nom unique pour meilleure clarté
- **Création itérative** : SYSTEM crée la structure de base
- **Tours de table automatiques** : Chaque agent revoit et peut modifier une section
- **Document évolutif** : Amélioration progressive à chaque passage
- **Convergence naturelle** : Arrêt automatique quand tous les agents sont satisfaits
- **Traçabilité complète** : Historique de toutes les modifications
- **Opérations supportées** : Modification, création, ou suppression de sections
- **Convergence naturelle** : Arrêt automatique quand N agents de suite ne proposent aucun changement
- **Traçabilité complète** : Historique de toutes les modifications avec agent, raison, et round
- **Format Markdown** : Output toujours en Markdown (.md)
- **Context files** : Support d'upload de fichiers MD/TXT en entrée (optionnel)
- **Network monitoring** : Indicateur temps réel de latence et qualité réseau
- **Session discovery** : Accès facile aux sessions précédentes avec filtres et stats
- **Real-time visualization** : Observation des changements en direct via WebSocket
### Système multi-agents IA
- **Intégration Mistral AI** pour génération de réponses intelligentes et contextuelles
- **System prompts spécialisés** pour chaque rôle d'agent
- **Contexte intelligent** : Les agents voient l'historique et le document actuel
- **Intégration Mistral AI** (mistral-large-2411) pour génération intelligente et contextualisée
- **System prompts intelligents** : Prompt générique paramétré par agent
- **Contexte intelligent** : Les agents voient le document actuel et sa version antérieure
- **Section-based editing** : Les agents modifient une section à la fois pour cohérence
### Interface et visualisation
- **Saisie de prompt** décrivant le projet souhaité
- **Upload optionnel** de fichiers contexte (MD/TXT)
- **Sélection dynamique** du nombre d'agents (3-50)
- **Visualisation en temps réel** des modifications via WebSocket
- **Timeline d'évolution** du document avec historique complet
- **Affichage interactif** du document Markdown final
- **Indicateurs de progression** et statuts du session
- **Timeline interactive** montrant chaque round et les agents ayant participé
- **Raised hand animation** montrant l'agent actuel qui réfléchit/modifie
- **Affichage interactif** du document Markdown avec syntaxe colorée
- **Session discovery** avec stats (complétées, en cours, total)
- **Filtres par statut** pour accéder facilement aux sessions
- **Historique des sessions** accessible depuis la page d'accueil
### Architecture et stockage
- **API REST** pour gestion des sessions collaboratives
@ -165,15 +170,28 @@ sequenceDiagram
### Étapes
1. **Décrire le projet** : Entrez une description détaillée
2. **Ajouter un contexte** (optionnel) : Upload un fichier MD ou TXT
3. **Sélectionner** : Nombre d'agents (3, 5, ou 7)
4. **Lancer** : Start Design Session
5. **Suivre** :
1. **Accédez à la page d'accueil** : Consultez les sessions précédentes
- Visualisez les stats (complétées, en cours, total)
- Filtrez par statut si nécessaire
- Cliquez sur une session pour la reprendre
2. **Ou créez une nouvelle session** :
- Décrivez le projet en détail
- Ajouter un contexte (optionnel) : Upload un fichier MD ou TXT
- Sélectionnez le nombre d'agents (3-50)
- Lancez "Start Design Session"
3. **Observez la collaboration** :
- Visualisez le document en temps réel
- Consultez la timeline
- Lancez les tours avec "Next Review Round"
6. **Résultat** : Document Markdown téléchargeable
- Consultez la timeline avec les rounds et les agents ayant participé
- Voir l'animation "main levée" pour l'agent actuel
4. **Processus automatique** :
- Chaque agent revoit le document
- Peut modifier, créer, ou supprimer une section
- Les rounds se font automatiquement
- Le processus s'arrête quand consensus est atteint
5. **Résultat** :
- Document Markdown téléchargeable
- Historique complet des modifications
- Session reste accessible pour consultation
### Exemple
@ -183,16 +201,12 @@ Plateforme gestion projets temps réel, équipes distribuées,
gestion tâches, communication, partage fichiers, 10K+ users
```
Processus:
- Round 1: Lead Architect - Architecture générale
- Round 2: Backend - APIs et base de données
- Round 3: Frontend - Structure UI
- Round 4: UI Designer - Guidelines UX
- Round 5: DevOps - Infrastructure
- Round 6: Product Manager - Besoins métier
- Round 7: Security - Mesures sécurité
Processus (avec 7 agents aux noms aléatoires):
- Round 1: SYSTEM crée la structure de base
- Round 2: Chaque agent revoit et propose des améliorations
- Round 3+: Itération jusqu'à convergence
Sortie: Spécification architecturale Markdown complète
Résultat: Spécification architecturale Markdown complète avec traçabilité des changements
---