imMamdouhaboammar/agentic-workflow

AgenticWorkflow : Chaîne d'Outils & Compétence Agentique Universelle

Un framework pluripotent de type cellule souche et un moteur d'exécution multi-agents qui transforme des tâches complexes en workflows autonomes, déterministes et auto-vérifiés.

Invariant d'Exécution

$$\text{Intent} \xrightarrow{\text{Recherche}} \text{Plan (SOT state.yaml)} \xrightarrow{\text{Implémentation}} \text{Portes de Qualité 4 Couches} \xrightarrow{\text{Delta pACS}} \text{Livrable Vérifié}$$

---

⚡ Routeur de Mode Dynamique

Détectez le mode souhaité à partir du contexte ou d'indicateurs explicites :

Mode	Phrases Déclencheuses	Flux d'Exécution Principal
1. DESIGN	"concevoir workflow", "nouveau pipeline", "workflow.md"	Génération de blueprint 3 étapes : Recherche → Planification → Implémentation
2. EXECUTE	"exécuter workflow", "lancer pipeline", "démarrer étape"	Pilote de machine à états SOT avec génération de livrable étape par étape
3. AUTOPILOT	"autopilote", "automatisé", "sans intervention"	Auto-approbation des points de contrôle (human) avec journaux de décision ; applique les crochets de sécurité
4. ULW	"ulw", "ultrawork", "rigueur maximale"	3 Intensificateurs : Persistance de Sisyphe, Décomposition Obligatoire, Escalade de Tentative
5. VERIFY	"vérifier étape", "portes qualité", "exécuter pacs"	L0 Anti-Saut → L1 Vérification → L1.5 pACS → L2 Revue Adversaire
6. OPTIMIZE	"optimiser workflow", "réduire temps cycle", "simplifier"	Analyse Lean des goulots, notation d'automatisation, compression du temps de cycle

---

3 Critères Absolus (Canon Constitutionnel)

Chaque workflow, outil et sous-agent créé ou gouverné par cette compétence hérite strictement des 3 Critères Absolus :

1. Critère Absolu 1 : Qualité du Livrable Final

   La vitesse, le coût des tokens, la charge de travail et les limites de longueur sont complètement ignorés. Le seul critère pour chaque décision est la qualité du livrable final.

2. Critère Absolu 2 : SOT Monofichier + Mémoire Hiérarchique

   Tout l'état partagé est concentré dans un seul fichier (state.yaml). La permission d'écriture SOT appartient exclusivement à l'Orchestrateur / Chef d'Équipe. Les agents parallèles ne mutent jamais les fichiers partagés simultanément.

