Budget Reporting
Génère un reporting d'activité périodique pour datagouv/apistration à 4 niveaux de détail.
Prérequis : le MCP linear-server doit être branché (les sujets non-tech — recherche utilisateur, partenariats, COPIL, événements — sont uniquement dans Linear). Si le MCP n'est pas disponible, le signaler à l'utilisateur avant de démarrer ; ne pas tenter de contourner.
Étape 1 — Recueillir les paramètres
Avant toute exploration, poser deux questions à l'utilisateur (en un seul message, format compact) :
- Période : dates de début et fin (ex.
2026-04-01 → 2026-04-30). Déduire le suffixe de fichier (ex. avril, 2026-q2).
- Évolutions notables hors Linear/GitHub : événements structurants invisibles dans les commits/PRs/issues — partenariat signé, COPIL, événement externe, décision d'org, lancement d'un programme transverse, etc.
Ne pas démarrer l'exploration tant que la réponse n'est pas reçue.
Étape 2 — Exploration
Collecter dans cet ordre, en parallèle quand c'est possible :
- Commits sur
develop dans la période :git log --since=YYYY-MM-DD --until=YYYY-MM-DD --pretty=format:'%h %ad %s' --date=short develop
- PRs GitHub sur
datagouv/apistration (mergées + ouvertes + fermées dans la période) :gh pr list --repo datagouv/apistration --state all --limit 200 \
--search "merged:YYYY-MM-DD..YYYY-MM-DD" \
--json number,title,author,mergedAt,labels
gh pr list --repo datagouv/apistration --state all --limit 200 \
--search "created:YYYY-MM-DD..YYYY-MM-DD" \
--json number,title,author,state,createdAt
Lire le body des PRs significatives via gh pr view <num> --repo datagouv/apistration.
- Issues GitHub ouvertes ou fermées dans la période :
gh issue list --repo datagouv/apistration --state all \
--search "created:YYYY-MM-DD..YYYY-MM-DD" --json number,title,author,state
- Linear :
mcp__linear-server__list_issues pour les issues mises à jour dans la période. Filtrer par équipe API Entreprise / API Particulier. Pour les sujets non-tech (recherche utilisateur, partenariats, événements, COPIL), Linear est souvent la seule source.
- Évolutions hors Linear/GitHub fournies par l'utilisateur à l'étape 1.
Étape 3 — Production des livrables
Produire 4 fichiers dans sandbox/ (créer le dossier s'il n'existe pas), avec un suffixe dérivé de la période (ex. avril, 2026-04, 2026-q2) :
| Fichier |
Audience |
Style |
Template |
sandbox/budget-summary-<suffixe>.exploration.md |
trace interne |
brut, exhaustif |
references/exploration.md |
sandbox/budget-summary-<suffixe>.md |
tech / responsables produit |
détaillé, structuré, avec PR# |
references/tech-summary.md |
sandbox/budget-executive-summary-<suffixe>.md |
direction / business |
synthèse non technique |
references/executive-summary.md |
sandbox/budget-flash-<suffixe>.md |
livrable comm |
ultra-court, 3 sections |
references/flash.md |
Lire le template correspondant avant d'écrire chaque fichier.
Règles transversales
- Tout en français.
- Pas d'emojis.
- Numéros de PR (
PR #N) inclus dans exploration et tech-summary ; retirés dans executive et flash.
- Distinguer API Particulier (CNOUS, CAF/CNAV QF, MEN bourses, Pôle Emploi, DGFiP particulier…) et API Entreprise (Data Subvention, GIP-MDS effectifs, INSEE, DGFiP entreprise, Acoss/Urssaf, MICAF…) lorsque le contexte le permet.
- Le fichier
exploration doit permettre de régénérer les 3 autres : y consigner toutes les sources brutes (PRs, commits, issues Linear par identifiant, événements externes).
- Le fichier
flash doit tenir en ~15 bullets sur 3 sections : Évolutions notables / API Particulier / API Entreprise.
- Ne jamais inventer de chiffres : toute volumétrie citée doit provenir de l'exploration.
Étape 4 — Restitution
Annoncer les 4 chemins créés en une phrase. Ne pas recopier le contenu.
1---2name: budget-reporting3description: Génère le reporting d'activité périodique (mensuel, trimestriel) de l'équipe API Entreprise / API Particulier sur le repo `datagouv/apistration` à partir des commits, PRs GitHub et issues Linear. Produit 4 livrables dans `sandbox/` à 4 niveaux de détail. Use when user asks for "reporting budgétaire", "summary du mois", "bilan mensuel", "reporting d'activité", "budget summary", "executive summary mensuel", ou tout reporting périodique d'activité sur apistration.4---56# Budget Reporting78Génère un reporting d'activité périodique pour `datagouv/apistration` à 4 niveaux de détail.910**Prérequis** : le MCP `linear-server` doit être branché (les sujets non-tech — recherche utilisateur, partenariats, COPIL, événements — sont uniquement dans Linear). Si le MCP n'est pas disponible, le signaler à l'utilisateur avant de démarrer ; ne pas tenter de contourner.1112## Étape 1 — Recueillir les paramètres1314Avant toute exploration, poser deux questions à l'utilisateur (en un seul message, format compact) :15161. **Période** : dates de début et fin (ex. `2026-04-01 → 2026-04-30`). Déduire le suffixe de fichier (ex. `avril`, `2026-q2`).172. **Évolutions notables hors Linear/GitHub** : événements structurants invisibles dans les commits/PRs/issues — partenariat signé, COPIL, événement externe, décision d'org, lancement d'un programme transverse, etc.1819Ne pas démarrer l'exploration tant que la réponse n'est pas reçue.2021## Étape 2 — Exploration2223Collecter dans cet ordre, en parallèle quand c'est possible :24251. **Commits sur `develop`** dans la période :26 ```bash27 git log --since=YYYY-MM-DD --until=YYYY-MM-DD --pretty=format:'%h %ad %s' --date=short develop28 ```292. **PRs GitHub** sur `datagouv/apistration` (mergées + ouvertes + fermées dans la période) :30 ```bash31 gh pr list --repo datagouv/apistration --state all --limit 200 \32 --search "merged:YYYY-MM-DD..YYYY-MM-DD" \33 --json number,title,author,mergedAt,labels34 gh pr list --repo datagouv/apistration --state all --limit 200 \35 --search "created:YYYY-MM-DD..YYYY-MM-DD" \36 --json number,title,author,state,createdAt37 ```38 Lire le body des PRs significatives via `gh pr view <num> --repo datagouv/apistration`.393. **Issues GitHub** ouvertes ou fermées dans la période :40 ```bash41 gh issue list --repo datagouv/apistration --state all \42 --search "created:YYYY-MM-DD..YYYY-MM-DD" --json number,title,author,state43 ```445. **Linear** : `mcp__linear-server__list_issues` pour les issues mises à jour dans la période. Filtrer par équipe API Entreprise / API Particulier. Pour les sujets non-tech (recherche utilisateur, partenariats, événements, COPIL), Linear est souvent la seule source.456. **Évolutions hors Linear/GitHub** fournies par l'utilisateur à l'étape 1.4647## Étape 3 — Production des livrables4849Produire **4 fichiers** dans `sandbox/` (créer le dossier s'il n'existe pas), avec un suffixe dérivé de la période (ex. `avril`, `2026-04`, `2026-q2`) :5051| Fichier | Audience | Style | Template |52|---|---|---|---|53| `sandbox/budget-summary-<suffixe>.exploration.md` | trace interne | brut, exhaustif | `references/exploration.md` |54| `sandbox/budget-summary-<suffixe>.md` | tech / responsables produit | détaillé, structuré, avec PR# | `references/tech-summary.md` |55| `sandbox/budget-executive-summary-<suffixe>.md` | direction / business | synthèse non technique | `references/executive-summary.md` |56| `sandbox/budget-flash-<suffixe>.md` | livrable comm | ultra-court, 3 sections | `references/flash.md` |5758Lire le template correspondant avant d'écrire chaque fichier.5960## Règles transversales6162- Tout en français.63- Pas d'emojis.64- Numéros de PR (`PR #N`) inclus dans `exploration` et `tech-summary` ; retirés dans `executive` et `flash`.65- Distinguer **API Particulier** (CNOUS, CAF/CNAV QF, MEN bourses, Pôle Emploi, DGFiP particulier…) et **API Entreprise** (Data Subvention, GIP-MDS effectifs, INSEE, DGFiP entreprise, Acoss/Urssaf, MICAF…) lorsque le contexte le permet.66- Le fichier `exploration` doit permettre de régénérer les 3 autres : y consigner toutes les sources brutes (PRs, commits, issues Linear par identifiant, événements externes).67- Le fichier `flash` doit tenir en ~15 bullets sur 3 sections : Évolutions notables / API Particulier / API Entreprise.68- Ne jamais inventer de chiffres : toute volumétrie citée doit provenir de l'exploration.6970## Étape 4 — Restitution7172Annoncer les 4 chemins créés en une phrase. Ne pas recopier le contenu.
datagouv