routine-matchs

name	routine-matchs
description	Utiliser quand l'utilisateur veut lancer la routine PronoClip, traiter les matchs du jour ou de la journée, générer les vidéos de tous les matchs, ou planifier la production vidéo d'une journée de compétition.

Routine PronoClip — production vidéo par journée de matchs

Orchestre la production de toutes les vidéos de pronostics d'une journée de compétition, en 5 phases calquées sur le LOOP ENGINE : Sense → Plan → Act → Feed → Report.

Cette routine ne génère rien elle-même : elle dispatche le subagent video-composer (rendu, parallélisable) et le skill publication-cms (publication), et s'appuie sur le MCP RapidoRh pour le suivi des tâches. Pour une vidéo unique hors routine, c'est le skill video-pronostic qui s'applique. Lire la section Garde-fous avant toute exécution.

Phase 0 — CONFIG : onboarding au premier lancement

Toute la configuration du plugin vit dans ./pronoclip-data/config.json (CONFIG swappable : aucun skill ne code ces valeurs en dur, le plugin reste revendable en changeant ce seul fichier).

• Si le fichier existe : le charger et passer directement en Phase 1.
• Sinon, dérouler le mini-flow d'onboarding, puis écrire le fichier :

1. CMS — company_id (défaut : 321) ; comptes sociaux cibles via list_connected_accounts, choix validé par l'utilisateur ;
2. RH — projet et colonnes créés/résolus via le skill suivi-rh-daily (Partie A) → IDs numériques ;
3. Compétitions suivies (défaut : Ligue des Champions, Ligue Europa, Euro) ;
4. Style par défaut (défaut : néon), fenêtre de publication (défaut : H-6 → H-2) et langue des captions (défaut : fr) ;
5. Audio/visuel — provider TTS (défaut : kokoro, le seul gratuit), registre de narration, langue de narration, provider BGM, nombre de séquences par vidéo, avatar présentateur (défaut : false, payant), mode de routine (défaut : standard).

Schéma canonique du fichier (source de vérité pour TOUS les skills) :

{
  "cms": {
    "company_id": 321,
    "comptes": [
      { "id": "…", "plateforme": "tiktok", "nom": "…" }
    ]
  },
  "rh": {
    "projet_id": 29,
    "colonnes": {
      "matchs_a_traiter": 101,
      "video_en_cours": 102,
      "publie": 103,
      "echecs_a_reprendre": 104
    }
  },
  "competitions": ["Ligue des Champions", "Ligue Europa", "Euro"],
  "style_defaut": "néon",
  "fenetre_publication": { "max_avant_kickoff_h": 6, "min_avant_kickoff_h": 2 },
  "langue_captions": "fr",
  "tts_provider": "kokoro",
  "elevenlabs_voice_id": null,
  "narration_style": "hype",
  "langue_narration": "fr",
  "bgm_provider": "musicgen",
  "sequences_par_video": 4,
  "avatar_presentateur": false,
  "mode_routine": "standard"
}

Valeurs admises pour le bloc audio/visuel :

Clé	Valeurs	Note
tts_provider	kokoro | elevenlabs | heygen	seuls elevenlabs/heygen sont payants (opt-in)
heygen_voice_id	id voix HeyGen ou null	voix FR du présentateur (skill presentateur-heygen)
elevenlabs_voice_id	id de voix ou null	fige l'identité sonore ElevenLabs
narration_style	hype | analyse | humour	gabarits de scripts-narration.md
bgm_provider	musicgen | lyria | catalogue	musique générée ou catalogue licencié
avatar_presentateur	false | true	true = HeyGen payant, opt-in explicite
mode_routine	standard | light	light = sans images ni audio (tests, journées chargées)

⚠️ Les clés API (ELEVENLABS_API_KEY, HEYGEN_API_KEY) restent dans l'environnement — JAMAIS dans config.json : ce fichier est versionnable et revendable, il ne doit contenir aucun secret.

Phase 1 — SENSE : récupérer les matchs

1. Déterminer la période demandée : une date (« les matchs du 12/07 ») ou une journée de compétition (« la J3 de Ligue des Champions »).
2. Chercher la liste des matchs, dans cet ordre :
   • Fichier local ./pronoclip-data/matchs-{date}.json s'il existe (source de vérité prioritaire) ;
   • sinon, recherche web sur les calendriers officiels des compétitions.
