Réf :
SOP_Decision_Architecture_Workflows.md
Date de création : 10/10/2026
Auteur : Antigravity & Raphaël
Outil pivot système :tools/workflow_architect.py& plugin MCPworkflow_architect
Statut : Opérationnel & Validé
Dès que Raphaël exprime le besoin de créer un workflow, automatiser une tâche, construire un pipeline ou interconnecter des outils, l'agent (Antigravity CLI, Claude Code ou Jarvis Live) ne doit jamais improviser une architecture au hasard (ex: faire du code dans un chat, coder un script monolithique de 1000 lignes ou lancer un agent LLM pour faire des additions).
Il doit systématiquement utiliser le moteur tools/workflow_architect.py (ou l'outil MCP workflow_architect) pour évaluer scientifiquement les contraintes et sélectionner l'architecture optimale parmi les 7 Paradigmes Canoniques de l'écosystème C:\ASSISTANT_IA.
| Paradigme | Emplacement cible | Quand l'utiliser ? (Signaux forts) | Coût Tokens & Latence | Anti-patterns majeurs à proscrire |
|---|---|---|---|---|
| 1. Standalone Script (CLI) | tools/<nom>.py |
Calculs purs, logique ETL, parsing JSON/CSV, requêtes HTTP directes, formules de marges/prix, aucun jugement subjectif. | 0 token / < 100ms | Déléguer à un prompt LLM une tâche déterministe qui prend 5ms en Python. |
| 2. Outil MCP Modulaire (JUTL) | tools/mcp_plugins/<nom>.py |
Fonction unitaire que l'IA (Jarvis Live Voice, Claude, Antigravity) doit pouvoir appeler en direct à la demande pendant une mission. | Très faible (uniquement au call) / < 1s | Écrire une fonction MCP pour un workflow séquentiel de 3 jours. |
| 3. Pipeline Orchestré DAG | pipelines/<slug>/ + orchestrateur/ |
Projets multi-phases complexes (plusieurs heures/jours), branches parallèles, nécessité d'un state.json persistant et de portes Telegram. |
Maîtrisé (sous-agents isolés par phase) | Script monolithique sans checkpoints qui doit tout recommencer à zéro au moindre crash. |
| 4. Démon Résident / Ordonnanceur | tools/<nom>_daemon.py + .vbs |
Surveillance 24/7 permanente, watchdogs, polling de dossiers, déclencheurs temporels récurrents (fuseau Guadeloupe UTC-4). | Nul à minime / Arrière-plan invisible | Lancer un démon lourd pour une tâche appelée une seule fois par mois. |
| 5. Compétence Cognitive (SKILL/SOP) | knowledge/.../SKILL_<nom>.md |
Tâches heuristiques, créativité, copywriting persuasif, stratégie marketing, prompt engineering, analyse CRO humaine. | Variable selon le modèle / Réflexion IA | Vouloir transformer un SOP créatif en script Python rigide incapable d'adapter ses idées. |
| 6. Automatisation Navigateur (CDP/Chrome 9222) | tools/<nom>_browser.py |
Interaction avec des sites protégés (Cloudflare, Turnstile, anti-bot) réutilisant la session Chrome connectée de Raphaël. | Nul à modéré si vision requise / Quelques secondes | Utiliser Playwright headless si une API REST ou reverse-engineering est accessible directement. |
| 7. Bundle Plugin Composite | ~/.gemini/config/plugins/<nom>/ |
Package complet autonome redistribuable regroupant règles (GEMINI.md), compétences (skills/), outils (mcp_config.json) et hooks. |
Configurable / Modulaire | Sur-dimensionner un script unitaire sous forme de plugin lourd. |
# 1. Analyse pure et recommandation
python C:\ASSISTANT_IA\tools\workflow_architect.py --request "Ma description de workflow"
# 2. Analyse + Échafaudage automatique du squelette de code sur disque
python C:\ASSISTANT_IA\tools\workflow_architect.py --request "Ma description" --scaffold --name mon_workflow
# 3. Mode interactif guidé
python C:\ASSISTANT_IA\tools\workflow_architect.py -i
Depuis tout agent supportant le tool-calling (Antigravity CLI, Claude Code, Jarvis Live) :
{
"name": "workflow_architect",
"arguments": {
"request": "Créer un pipeline de test pour extraire 50 avis AliExpress",
"scaffold": true,
"workflow_name": "extract_avis_aliexpress",
"format_output": "structured"
}
}
--dry-run, le démon ne servant que de métronome ou de boucle de surveillance.isError: true propre avec diagnostic).extra="forbid" pour éviter l'injection de paramètres fantômes).America/Guadeloupe (UTC-4 toute l'année).python tools/sync_mcp_registry.py pour régénérer la notice et propager les schémas à tous les agents.