Aller au contenu principal

Comment fonctionne notre automatisation

Avancé

Page de transparence : voici la mécanique qui aide à garder AILmanac frais et de haute qualité avec un effort minimal de la part des mainteneurs. Le principe en filigrane : l'automatisation fait remonter le travail pour que des humains l'approuvent — elle ne publie jamais en silence des affirmations non vérifiées.

Le contrôle de build (actif)​

Chaque modification est construite avec onBrokenLinks: 'throw', de sorte qu'un lien interne mort ou un MDX cassé fait échouer le build avant la fusion. C'est le contrôle le plus précieux — il garde la navigation fiable.

Workflows de CI​

Les fichiers de workflow vivent sur la branche ci-workflows et sont activés une fois que le dépôt dispose d'un token doté du scope workflow (voir le README). En attendant, le site est déployé depuis la branche gh-pages.

  • build-check — construit chaque PR (les liens cassés font échouer le build). Un contrôle obligatoire.
  • deploy — construit et publie sur GitHub Pages à chaque push sur main.
  • link-check — lychee s'exécute chaque semaine et sur les PR ; en cas de liens externes cassés, il ouvre une issue de suivi (étiquette link-rot) au lieu de simplement passer au rouge.

Automatisation de la fraîcheur (planifiée / par étapes)​

  • Surveilleur de versions — une tâche planifiée qui interroge la documentation/le changelog d'Anthropic ainsi que les surfaces grand public qui évoluent le plus vite (apps, voix, mobile, marketplace). En cas de changement, elle ouvre une issue/PR étiquetée upstream-change + needs-verification pointant vers les pages probablement concernées. Un humain rédige la mise à jour.
  • Vérificateur du tableau des modèles — compare data/models.json à la liste officielle des modèles et ouvre une PR quand quelque chose dérive. Le tableau des modèles affiche une date de « dernière vérification ».
  • Balayage de péremption — signale les pages volatiles dont le lastVerified est plus ancien qu'un seuil.

Pourquoi l'humain dans la boucle​

:::tip Automatisé et honnête > automatisé et erroné Une IA qui auto-commit des « actualités » sur un site de référence risque de publier des hallucinations — l'inverse de la fiabilité. C'est pourquoi notre automatisation propose (issues/PR) ; les humains vérifient et fusionnent. Voir Vérification des faits. :::

Envie d'aider sur l'automatisation ?​

Améliorer ces workflows est une excellente contribution avancée — voir le dossier .github/workflows (sur la branche ci-workflows) et Contribuer.

Suite​