apistration

Manage the lifecycle of incidents on the API Entreprise / API Particulier Hyperping status pages (entreprise.api.gouv.fr, particulier.api.gouv.fr). Use to list, read, open, update, resolve or delete incidents, post progress updates, and look up monitor or status-page uuids. Triggers — "ouvre/crée un incident", "déclare une panne sur la status page", "mets à jour l'incident", "résous l'incident", "liste les incidents Hyperping", "quel est l'uuid du monitor X", "signale un problème sur entreprise/particulier.api.gouv.fr".

Explorer et analyser une API externe (fournisseur de données) en vue de l'intégrer au catalogue API Entreprise / API Particulier. Use when the user veut explorer/analyser/cadrer une nouvelle API à intégrer, étudier un swagger ou une doc fournisseur, comprendre les payloads/données d'une API tierce, préparer une fiche endpoint dans commons/endpoints, ou produire un document d'exploration + une liste de questions pour le dev fournisseur. Triggers : « explore cette API », « analyse ce swagger », « qu'est-ce qu'on peut exposer », « intégrer l'API X », « doc d'exploration », « questions pour le fournisseur ».

Modifier la documentation d'un endpoint API : fiche metier (perimetre, FAQ, keywords, description) ou swagger (schema OpenAPI, attributs, tags). Utiliser quand l'utilisateur veut editer, ajouter ou mettre a jour un endpoint dans le catalogue API Entreprise ou API Particulier. Triggers : "modifier la fiche", "ajouter un endpoint", "mettre a jour le swagger", "changer la description", "ajouter une FAQ", "modifier le perimetre", "editer endpoint".

Bump an API endpoint fiche from one version to the next (e.g. v3 → v4) in the admin_api_entreprise catalog. Use when the user mentions "bump version", "nouvelle version", "v4", "ajouter une fiche v4", or needs to create a new versioned endpoint entry while keeping the previous one as legacy. Applies to both API Entreprise and API Particulier endpoint YAML files in config/endpoints/.

Release a new version of an official API Entreprise / API Particulier SDK to its package registry (rubygems for Ruby). Covers version bump, CHANGELOG update, release PR, tag conventions, and the OIDC-published workflow. Use when the user mentions "release", "publier", "publish sdk", "bump version sdk", "nouvelle version sdk", "rubygems", or asks to ship a new version of `api_entreprise` / `api_particulier` (Ruby today, more languages to come).

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.

Use when the user asks to sync, import, or check SIADE staging data payload folders against OpenAPI specs - detects missing endpoint folders, creates test payloads matching OpenAPI schemas, and validates with rspec