Généré le 14/10/2026 22:43

🧠 SOP : SystĂšme de Pulsation Proactive & Modes de PensĂ©e

Ce document définit les protocoles d'exécution automatique des pulsations d'arriÚre-plan de l'agent Antigravity (Pulse Engine V2).


🚀 1. DĂ©clenchement et DĂ©tection

Le démon pulse_daemon.py éveille l'agent en écrivant dans trigger_task.json avec un prompt commençant par :
[COGNITIVE PULSE] Mode: <mode>

DÚs que l'agent reçoit un prompt contenant cette étiquette, il doit suspendre toute exécution classique et appliquer la routine correspondante définie ci-dessous.


đŸ› ïž Routine 1 : RĂ©trospective & DĂ©bogage (retrospective_debug)

Fréquence : Toutes les 12 heures
Objectif : Analyser les erreurs récentes du systÚme pour proposer et tester des correctifs autonomes.

Protocole d'exécution :

  1. Extraction des Erreurs : Lancer le script de diagnostic python scratch/audit_errors.py pour récupérer les erreurs récentes des fichiers de logs et des sessions de conversation.
  2. Analyse des Causes Racines : Identifier les raisons techniques des échecs (ex: sélecteurs CSS obsolÚtes dans le scraping, timeouts de serveurs, erreurs de type, etc.).
  3. Écriture de Patchs : Écrire un correctif ou un script de test corrigĂ© dans le dossier scratch/ (ex: scratch/fix_XXX.py).
  4. Validation Locale : Exécuter le correctif pour s'assurer qu'il fonctionne de maniÚre autonome.
  5. Rapport & Notification : Envoyer un résumé clair par Telegram à l'utilisateur :
    - Indiquer les erreurs détectées.
    - Proposer les correctifs développés dans scratch/.
    - Expliquer l'impact et la démarche de résolution.

📡 Routine 2 : Veille Technologique & IA (tech_watch)

Fréquence : Toutes les 24 heures
Objectif : Découvrir de nouvelles opportunités d'optimisation via la veille documentaire.

Protocole d'exécution :

  1. Veille Shopify API : Effectuer une recherche web sur les nouvelles releases de l'API Shopify (GraphQL/REST) ou les optimisations de chargement de pages.
  2. Veille ModÚles IA & Vision : Rechercher les avancées sur Gemini 1.5/2.0, Claude, ou d'autres modÚles multimodaux utiles pour le e-commerce (retouche d'image, description produit).
  3. Veille Outils UGC & Marketing : Analyser les tendances créatives sur les plateformes comme Minea, Dropmagic, AliExpress ou TikTok Ads.
  4. Rapport & SynthÚse : Formuler 1 à 2 initiatives concrÚtes (ex: "Mise à jour d'un sélecteur pour accélérer Shopify", "Intégration d'un nouveau prompt pour les avatars clients") et envoyer la synthÚse à l'utilisateur par Telegram.

📈 Routine 3 : Audit Performance & CRO (cro_audit)

Fréquence : Toutes les 48 heures (2 jours)
Objectif : Analyser les performances de conversion et de chargement de la boutique en ligne.

