# IAKifech ep.1 — postmortem production vidéo hermes-nabil (23/07/2026)

## Correctif 24/07/2026

Ce runbook décrivait à tort le projet `tunisia_steg` (documentaire coupures
d'électricité) comme l'épisode 1 publié de la chaîne IAKifech. C'est faux.
Confirmé par Nabil et vérifié par durée exacte des fichiers : l'épisode 1 réel
est "Qu'est-ce que l'IA, vraiment" (`ia-tn-01-ia-est-ce-que-la.mp4`, 22/07,
56,1s), auquel logo + écran de fin ont été ajoutés le 23/07
(`main_with_logo.mp4` 56,1s puis `iakifech_ep01_v2.mp4` 61,1s = 56,1 + les 5s
d'`ending.mp4`). `tunisia_steg` était un test de capacité de hermes-Nabil mené
dans la même session, sans rapport avec la chaîne IAKifech, jamais publié sous
ce nom.

Le diagnostic technique ci-dessous (57 erreurs, skills verrouillées, timeouts,
échappement bash) reste valable tel quel : les deux tâches (test + finition de
l'épisode 1 réel) ont tourné dans la même session agent
(`20260722_175446_928f5c0f`), les mêmes erreurs de comportement s'appliquent
aux deux. Seul le "Contexte" ci-dessous a été corrigé.

## Contexte

Session de production hermes-nabil du 23/07, 13h37 à 22h00 (8h30), couvrant
deux tâches distinctes : un test de capacité vidéo sur un sujet ambitieux
(documentaire 5 actes sur les coupures d'électricité tunisiennes, projet
`/data/videos/tunisia_steg/`, jamais publié), et la finition de l'épisode 1
réel de la chaîne IAKifech ("Qu'est-ce que l'IA, vraiment", logo + écran de fin
ajoutés à une vidéo déjà tournée le 22/07). 57 erreurs loggées dans
`/data/logs/errors.log` pour la journée, toutes tâches confondues.

## Diagnostic (par catégorie, 57 erreurs)

**33/57 (58%) — tentatives refusées de patcher des skills verrouillées.**
`skill_manage` a refusé à répétition des patchs sur `video-use`, `manim-video`,
`documentary-video`, `moneyprinterturbo` (toutes `created_by=None`, donc
manuellement écrites, off-limits à l'édition autonome). L'agent retentait après
chaque refus au lieu d'apprendre — cause principale de la perte de temps/tokens,
pas un problème de rendu vidéo.

**5/57 — timeouts sur rendus longs.** Le terminal timeout par défaut (120s) a
tué des commandes ffmpeg/Manim de plusieurs minutes. Pattern nohup+tail déjà
établi ailleurs dans l'infra (VPS, NAS) mais pas appliqué ici.

**4/57 — bugs d'échappement / syntaxe.** `python3 -c "..."` inline avec du texte
français à apostrophes (légendes TikTok/YouTube) casse l'échappement bash.
Un `NameError: WHITE` (variable de couleur non définie) est resté jusqu'à
21h57, juste avant l'envoi final.

**Mémoire persistante saturée** en cours de session (plafond ~1375 caractères),
consolidation à chaud plutôt qu'anticipée.

**Symptôme visible côté fichiers (projet tunisia_steg)** : quatre
reconstructions complètes du montage (`final_v1` → `final_v4_gerard.mp4`),
deux chemins de production menés en parallèle (segments/acts vs Manim) au lieu
d'un choix tranché en amont.

## Fix appliqué (SOUL.md hermes-nabil, backups `SOUL.md.bak_production_20260723`
et `SOUL.md.bak_outilspayes_20260724`)

Règles ajoutées le 23/07 :

1. **OUTILS REFUSÉS — RÈGLE ABSOLUE** (nouvelle section, même niveau que
   LANGUE/ÉCRITURE) : un refus `skill_manage` est définitif pour la session,
   pas de nouvelle tentative reformulée, signalement à Nabil en fin de session
   plutôt que contournement par répétition.
2. **PRODUCTION VIDÉO — RÈGLES OPÉRATIONNELLES** (nouvelle section, fin de
   fichier) : rendu long toujours en `nohup ... > log &` + `tail -f`, jamais en
   foreground.
3. Même section : scripts Python à texte français toujours écrits via
   `cat > script.py <<'EOF'` puis exécutés séparément, jamais en `python3 -c`
   inline.
4. Même section : une seule méthode de montage tranchée avant lancement,
   pas de changement de méthode en cours de tâche après un échec.

Règle ajoutée le 24/07 :

5. **OUTILS PAYÉS IAKifech — PRIORITÉ JUSQU'À ÉPUISEMENT** : ElevenLabs (voix)
   et Atlas Cloud/Seedance (vidéo) en priorité systématique jusqu'à épuisement
   du quota mensuel, edge_tts et Manim seul restent légitimes mais en repli
   uniquement — pas un choix par défaut.

Container redémarré à chaque modification (restart simple, recharge le prompt,
pas de rebuild).

## Tâches ouvertes (24/07, voir `/data/nyora/ia-tn/TACHES.md` sur hermes-nabil)

Logo rond à retravailler (silhouette trop fine, contraste insuffisant en petit
format) puis appliquer systématiquement. Écran de fin générique à produire,
brief complet dans `ENDING-BRIEF.md`. Épisode 2 : reprendre la roadmap
`topics.md` au sujet #2 ("IA, algorithme, automatisation").

## À surveiller au prochain épisode

Vérifier si les 33 tentatives de patch skill disparaissent (ou au moins ne se
répètent plus après un premier refus). Si le pattern nohup+tail n'est pas
spontanément adopté par l'agent malgré la règle écrite, envisager un timeout
terminal plus long par défaut spécifiquement pour les commandes ffmpeg/Manim
plutôt que de compter sur la discipline de l'agent.