dkharlanau/agent-ready-web-profile

Preuves ARWP et CI

Utilisez ce skill après qu'un site a été préparé ou lorsqu'une équipe souhaite que la qualité ARWP reste stable dans le temps.

Flux de travail

1. Établir le contrat.

   • Identifiez les interfaces publiques que l'éditeur prévoit de maintenir disponibles.
   • Utilisez arwp assert pour les intentions obligatoires, facultatives et interdites ainsi que les attentes de protocole.
   • Évitez un score de préparation universel.

2. Ajouter des contrôles de qualité récurrents.

   • Exécutez arwp audit pour les recommandations Search/AI/agent basées sur des sources.
   • Exécutez arwp-growth pour créer un backlog d'améliorations priorisées.
   • Exécutez d'abord la construction/lint/tests du site lorsque la génération locale de métadonnées fait partie du déploiement.
   • Utilisez une cadence hebdomadaire à moins que le site ne change si rapidement qu'une autre cadence soit justifiée.

3. Capturer des preuves durables pour les états importants.

   • Utilisez arwp-receipt capture <url> pour des observations explicites à preuve élevée.
   • Conservez les identifiants de reçu et les enregistrements historiques immuables.
   • Séparez project-reference, independent-benchmark et autres classes de preuve.
   • Ne traitez jamais l'observation d'un site public comme une preuve que l'éditeur a adopté ARWP.

4. Suivre la dérive.

   • Utilisez les instantanés de résolveur et arwp drift lorsque la sélection d'interface/l'identité canonique est importante.
   • Échouez la CI en cas de rupture explicite de contrat, pas pour des opportunités facultatives.
   • Conservez les résultats négatifs et les régressions au lieu de les supprimer silencieusement.

5. Attacher la provenance avec soin.

   • Enregistrez les identifiants de commit/workflow/release uniquement lorsqu'ils sont réellement disponibles.
   • Liez les preuves SBOM/attestation uniquement à l'artefact exact correspondant.
   • Un reçu SHA-256 valide prouve l'intégrité du reçu, pas la vérité, l'autorisation, l'approbation de l'éditeur ou la sécurité.

6. Garder les métriques de plateforme externes.

   • Les métriques IA génératives de Google Search Console, la performance IA Bing, les données de référence ChatGPT et autres analyses exclusives au propriétaire sont des entrées de preuve.
   • Stockez les observations avant/après avec des dates et un périmètre.
   • Ne prétendez pas que ARWP a provoqué des changements de classement/citation sans preuve contrôlée.

7. Vérifier la qualité CI.

   • Épinglez/approuvez les versions d'actions conformément à la politique du dépôt.
   • Gardez les permissions en lecture seule sauf si une écriture spécifique est requise.
   • Ne placez jamais de secrets dans les artefacts, fixtures, reçus ou journaux.
   • Assurez-vous que les artefacts publics générés se reproduisent avec un diff nul lorsque c'est pratique.

Sorties recommandées pour GitHub Actions

Publiez des artefacts tels que :

• arwp-audit.json
• arwp-growth.json
• arwp-receipt.json
• instantané/dérive du résolveur

Utilisez le résumé de tâche pour des conclusions P0/P1 concises. Ne faites pas échouer la construction parce qu'une fonctionnalité purement optionnelle comme les sources préférées ou un protocole expérimental est absente.