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).