Généré le 14/10/2026 10:01

🏛️ SOP : Décision d'Architecture & Conception de Workflows et Pipelines

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 MCP workflow_architect
Statut : Opérationnel & Validé


1. Objectif & Règle d'Or

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.


2. La Matrice des 7 Paradigmes Canoniques

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.

3. Procédure d'Arbitrage Automatisée

Option A : Appel CLI Direct

# 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

Option B : Appel via Outil MCP Universel (JUTL)

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"
  }
}

4. Garde-Fous & Règles de Conception

  1. Hybridation Systématique :
    - Si la recommandation est un Pipeline DAG, chacune de ses étapes unitaires doit être implémentée sous forme de Script CLI Déterministe ou d'Outil MCP, jamais sous forme de code inline dans le moteur de l'orchestrateur.
    - Si la recommandation est un Démon Résident, la logique d'exécution doit vivre dans un script séparé testable via --dry-run, le démon ne servant que de métronome ou de boucle de surveillance.
  2. Robustesse & Crash-Safety :
    - Zéro exception non capturée dans les outils MCP (isError: true propre avec diagnostic).
    - Validation stricte Pydantic V2 (extra="forbid" pour éviter l'injection de paramètres fantômes).
    - UTF-8 garanti sous Windows sans fermeture des descripteurs standards.
  3. Fuseau Horaire de Guadeloupe :
    - Tout ordonnancement temporel ou calcul de date/heure doit s'appuyer sur America/Guadeloupe (UTC-4 toute l'année).
  4. Documentation & Auto-Sync :
    - Dès qu'un nouvel outil MCP est échafaudé, exécuter python tools/sync_mcp_registry.py pour régénérer la notice et propager les schémas à tous les agents.