Archi Agents — Agent Analyste

Construit le modèle d'architecture (composants, flux, technologies, sécurité…) à partir des preuves, avec LLM embarqué et validation par citations.

Cet agent construit le modèle d'architecture (applications, services, API, bases, flux, protocoles, sécurité, environnements…) à partir de preuves sourcées ; le LLM embarqué enrichit l'analyse, chaque élément proposé étant validé par une citation verbatim.

Fonctionnalités

Agent Analyste (étape analyze) : construit le modèle d'architecture à partir des preuves sourcées ; modèle génératif Qwen3-0.6B embarqué, chaque élément proposé par l'IA étant validé par une citation verbatim.
Version 0.1.11 : tout est installé, modèle MAX compris, et le profil MAX est le profil par défaut. Installer ou mettre à jour l'Analyste installe automatiquement tout ce qu'il faut pour un dossier de qualité maximale : les 7 extensions Archi Agents (≈ 2,5 Go), le modèle MAX Qwen3-30B-A3B réparti en 42 extensions « fragment » (≈ 19 Go) et le reranker Qwen3-Reranker-0.6B en 2 fragments (≈ 0,6 Go) : 51 extensions, ≈ 22 Go à télécharger (une seule fois). Voir « Installation ».
À l'installation comme à la mise à jour : c'est VS Code qui installe ces extensions (dépendances d'extension de l'Analyste), aussi bien lors d'une installation neuve que lors d'une mise à jour depuis les versions 0.1.9 ou 0.1.10. Rien d'autre à faire pour générer un dossier d'architecture.
Profil MAX par défaut, avec repli automatique : le réglage archi.profile de l'Orchestrateur vaut MAX (Qwen3-30B-A3B). Si le modèle MAX est absent, incomplet, non intègre ou s'il ne tient pas dans la mémoire libre, le dossier est produit avec le modèle du niveau inférieur (BALANCED : Qwen3-1.7B ; à défaut, FAST : Qwen3-0.6B) et le repli est signalé (notification, résumé d'exécution, journaux) : un poste moins puissant continue de produire un dossier.
Trois façons de l'installer : 0.1.11 (tout, avec le modèle MAX ≈ 19 Go, profil MAX par défaut), 0.1.10 (les agents sans le modèle MAX : FAST et BALANCED) ou 0.1.9 (version tout-en-un en une seule extension) — voir « Choisir la version ».
100 % hors ligne : aucune donnée ne quitte la machine, aucune télémétrie ; le seul accès réseau est le téléchargement des extensions par VS Code depuis le Marketplace, à l'installation.

Installation

Depuis la version 0.1.10, cette extension est l'agent Analyste seul : elle ne contient plus l'Orchestrateur ni les autres agents, que la suite tout-en-un (versions 0.1.1 à 0.1.9) hébergeait. Elle les déclare, avec le modèle MAX, comme dépendances d'extension : VS Code installe celles qui manquent à l'installation comme à la mise à jour, sans autre action de votre part.

Ce qui est installé automatiquement (51 extensions, ≈ 22 Go)

Extension installée automatiquement	Identifiant	Rôle	Taille
Archi Agents — Orchestrateur	`opsva.archi-orchestrator`	commandes « Architecture: … », barre latérale, Assistant, enchaînement des agents, profil de calcul	≈ 0,4 Go
Archi Agents — Agent Extracteur	`opsva.archi-extractor`	documents → contenu structuré (OCR inclus)	≈ 0,4 Go
Archi Agents — Agent Indexeur RAG	`opsva.archi-rag`	chunks, index BM25 + vectoriel, reranking	≈ 0,4 Go
Archi Agents — Agent Rédacteur	`opsva.archi-writer`	modèle → texte du dossier	≈ 0,4 Go
Archi Agents — Agent Vérificateur	`opsva.archi-verifier`	anti-hallucination, corrections	≈ 0,4 Go
Archi Agents — Agent Générateur DOCX	`opsva.archi-docx`	diagrammes et `Dossier-Architecture-Final.docx`	≈ 0,4 Go
Archi Agents — Agent Revue de sécurité	`opsva.archi-revue-securite`	agent tiers : contributions sourcées sur la sécurité	< 1 Mo
Archi Agents — Modèle Qwen3 MoE 30B (fragments 1/42 à 42/42)	`opsva.archi-model-qwen3-30b-a3b-q4km-part-01` à `-42`	modèle MAX Qwen3-30B-A3B Q4_K_M (17 697 Mo, Apache-2.0), sans code	≈ 19 Go
Archi Agents — Modèle Qwen3 Reranker 0.6B (fragments 1/2 et 2/2)	`opsva.archi-model-qwen3-reranker-0-6b-q8-part-01` et `-02`	reranker de la recherche, profil MAX (610 Mo, Apache-2.0), sans code	≈ 0,6 Go

Les 7 premières extensions représentent ≈ 2,5 Go. Les fragments ne contiennent aucun code : seulement une portion du modèle, vérifiée (SHA256 de chaque fragment puis du fichier reconstitué, égal à l'empreinte publiée par la source) et assemblée localement au premier usage.

Place disque, mémoire, durée

Téléchargement : ≈ 22 Go (51 extensions), par VS Code, depuis le Marketplace : c'est la seule opération qui demande une connexion Internet.
Espace disque libre recommandé : ≈ 50 Go. Les fragments (≈ 19 Go pour le modèle MAX, ≈ 0,6 Go pour le reranker) et les modèles assemblés au premier usage (≈ 19 Go) occupent ≈ 38 Go ; les agents ≈ 2,5 Go ; VS Code garde en outre les paquets téléchargés dans son cache (CachedExtensionVSIXs) pendant l'installation, puis n'en conserve que les plus récents (≈ 9 Go au plus) : vous pouvez vider ce dossier une fois l'installation terminée.
Mémoire recommandée : 32 Go pour le profil MAX (le modèle demande ≈ 20 Go libres au moment du dossier) ; 16 Go suffisent pour BALANCED et FAST.
Durée du dossier en profil MAX : le profil MAX privilégie la qualité (vérification IA de chaque phrase générée, 3 variantes pour les sections critiques) : le traitement d'un corpus de quelques dizaines de documents se compte en heures. Mesurez la vitesse réelle avec « Architecture: Benchmark IA » ; pour un traitement plus rapide, choisissez BALANCED ou FAST dans le réglage archi.profile ou par « Architecture: Vérifier l'environnement ».
Premier usage du modèle MAX : le modèle est vérifié et assemblé à partir des 42 fragments (plusieurs minutes), puis réutilisé.

À l'installation comme à la mise à jour

Installation neuve : VS Code installe l'Analyste puis, en une seule opération, les 51 extensions listées ci-dessus.
Mise à jour (mise à jour automatique des extensions de VS Code, ou « Mettre à jour » depuis la vue Extensions) depuis la 0.1.9 ou la 0.1.10 : VS Code installe les extensions qui manquent encore (44 de plus depuis la 0.1.10 : les fragments du modèle MAX et du reranker).
Si l'une des extensions ne peut pas être installée (connexion interrompue, par exemple), VS Code annule l'installation de l'ensemble et le signale : relancez-la ; les paquets déjà téléchargés sont réutilisés tant qu'ils sont dans le cache de VS Code.

Si une extension installée avec l'Analyste manque ou est désactivée

Tant qu'une de ces extensions est désinstallée ou désactivée, VS Code n'active pas l'Analyste et affiche lui-même son invite (« Cannot activate … depends on … ») qui propose d'installer ou d'activer l'extension manquante, puis de recharger la fenêtre : suivez-la. Par précaution, l'Analyste contient aussi une notification de secours (une fois par session) : « Installer les éléments manquants » installe d'un seul clic la liste complète de ce qui manque (agents, fragments du modèle MAX et du reranker, taille annoncée), puis propose de recharger la fenêtre. Elle ne s'affiche que si VS Code active l'Analyste alors qu'un élément manque, ce que VS Code ne fait normalement pas : n'attendez pas cette notification, l'invite de VS Code est la réponse habituelle. L'installation passe par les commandes standard de VS Code, sur votre clic : l'Analyste n'ouvre aucune connexion réseau et n'envoie aucune télémétrie.

Choisir la version : 0.1.11, 0.1.10 ou 0.1.9

Version	Ce qui est installé	Profils
0.1.11 (cette version)	l'Analyste, les 7 extensions Archi Agents, le modèle MAX (42 fragments, ≈ 19 Go) et le reranker : ≈ 22 Go	MAX par défaut, repli automatique sur BALANCED puis FAST
0.1.10	l'Analyste et les 7 extensions Archi Agents, sans le modèle MAX : ≈ 2,5 Go	FAST et BALANCED ; sans modèle MAX, le profil MAX par défaut se replie automatiquement sur BALANCED
0.1.9	version tout-en-un en une seule extension (l'Orchestrateur et tous les agents sont hébergés par l'Analyste)	FAST et BALANCED

Pour installer une autre version que la dernière : Extensions › Archi Agents — Agent Analyste › ⚙ › Installer une autre version… › choisissez 0.1.10 ou 0.1.9, puis, toujours dans ⚙, désactivez la mise à jour automatique de cette extension (sinon VS Code la remet à jour vers la dernière version). Les extensions déjà installées (agents, fragments) restent en place ; désinstallez-les depuis la vue Extensions si vous voulez libérer la place.

Le Pack complet (opsva.archi-agents-pack) regroupe les mêmes éléments (agents et fragments) pour qui préfère les installer séparément ; avec la version 0.1.11 de l'Analyste, il n'est pas nécessaire.

Désinstallation. Désinstallez l'Analyste, puis les autres extensions « Archi Agents — … » depuis la vue Extensions (recherche « opsva ») pour libérer la place des fragments (≈ 22 Go). Le modèle assemblé au premier usage se trouve dans le stockage global de VS Code (%APPDATA%\Code\User\globalStorage\archi-agents.shared\suite-models) : supprimez ce dossier pour récupérer ses ≈ 19 Go.

Fonctionnement 100 % hors ligne

Aucune donnée ne quitte la machine : pas d'appel réseau, pas de télémétrie, pas de téléchargement, pas de serveur local ni de port ouvert.
Tout ce qui est nécessaire à l'exécution est installé avec ce paquet (voir « Installation ») : aucune installation de Python, Node.js, Docker, Ollama ou autre logiciel n'est requise.
Les traitements lourds s'exécutent dans des processus isolés (VS Code en mode Node) dont l'accès réseau est coupé.

Modèles embarqués

Modèle	Rôle	Quantification	Taille	Licence	Source
qwen3-0.6b-q4km (Qwen3 0.6B)	génératif	Q4_K_M	378 Mo	apache-2.0	unsloth/Qwen3-0.6B-GGUF

Chaque modèle est accompagné de model.json, SHA256SUMS, LICENSE et provenance.json ; son empreinte SHA256 est vérifiée au chargement.

Niveaux de modèles

Profil	Modèle génératif	Où il se trouve
FAST	Qwen3 0.6B (378 Mo)	embarqué dans chaque agent IA
BALANCED	Qwen3 1.7B (1200 Mo)	fragments dans 3 agents (Orchestrateur, Extracteur, Générateur DOCX), installés automatiquement
MAX (par défaut)	Qwen3 MoE 30B (17697 Mo)	extensions « Archi Agents — Modèle Qwen3 MoE 30B (fragment k/42) », installées automatiquement avec l'Analyste 0.1.11
MAX	Qwen3 Reranker 0.6B (610 Mo)	extensions « Archi Agents — Modèle Qwen3 Reranker 0.6B (fragment k/2) », installées automatiquement avec l'Analyste 0.1.11

Le niveau le plus élevé dont tous les fragments sont installés, intègres et dont le modèle tient dans la mémoire libre est utilisé ; sinon le niveau inférieur prend le relais automatiquement, et l'utilisateur en est informé.

Commandes

Architecture (Analyste): Analyser les sources (modèle d'architecture)

Commandes programmatiques (utilisées par l'Orchestrateur) : archi.analyste.run, .cancel, .info, .selfTest, .benchmark.

Autonomie et fonctionnement conjoint

Cet agent fonctionne seul (commande ci-dessus) : il lit et écrit les contrats JSON versionnés du projet (.archi/runs/<run>/). Installé avec les autres agents, il est piloté par l'Orchestrateur.

Étape	Extension	Rôle
0	Archi Agents — Orchestrateur	Parcours guidé, enchaînement, reprise, audit
1	Archi Agents — Agent Extracteur	Documents → contenu structuré (OCR inclus)
2	Archi Agents — Agent Indexeur RAG	Chunks, index BM25 + vectoriel, reranking
3	Archi Agents — Agent Analyste	Preuves → modèle d'architecture
3+	Agents tiers (ex. Agent Revue de sécurité)	Étapes enfichables : contributions sourcées au dossier
4	Archi Agents — Agent Rédacteur	Modèle → texte du dossier
5	Archi Agents — Agent Vérificateur	Anti-hallucination, corrections
6	Archi Agents — Agent Générateur DOCX	Diagrammes + Dossier-Architecture-Final.docx

Configuration requise

Visual Studio Code ≥ 1.95 sous Windows 11 x64.
Mémoire : 32 Go recommandés pour le profil MAX par défaut (≈ 20 Go libres pour le modèle) ; 16 Go suffisent pour BALANCED et FAST (8 Go minimum) ; un poste sans assez de mémoire repasse automatiquement au niveau inférieur.
Espace disque : ≈ 50 Go libres recommandés pour la version 0.1.11 (≈ 38 Go pour le modèle MAX et le reranker, fragments et modèles assemblés, ≈ 2,5 Go pour les agents, cache de téléchargement de VS Code compris) ; ≈ 3 Go pour la version 0.1.10.
Connexion Internet : nécessaire pour télécharger les extensions depuis le Marketplace (≈ 22 Go pour la version 0.1.11), puis plus jamais.

Limites connues

Les modèles sont contraints par la taille maximale d'un paquet Marketplace (voir MODEL-GUIDE.md du projet), d'où les fragments ; la qualité rédactionnelle repose d'abord sur les faits extraits de façon déterministe et sur la vérification, pas sur la seule puissance du modèle.
Une information absente du périmètre analysé n'est jamais inventée : une section sans contenu est omise du dossier et une contradiction non résolue est déclarée « non stabilisée ».

Licence

Apache-2.0. Les composants tiers et modèles embarqués sont listés dans THIRD_PARTY_NOTICES.md.

Contact

Questions, signalements et suggestions : extensionuseful@gmail.com.