3. Critère Absolu 3 : Protocole de Modification de Code (CCP)

   Avant d'écrire, modifier, ajouter ou supprimer du code, effectuez en interne : Étape 1 (Comprendre l'Intention) → Étape 2 (Analyse d'Impact) → Étape 3 (Plan de Changement). Régi par les Points d'Ancrage de Codage (CAP-1~4).

---

Pile d'Assurance Qualité 4 Couches

flowchart TD
    StepStart["Exécution de l'Étape"] --> L0["L0 : Garde Physique Anti-Saut (Fichier existe & >= 100 octets)"]
    L0 -->|RÉUSSI| L1["L1 : Porte de Vérification (Objectif fonctionnel 100% atteint)"]
    L0 -->|ÉCHEC| Diag["Diagnostic Abductif"]
    L1 -->|RÉUSSI| L15["L1.5 : Auto-évaluation pACS (Score pré-mortem F/C/L)"]
    L1 -->|ÉCHEC| Diag
    L15 -->|ROUGE : <50| Diag
    L15 -->|VERT / JAUNE| L2["L2 : Revue Adversaire (@relecteur + @vérificateur-faits)"]
    L2 -->|RÉUSSI| SOT["Avancer SOT (current_step + 1)"]
    L2 -->|ÉCHEC| Diag
    Diag --> Réessayer["Réessayer avec Hypothèse Alternative (Max 3)"]

1. L0 Garde Anti-Saut : Vérifie de manière déterministe que le livrable existe sur le disque et n'est pas vide (MIN_OUTPUT_SIZE >= 100 octets).
2. Porte de Vérification L1 : Vérification sémantique que tous les critères d'acceptation sont atteints à 100 %.
3. L1.5 pACS (Score de Confiance Agentique Prédictif) : Évaluation pré-mortem sur la Fidélité, l'Exhaustivité, la Logique. $pACS = \min(F, C, L)$.
   • VERT (>= 70) : Progression automatique.
   • JAUNE (50 - 69) : Signaler la dimension faible dans le Journal de Décision et continuer.
   • ROUGE (< 50) : Arrêter et déclencher une reprise.
4. Revue Adversaire L2 : Évaluation indépendante Générateur-Critique par @relecteur et @vérificateur-faits.

---

Moteur d'Optimisation de Workflow (Lean & Automatisation)

Lors de l'analyse ou de l'optimisation de workflows :

• Sévérité du Goulot : Noter les goulots de 1 à 5.
• Potentiel d'Automatisation : Quantifier les tâches manuelles pour délégation agentique.
• Réduction d'Erreurs : Implémenter des portes de qualité aux causes racines avant la propagation des défaillances.
• Réduction du Temps de Cycle : Viser une réduction >= 40 % du temps de cycle tout en augmentant la qualité du livrable.

---

Moteur Autonome Auto-alimenté & Disjoncteur

Le système fonctionne comme un moteur autonome de bout en bout avec une gestion d'énergie intégrée :

1. Boucle d'Auto-alimentation & d'Énergie : Surveillance dynamique des tokens et de la marge de contexte avec compactage automatique de l'état RLM et points de contrôle de ravitaillement avant l'épuisement du contexte.
2. Disjoncteur Fable : Transitions d'état FERMÉ → OUVERT → MI-OUVERT. Arrête automatiquement le martèlement spéculatif lorsque la séquence d'échecs consécutifs $\ge 2$, isole les causes racines via le Diagnostic Abductif (diagnose_context.py) et exécute une récupération structurée.
3. Garde de Code Propre : Passe de vérification AST automatique vérifiant les 24 impératifs du code propre (petites fonctions, noms révélant l'intention, maximum 4 paramètres, pas d'exceptions avalées, pas de mocks de succès factices).
4. Évaluation d'Ingénierie IA : Test d'impact disparate quatre cinquièmes intégré ($\ge 0.80$), surveillance de la dérive de distribution PSI et assainissement adversarial des injections d'invites.

---

Intégration CLI & Chaîne d'Outils

# Lancer un workflow autopilote autonome de bout en bout avec auto-alimentation et gestion d'énergie
agentic-workflow autopilot --title "Pipeline de Production" --goal "Livraison Autonome"

# Exécuter une passe de vérification du Garde de Code Propre (SOLID, 24 Impératifs, modes de défaillance IA)
agentic-workflow guard [répertoire]

# Exécuter les portes d'évaluation d'équité, de dérive et d'injection d'invites de l'Ingénieur IA
agentic-workflow eval

# Interroger les journaux de traces observables multi-agents et les spans
agentic-workflow traces

# Initialiser l'infrastructure, les répertoires d'exécution SOT et les vérifications de santé
agentic-workflow init

# Valider le schéma du workflow, l'intégrité SOT et les journaux pACS
agentic-workflow validate

# Vérifier le tableau de bord en direct du workflow et les métriques d'observabilité
agentic-workflow status

# Exécuter la suite de tests automatisée complète (sécurité, garde, MAS, évaluateur)
agentic-workflow test

---

Carte de Référence

• Architecture & ADN : soul.md, AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md
• Manuel d'Utilisation : AGENTICWORKFLOW-USER-MANUAL.md
• Directive Commune : AGENTS.md, CLAUDE.md, GEMINI.md
• Protocoles : docs/protocols/ (exécution-autopilote, portes-qualité, mode-ulw, protocole-modification-code, détails-préservation-contexte)
• Sous-agents : .claude/agents/ (relecteur, vérificateur-faits, traducteur)
• Scripts : .claude/hooks/scripts/ (garde_contexte, valider_pacs, valider_revue, etc.)