3. Compétitions par défaut (si l'utilisateur ne précise pas) : celles de competitions dans config.json (Ligue des Champions, Ligue Europa, Euro à l'installation).

Format du fichier matchs-{date}.json :

[
  {
    "home": "PSG",
    "away": "Real Madrid",
    "competition": "Ligue des Champions",
    "kickoff": "2026-07-12T21:00:00+02:00",
    "colors": { "home": "#004170", "away": "#ffffff" }
  }
]

Phase 2 — PLAN : tâches RapidoRH + validation

1. Via le MCP RapidoRh, créer une tâche par match dans le projet PronoClip (projet et colonnes définis dans le skill suivi-rh-daily) :

   • Titre : 🎬 Vidéo prono : {home} vs {away} ({competition} — {date})
   • Description : le brief de composition — score à pronostiquer, style graphique, format ;
   • Colonne : Todo.

2. Résumer le plan à l'utilisateur et attendre sa validation :

   N matchs détectés → N tâches créées dans RapidoRH → GO ?

   Aucune génération avant validation explicite. Sans « GO » (ou équivalent clair), s'arrêter là.

Phase 3 — ACT : composition en parallèle, Kanban en séquentiel

La composition vidéo est parallélisée via le subagent video-composer (un agent par match, voir agents/video-composer.md) ; tous les mouvements Kanban et la publication restent séquentiels.

Version dessin animé : si le style demandé est cartoon (ou commande /pronoclip-cartoon), chaque match est confié au skill studio-cartoon (équipe scénariste → directeur artistique → compositeur → vérificateur légal) au lieu du video-composer seul — même contrat de sortie JSON, max 2 studios en parallèle au lieu de 3 compositions.

Traiter les matchs dans l'ordre des coups d'envoi, par lots de 3 compositions simultanées maximum :

1. Dispatch du lot — pour chaque match du lot, séquentiellement : déplacer sa tâche en Doing (move-task) ; puis lancer en parallèle un subagent video-composer par match, avec le brief JSON (home, away, score, compétition, kickoff, couleurs, pseudo, style, format, durée, mode repris de mode_routine dans config.json). Le flag premium: true n'est posé dans un brief qu'après confirmation humaine explicite — jamais par la routine elle-même.
2. Collecte — attendre la fin du lot ; chaque subagent retourne son JSON contractuel {status, mp4_path, duration_s, match, error?}.
3. Suite séquentielle, match par match dans l'ordre du lot :
   • status: "OK" → invoquer le skill publication-cms (upload + planification du brouillon), puis déplacer la tâche en Done ;
   • status: "KO" → logger l'erreur (voir Phase 4), laisser la tâche en Doing avec un commentaire décrivant l'échec (error du JSON), et PASSER AU MATCH SUIVANT — un échec ne bloque jamais la routine.
4. Passer au lot suivant.

Phase 4 — FEED : compléter le log du jour

Compléter ./pronoclip-logs/YYYY-MM-DD.md avec le bilan d'exécution :

• vidéos OK / KO (avec la cause des KO) ;
• posts planifiés (plateforme + créneau) ;
• durées de production par vidéo.

Ce log est la matière première du skill de dailies (/pronoclip-daily).

Phase 5 — REPORT : récapitulatif et suite

1. Présenter à l'utilisateur un tableau récapitulatif :

   Match	Vidéo	Post CMS	Tâche RH
   PSG vs Real 2-1	✅ 2026-07-12_psg-vs-real_2-1_neon.mp4	✅ planifié 18:30	Done
   OM vs Inter	❌ rendu KO (lint)	—	Doing (commentaire)

2. Proposer de lancer /pronoclip-daily pour transformer le log du jour en daily RapidoRH.

Garde-fous

• Max 10 vidéos par exécution. Au-delà de 10 matchs, traiter les 10 premiers (ordre des coups d'envoi) puis re-demander confirmation avant de poursuivre.
• Jamais de planification CMS à moins de 2 h du coup d'envoi : la vidéo doit sortir AVANT le match. Si le créneau viable est déjà passé ou trop proche, ne pas planifier le post ; le signaler dans le log et le rapport.
• Max 3 compositions simultanées : jamais plus de 3 subagents video-composer en parallèle, quel que soit le nombre de matchs.
• Les garde-fous de video-pronostic et les interdits de video-composer s'appliquent à chaque vidéo (pas de logos ni visages, mention IA, rendu local uniquement — jamais le fallback MCP payant dans cette routine).