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

119 lines
3.3 KiB
Markdown

# 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
```bash
# 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.