loop-engine-v2

Loop Engine v2 — le moteur des routines R4-R9

Chaque routine est un fichier autonome dans references/routines/, avec un bloc CONFIG interchangeable en tête (pattern client-resellable : le même fichier sert tous les clients, seule la CONFIG et la KB changent).

Registre unifié : le catalogue canonique de TOUTES les routines du marketplace (avec identifiants préfixés par domaine) est reference/registre-routines.md à la racine du monorepo — il fait foi. Les noms R4…R9 de ce moteur restent des alias reconnus (rétrocompatibilité) : R4 = FIN-CFO-HEBDO, R5 = STARTUP-BUILDER, R6 = GROWTH-LOOP, R7 = FIN-CASH-SENTINELLE, R8 = FIN-BOARD-MENSUEL, R9 = VIDEO-FACTORY. Les deux formes déclenchent la même routine.

Étape 0 — Références (obligatoire)

Charger ${CLAUDE_PLUGIN_ROOT}/reference/directives-outils.md et SURTOUT ${CLAUDE_PLUGIN_ROOT}/reference/autonomie.md (la gouvernance : ce qu'une routine a le droit de faire seule). Seuils : ./rapido-kb/ prime.

Workflow

1. Identifier la routine demandée :
   • « R4 » / « FIN-CFO-HEBDO », « routine du lundi », « revue finance » → R4-CFO-WEEKLY.md
   • « R5 » / « STARTUP-BUILDER », « avancement startup », « delta d'exécution » → R5-STARTUP-BUILDER.md
   • « R6 » / « GROWTH-LOOP », « boucle growth », « expérience de la semaine » → R6-GROWTH-LOOP.md
   • « R7 » / « FIN-CASH-SENTINELLE », « sentinelle cash », « surveille ma trésorerie » → R7-CASH-SENTINEL.md
   • « R8 » / « FIN-BOARD-MENSUEL », « board mensuel », « pack investisseurs » → R8-MONTHLY-BOARD.md
   • « R9 » / « VIDEO-FACTORY », « épisode du jour », « vidéo du jour », « video factory » → R9-VIDEO-FACTORY.md Ambigu → demander laquelle (ou proposer la séquence hebdo R4→R5→R6).
2. Charger le fichier de routine et appliquer sa CONFIG : les valeurs de ./rapido-kb/ (fuseau, seuils, canaux) écrasent les défauts du bloc.
3. Exécuter les 5 phases du fichier, dans l'ordre : Sense (collecter — lecture seule) → Plan (analyser, prioriser) → Act (préparer/exécuter selon le niveau d'autonomie de reference/autonomie.md — confirmations sur tout envoi/écriture) → Feed (mettre à jour la mémoire : journaux ./rapido-kb/startup/ ; la phase Feed alimente la fiche d'amélioration de la routine — KPI du jour dans routines-journal.md, exploité par le skill amelioration-des-routines / reference/boucle-amelioration.md) → Report (restitution au format de la routine + récap des IDs).
4. Tous les calculs chiffrés passent par le skill catalogue-kpi (scripts/calcul_kpi.py — formule affichée, hook « KPI sans script » actif). Une routine ne calcule JAMAIS de tête.
5. Installer/planifier les routines (« installe mes routines ») : proposer le calendrier (R7 quotidien ou 2×/sem, R4-R6 hebdo, R8 mensuel), créer les événements récurrents Google Calendar (si connecté) après accord, et noter le planning dans ./rapido-kb/startup/routines.md. Pour qu'une routine tourne SANS Claude : skill usine-automatisations (plugin rapido-n8n) — voir le TODO R7 au CHANGELOG.

Garde-fous

• reference/autonomie.md fait LOI : lecture seule par défaut ; écritures par système après confirmation ; envois externes jamais automatiques ; écriture Stripe INTERDITE en routine (hook garde-stripe-write en filet).
• L'agent cfo-virtuel porte les routines financières (R4, R7, R8).
• Une routine qui ne trouve pas ses données le DIT (« pas de visibilité sur X ») — elle n'estime pas, elle n'invente pas.
• Chaque exécution laisse une trace datée dans ./rapido-kb/startup/routines-journal.md (phase Feed).