irpf/docs/workflow-guide.md
Marc Reverdin 60a1523fe0 docs: workflows multiagents + cartographie sources institutionnelles
- workflows/build-theme.js : production complète d'une fiche thème
  (collecte intl + FR + deep research + synthèse Opus + propositions + politique + MDX)
- workflows/build-all-themes.js : orchestration 14 thèmes en parallèle
- docs/institutions-sources.md : cartographie exhaustive des sources mondiales pour la France
  (ONU, FMI, BM, OCDE, UE, Conseil Europe, G7/G20, think tanks, APIs)
- docs/workflow-guide.md : guide d'utilisation et coûts estimés

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-05 19:52:45 +02:00

3.3 KiB

Guide — Workflows de production IRPF

Principe

Les workflows collectent automatiquement les sources internationales et françaises, synthétisent avec Claude Opus, et produisent les fichiers MDX prêts à déployer.


Lancer la production d'UN thème (test/pilote)

Dans Claude Code, utiliser le Workflow tool :

Workflow({
  scriptPath: '/Users/base/Code/30-projects/IRPF/workflows/build-theme.js',
  args: { slug: 'sante', label: 'Santé & Système de soins' }
})

Slugs disponibles :

  • economie-finances
  • sante
  • education
  • environnement
  • defense
  • justice
  • affaires-etrangeres
  • travail-emploi
  • logement
  • agriculture
  • numerique
  • cohesion-sociale
  • democratie
  • europe

Durée estimée par thème : 8-15 min Coût estimé par thème : 60-100k tokens


Lancer la production complète (14 thèmes)

Workflow({
  scriptPath: '/Users/base/Code/30-projects/IRPF/workflows/build-all-themes.js'
})

Durée estimée : 45-90 min (parallèle) Coût estimé : 800k-1,5M tokens

Lancer un sous-ensemble

Workflow({
  scriptPath: '/Users/base/Code/30-projects/IRPF/workflows/build-all-themes.js',
  args: { themes: ['sante', 'education', 'economie-finances'] }
})

Ce que produit le workflow par thème

  1. Collecte internationale — ~10 sources (FMI, OCDE, UE, ONU, think tanks intl)
  2. Collecte française — ~8 sources (INSEE, Cour des comptes, think tanks FR)
  3. Deep research — 3-4 angles spécifiques approfondis
  4. Synthèse Opus — diagnostic 900-1200 mots + 10 indicateurs + 6 enjeux
  5. Propositions Opus — 6-8 mesures détaillées avec mécanisme + budget + pays référence
  6. Lecture politique — dynamiques 2025-2027, partis, blocages, fenêtres
  7. Fichier MDX — prêt pour src/content/themes/[slug].mdx

Après le workflow : intégration dans le site

Le workflow retourne les fichiers MDX dans result.mdx_files. Il faut ensuite :

  1. Sauvegarder les fichiers MDX dans src/content/themes/
  2. Commiter et pusher sur Forgejo
  3. Déclencher le rebuild : curl -X POST https://france.reverdin.eu/_rebuild?token=TOKEN

Script de déploiement post-workflow

# Depuis ~/Code/30-projects/IRPF/
git add src/content/themes/
git commit -m "content: mise à jour fiches thèmes via workflow IRPF"
git push origin main
curl -X POST "https://france.reverdin.eu/_rebuild?token=f76831324704eab2be6e4ef26daf2099539741f1648ec844"

Sources prioritaires par thème

Voir docs/institutions-sources.md pour la liste complète.

Top 5 sources transversales (toujours pertinentes)

  1. OCDE — études économiques + comparaisons 38 pays (stats.oecd.org)
  2. FMI Article IV France — diagnostic macro annuel (imf.org)
  3. Commission européenne Country Report — Semestre européen (ec.europa.eu)
  4. Cour des comptes — audits sectoriels français (ccomptes.fr)
  5. INSEE — toutes données socio-économiques françaises (api.insee.fr)

Coûts et budgets tokens

Action Tokens estimés Durée
1 thème pilote 60-100k 8-15 min
3 thèmes test 200-300k 15-25 min
14 thèmes complet 800k-1,5M 45-90 min

Utiliser /model pour vérifier le modèle actif avant de lancer. Recommandé : lancer d'abord 1 thème pilote, valider la qualité, puis lancer le reste.