catalogue-kpi

Catalogue KPI — formules, données réelles, calcul par script

Un KPI = une formule exacte + des données MCP réelles + un calcul par script. Jamais de calcul de tête, jamais de chiffre sans formule affichée.

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

Charger ${CLAUDE_PLUGIN_ROOT}/reference/directives-outils.md, references/formules-kpi.md (LE catalogue : formule, outils MCP, fréquence, seuil, pièges par KPI) et les seuils : ./rapido-kb/processus-internes.md PRIME, sinon ${CLAUDE_PLUGIN_ROOT}/reference/seuils-defaut.md (le dire : « défaut secteur »).

RÈGLE ABSOLUE — le script calcule, pas le modèle

Pour CHAQUE KPI demandé, dans cet ordre :

1. Collecter les données via MCP (outils exacts listés par KPI dans references/formules-kpi.md) — lecture seule ; montants Stripe convertis des CENTIMES vers l'unité AVANT d'écrire les entrées, conversion annoncée.
2. Écrire le JSON d'entrées : {"kpi": "...", "entrees": {...}, "seuil": {...}, "source_seuil": "rapido-kb | seuils-defaut"} — chaque entrée tracée (outil source + période).
3. Exécuter python3 ${CLAUDE_PLUGIN_ROOT}/skills/catalogue-kpi/scripts/calcul_kpi.py avec ce JSON sur stdin.
4. Afficher TOUJOURS la formule avec les valeurs (champ formule_appliquee de la sortie), la valeur, le seuil retenu et sa source, et le statut (ok / attention / alerte).

Un hook Stop (garde-calcul-script) BLOQUE toute réponse qui annonce un KPI chiffré sans exécution du script dans le tour — ne pas le contourner : si le script ne couvre pas un cas, le dire et proposer d'étendre le catalogue, pas calculer de tête.

Workflow type

1. Comprendre la demande : un KPI précis, ou un panorama (« comment se porte ma boîte en chiffres » → les 5-8 KPI pertinents selon l'activité : SaaS → MRR/churn/NRR/runway ; restaurant → food cost/ticket moyen/marge ; services → charge vs contrat/coût de revient/DSO ; commercial → vélocité/coverage).
2. Même période partout dans un panorama multi-serveurs.
3. Collecte MCP → JSON → script → restitution (formule visible, source des données, source du seuil).
4. Routine Loop Engine : mêmes étapes, sortie JSON du script reprise telle quelle ; la fréquence de calcul par KPI est dans le catalogue.
5. Proposer d'enregistrer les valeurs marquantes dans ./rapido-kb/startup/business-plan/hypotheses.md (source + date) si un business plan est en cours (skill interview-business-plan).

Pièges (rappel — détail par KPI dans formules-kpi.md)

• Churn annuel = composé : 1 − (1 − churn_mensuel)^12, JAMAIS ×12.
• Montants Stripe en centimes : convertir avant le JSON d'entrées.
• Contrat annuel dans le MRR : montant annuel ÷ 12, pas compté le mois de signature.
• Un KPI sans seuil comparable (KB ou défaut) se restitue « sans seuil » — pas de verdict inventé.
• Données partielles (serveur absent, période incomplète) : le dire, ne pas extrapoler.

Source unique des formules (anti-divergence)

Ce skill est la source de vérité des formules KPI du marketplace. Tout autre skill qui a besoin d'un CAC, LTV, ratio, coverage, runway, DSO… reprend la formule d'ici (mêmes définitions), jamais une variante locale :

• rapido-marketing:attribution-kpi-marketing : son CAC par canal = dépense/clients (même formule) ; ce qui lui est propre = la répartition/attribution par canal (que ce skill ne fait pas) + LTGP/ROI marketing (≠ LTV).
• rapido-marketing:money-math-acquisition : délègue tout calcul ici.
• rapidocrm:pilotage-commercial, routines VENTE-*, Loop Engine : coverage et ratios calculés ici, jamais de tête.

Le Registre des KPIs (reference/registre-routines.md) liste chaque KPI, sa formule canonique, son script propriétaire et les skills autorisés à le citer.