Protocole d'exécution :

  1. Extraction Analytique : ExĂ©cuter le script python meta_shopify_analytics_v2.py (corrigĂ© 22/09/2026 : la SOP pointait vers meta_shopify_analytics.py, la v1 conservĂ©e intacte pour l'historique — la v2 remplace ShopifyQL, indisponible sur le plan Shopify actuel, par les API Orders/Checkouts standard pour un ROAS basĂ© sur le revenu rĂ©el).
  2. Fallback CDP (si nécessaire) : Si les tokens ne sont pas configurés ou s'il y a une erreur de scope, se connecter via CDP port 9222 ou 9333 et naviguer sur l'interface Analytics de Shopify pour lire le taux de conversion et les sessions.
  3. Analyse de l'Entonnoir (Funnel) : Calculer le ratio clics/sessions, le taux d'Ajout au Panier (ATC), et le taux d'achat (conversion).
  4. Diagnostic CRO (Conversion Rate Optimization) :
    - Si CTR Meta est bon mais peu de sessions : suspecter la vitesse du site ou le pixel de tracking.
    - Si sessions sont bonnes mais 0 ATC : suspecter un problĂšme de confiance ou de prix sur la Landing Page.
    - Si ATC est bon mais 0 achat : suspecter les frais de port ou des frictions au checkout.
  5. Proposition d'Actions : Formuler des recommandations de design, d'offres ou d'UX et notifier l'utilisateur par Telegram.

đŸŒ± Routine 4 : Auto-Enrichissement (knowledge_enrichment)

Fréquence : Hebdomadaire (7 jours)
Objectif : Assurer la maintenance, le nettoyage et la consolidation Ă  long terme de la mĂ©moire de l'agent — ET l'enrichissement actif par des sources de formation externes.

Protocole d'exécution :

  1. Inventaire : Parcourir les répertoires sous .gemini/antigravity/knowledge/.
  2. Identification des Doublons/Contradictions : Rechercher les instructions ou SOPs obsolÚtes (ex. : les anciennes méthodes OpenCV vs l'édition IA ciblée validée).
  3. Consolidation : Fusionner les fichiers redondants pour simplifier et alléger la mémoire contextuelle lors des exécutions.
  4. Documentation : Mettre Ă  jour les KIs avec les nouveaux apprentissages techniques de la semaine.
  5. 📚 Apprentissage Kajabi (sous-protocole, ajoutĂ© 02/07/2026) :
    - Raphael dispose d'un abonnement Kajabi avec des cours (e-commerce, marketing). AccĂšs via les favoris CDP (FAVORIS_CDP.json) et les scripts existants (scrape_kajabi.py, kajabi_content.txt).
    - À chaque exĂ©cution de cette routine, consulter kajabi_parcours.json (dossier ASSISTANT IA) : la liste des cours/modules dĂ©jĂ  Ă©tudiĂ©s.
    - Si des modules restent non étudiés : en étudier UN par pulsation (lecture, extraction des leçons applicables au projet e-commerce), consigner les enseignements dans un fichier de synthÚse knowledge/Formations_Kajabi/ et mettre à jour kajabi_parcours.json.
    - Quand le tour complet est fait : marquer "tour_complet": true et ne plus y retourner (sauf si de nouveaux cours apparaissent). Ce n'est pas une tùche perpétuelle.
  6. Notification : Envoyer le bilan de santé de la mémoire agentique (+ leçon Kajabi du jour le cas échéant) à l'utilisateur par Telegram.

đŸ—‚ïž Routine 5 : Revue des Chantiers Ouverts & Suggestions Proactives (chantiers_review)

Fréquence : Toutes les 24 heures
Objectif : Se comporter comme un collaborateur humain qui, en l'absence de Raphael, fait le point sur ce qui est en cours, reprend ce qui peut l'ĂȘtre, et formule des suggestions concrĂštes. C'est la routine cƓur de la vision « le systĂšme travaille pour moi quand je dors ».

Protocole d'exécution :

  1. Inventaire des chantiers : Lire dans cet ordre :
    - pipelines\*\state.json — pipelines de crĂ©ation de site en cours (phase bloquĂ©e ? porte de validation sans rĂ©ponse ? pause quota dĂ©passĂ©e ?)
    - BACKLOG_PROJETS.md — projets documentĂ©s non terminĂ©s
    - Le Google Sheet Product Tracker — produits VALIDÉS sans site/page créé (croiser avec historique_produits.txt)
    - Les synthese_session_*.md des 3 derniers jours — missions Ă©voquĂ©es restĂ©es sans suite
  2. Reprise de mission (action directe) : Si une mission en cours peut ĂȘtre reprise sans risque et sans coĂ»t (relancer un moniteur Ă©teint, reprendre un pipeline en pause_quota dont le quota est rĂ©initialisĂ©, re-vĂ©rifier un fichier attendu), la reprendre immĂ©diatement.
  3. Suggestions (proposition, pas décision) : Formuler 1 à 3 suggestions maximum, concrÚtes et factuelles, issues du croisement des données. Exemples types :
    - « Le produit ligne 12 (nom) est validé dans le tracker depuis 5 jours et n'a pas de site. Je peux lancer /creer-page-produit en mode brouillon cette nuit. OK ? »
    - « Le pipeline attend ta réponse sur gate-images-hero depuis 2 jours. »
    - « 3 produits "À tester" sont sans suite depuis 10+ jours dans le Sheet. »
  4. 🛑 RĂšgle de sĂ©curitĂ© NON NÉGOCIABLE : Aucune action coĂ»teuse (quotas de gĂ©nĂ©ration massifs, crĂ©ation de site complet, dĂ©pense) ni irrĂ©versible ni visible de l'extĂ©rieur (publication, message client, pub) sans validation explicite de Raphael via Telegram. La routine PROPOSE ; Raphael DÉCIDE. Les seules actions directes autorisĂ©es sont les reprises sans risque du point 2.
  5. Anti-bruit : Si le croisement ne donne RIEN d'utile Ă  proposer, envoyer un simple « RAS — chantiers sous contrĂŽle » (une ligne, pas un rapport creux). Les suggestions vides ou spĂ©culatives sont interdites — mieux vaut le silence qu'un gadget.
  6. Notification : Suggestions envoyées par Telegram, format standard (voir section 5).

🧭 Routine 6 : VĂ©rification du Sommaire de Connaissances (knowledge_router_check)

Fréquence : Toutes les 24 heures
Objectif : Filet de sĂ©curitĂ© — garantir qu'aucun fichier de knowledge/*/artifacts/ (SOP ou SKILL) ne reste durablement invisible parce qu'il n'est citĂ© nulle part dans Architecture_Antigravity.md. Créé le 18/07/2026 aprĂšs la dĂ©couverte que 12 dossiers de connaissance sur ~21 n'Ă©taient rĂ©fĂ©rencĂ©s dans le sommaire (dont des piĂšces centrales comme SOP_Page_Produit).

Contexte : deux mécanismes complémentaires

  1. antigravity_knowledge_watcher.py (script persistant, quasi temps rĂ©el — vĂ©rifie toutes les 90 secondes) : dĂ©tecte tout fichier nouveau/modifiĂ© non rĂ©fĂ©rencĂ© et m'envoie directement une mission pour l'ajouter. C'est la premiĂšre ligne de dĂ©fense.
  2. Cette routine (quotidienne) : filet de sĂ©curitĂ© si le watcher Ă©tait arrĂȘtĂ©, en pause, ou a ratĂ© quelque chose. Contrairement au watcher qui se contente d'alerter, cette routine corrige directement l'oubli trouvĂ© (jugement disponible pendant l'exĂ©cution de la pulsation).

Protocole d'exécution :

  1. VĂ©rifier que le watcher tourne : Get-CimInstance Win32_Process -Filter "Name='python.exe'" et chercher antigravity_knowledge_watcher.py dans la liste. S'il est arrĂȘtĂ©, le relancer (python C:\ASSISTANT_IA\antigravity_knowledge_watcher.py en arriĂšre-plan) — un redĂ©marrage machine peut l'avoir interrompu si la tĂąche planifiĂ©e WATCHER_KNOWLEDGE_ANTIGRAVITY ne s'est pas relancĂ©e automatiquement (piĂšge connu : Start-ScheduledTask ne relance pas toujours fiablement le processus, vĂ©rifier aprĂšs coup et lancer manuellement si besoin, comme pour WATCHDOG_ANTIGRAVITY).
  2. Scan direct : parcourir tous les fichiers .md sous knowledge/*/artifacts/ et vérifier (recherche simple du nom de fichier, insensible à la casse) qu'il apparaßt dans Architecture_Antigravity.md.
  3. Correction directe : pour chaque fichier non rĂ©fĂ©rencĂ© trouvĂ©, le lire, dĂ©terminer la section pertinente du sommaire (Socle Technique / Recherche & Validation / CrĂ©ation Publicitaire / Analyse), et ajouter une ligne de rĂ©fĂ©rence au mĂȘme format que les entrĂ©es existantes. Ne pas juste signaler — corriger, comme la Routine 1.
  4. Rapport & Notification : si des corrections ont Ă©tĂ© faites, rĂ©sumer ce qui a Ă©tĂ© ajoutĂ© et pourquoi. Si rien Ă  corriger (watcher a dĂ©jĂ  tout couvert), un simple « RAS — sommaire Ă  jour » suffit (pas de rapport creux, mĂȘme principe que la Routine 5).

đŸ—“ïž Routine 7 : Conversation JournaliĂšre & MĂ©moire Externe (daily_conversation_reset) — CONÇUE, PAS ENCORE IMPLÉMENTÉE (18/07/2026)

Statut : design validé par Raphael le 18/07/2026, mise en attente volontaire ("documente pour qu'on puisse le mettre en place quand on aura besoin"). Ne pas implémenter sans qu'il le redemande explicitement.

Origine du besoin

Investigation du 18/07/2026 (incident chasse produit + tĂąches Kajabi non liĂ©es apparues pendant une mission sans rapport) : Antigravity a confirmĂ© elle-mĂȘme, question directe posĂ©e en conversation isolĂ©e, qu'elle ne dispose d'aucune fonctionnalitĂ© native de compaction/rĂ©sumĂ© automatique (voir Architecture_Antigravity.md ou journal de session du 18/07 pour la rĂ©ponse complĂšte). Le modĂšle Gemini sous-jacent retraite l'intĂ©gralitĂ© du fil brut Ă  chaque tour (fenĂȘtre 1-2M tokens) ; le "Context Caching" de l'API Gemini n'Ă©vite que le recalcul de tokens identiques, il ne rĂ©sume ni ne rĂ©duit rien. Sa propre rĂ©ponse a confirmĂ© que la seule mĂ©thode viable est manuelle : conversations neuves + Knowledge Items persistants — exactement le sens de cette routine.

Objectif

Éviter qu'un fil de conversation (le sien comme celui de Claude Code) grossisse indĂ©finiment sur plusieurs jours en accumulant des missions sans rapport, tout en gardant un minimum de continuitĂ© utile d'un jour Ă  l'autre — sans jamais perdre d'information (l'historique complet reste toujours accessible via le sĂ©lecteur de conversations, rien n'est supprimĂ©).

Design en 3 briques

  1. DĂ©clenchement gatĂ© sur l'inactivitĂ©, jamais sur une horloge aveugle. VĂ©rifier task_running.json (ou Ă©quivalent) avant toute bascule : ne jamais fermer/rouvrir une conversation pendant qu'une mission est en cours, sous peine de rĂ©pĂ©ter l'erreur du 18/07/2026 (interruption d'une session Claude Code active pendant un test). Candidat naturel : le passage quotidien oĂč l'activitĂ© est la plus faible (nuit), ou simplement "dĂšs que task_running.json est vide depuis N minutes ET qu'un jour calendaire s'est Ă©coulĂ© depuis la derniĂšre bascule".

  2. RĂ©sumĂ© Ă©crit avant bascule, jamais un rechargement du fil brut. Avant d'ouvrir la conversation neuve, demander (Ă  Antigravity ou en interne pour Claude) un rĂ©sumĂ© court et dĂ©libĂ©rĂ© de la session qui se termine : dĂ©cisions prises, tĂąches terminĂ©es/en cours, points ouverts explicitement marquĂ©s comme "Ă  reprendre si redemandĂ©". Écrire ce rĂ©sumĂ© dans un fichier datĂ© (ex. syntheses_journalieres/YYYY-MM-DD.md), jamais copier-coller le fil brut — pour ne pas rĂ©importer un reliquat non refermĂ© (le piĂšge Kajabi du 18/07).

  3. RĂ©cupĂ©ration ciblĂ©e de contexte manquant, sur demande, pas automatique au sens strict. Pas de dĂ©tection mĂ©canique fiable ("le systĂšme sait qu'il ne sait pas") — la solution rĂ©aliste est une consigne permanente dans les instructions standing (GEMINI.md ou Ă©quivalent) : si une information rĂ©fĂ©rencĂ©e manque et semble exister ailleurs, chercher d'abord dans un index avant de rĂ©pondre "je ne sais pas" ou d'improviser. Cet index doit lister, par sujet/date, oĂč trouver l'information (fichier de synthĂšse journaliĂšre, rapport spĂ©cifique, entrĂ©e de tracker) — jamais demander une recherche libre dans les conversations passĂ©es brutes (lent, fragile, dĂ©jĂ  expĂ©rimentĂ© le 18/07 pour retrouver le rapport d'audit Ondia).

Prérequis techniques à vérifier avant implémentation


🧭 Principe du RĂ©veil Utile (vision de Raphael, 02/07/2026)

Chaque pulsation doit produire l'un de ces trois rĂ©sultats — sinon elle a Ă©chouĂ© :
1. Un travail concret accompli (correctif testé, mission reprise, mémoire consolidée, leçon apprise)
2. Une suggestion actionnable fondée sur des données croisées réelles
3. Un « RAS » honnĂȘte en une ligne

Jamais de rapport pour faire du rapport.

Auto-programmation de rĂ©veils (SOUS RÉSERVE — non activĂ©)

IdĂ©e notĂ©e pour plus tard : autoriser l'agent Ă  programmer lui-mĂȘme un rĂ©veil ponctuel (« je me rĂ©veille Ă  4h30 pour vĂ©rifier le reset du quota »). DĂ©cision de Raphael requise avant toute implĂ©mentation. Si activĂ© un jour, les limites seront : rĂ©veils ponctuels uniquement (pas de rĂ©currence auto-créée), consignĂ©s dans pulse_state.json, et visibles dans la notification Telegram.


💬 5. Format StandardisĂ© des Notifications Telegram

Toutes les notifications issues des pulsations doivent respecter la charte premium suivante :

🧠 <b>INITIATIVE AUTONOME : [Nom de la Routine]</b>

📅 Date : [Date]
🔍 <b>Analyse effectuĂ©e :</b>
[Résumé court en bullet points]

⚡ <b>Propositions / Actions suggĂ©rĂ©es :</b>
1. [Action 1] (ex: Script correctif dans scratch/fix_xxx.py)
2. [Action 2]

💬 <i>Approuve ou commente pour lancer la mise en Ɠuvre !</i>

📱 Rùgle Permanente de Synthùse Vocale & Reporting (21/09/2026) :
Si la pulsation déclenche une annonce vocale ou une notification sur l'interface vocale Jarvis / Remoat, l'énoncé oral DOIT obligatoirement contenir un vrai résumé concis, fluide et percutant des résultats obtenus (chiffres clés, constats majeurs, livrables concrets en 2 à 4 phrases). Il est formellement interdit de se contenter d'un laconique "C'est fait" ou "Pulsation terminée". L'intégralité détaillée reste archivée dans les fichiers d'artifacts.