dkharlanau/agent-ready-web-profile

Evidencia y CI de ARWP

Utilice este skill después de que un sitio haya sido preparado o cuando un equipo desee que la calidad de ARWP se mantenga estable a lo largo del tiempo.

Flujo de trabajo

1. Establecer el contrato.

   • Identificar las interfaces públicas que el editor espera que permanezcan disponibles.
   • Usar arwp assert para intenciones requeridas/opcionales/prohibidas y expectativas de protocolo.
   • Evitar una puntuación de preparación universal.

2. Agregar controles de calidad recurrentes.

   • Ejecutar arwp audit para recomendaciones respaldadas por fuentes de búsqueda/IA/agentes.
   • Ejecutar arwp-growth para crear un backlog de mejora priorizado.
   • Ejecutar la compilación/lint/pruebas del sitio primero cuando la generación de metadatos locales sea parte del despliegue.
   • Usar una cadencia semanal a menos que el sitio cambie tan rápidamente que otra cadencia esté justificada.

3. Capturar evidencia durable para estados importantes.

   • Usar arwp-receipt capture <url> para observaciones explícitas de alta evidencia.
   • Conservar los IDs de los recibos y los registros históricos inmutables.
   • Separar project-reference, independent-benchmark y otras clases de evidencia.
   • Nunca tratar la observación de un sitio público como prueba de que el editor adoptó ARWP.

4. Rastrear desviaciones.

   • Usar instantáneas del resolvedor y arwp drift cuando la selección de interfaz/identidad canónica sea importante.
   • Fallar CI por ruptura explícita del contrato, no por oportunidades opcionales.
   • Conservar los resultados negativos y las regresiones en lugar de eliminarlos silenciosamente.

5. Adjuntar procedencia con cuidado.

   • Registrar IDs de commit/workflow/release solo cuando estén realmente disponibles.
   • Vincular la evidencia de SBOM/atestación solo al artefacto exacto coincidente.
   • Un recibo SHA-256 válido prueba la integridad del recibo, no la verdad, la autorización, el respaldo del editor o la seguridad.

6. Mantener las métricas de plataforma externas.

   • Las métricas de IA generativa de Google Search Console, el rendimiento de Bing AI, los datos de referencia de ChatGPT y análisis similares solo del propietario son entradas de evidencia.
   • Almacenar observaciones antes/después con fechas y alcance.
   • No afirmar que ARWP causó cambios en el ranking/citas sin evidencia controlada.

7. Verificar la calidad de CI.

   • Fijar/aprobar versiones de acciones según la política del repositorio.
   • Mantener los permisos de solo lectura a menos que se requiera una escritura específica.
   • Nunca colocar secretos en artefactos, fixtures, recibos o registros.
   • Asegurarse de que los artefactos públicos generados se reproduzcan con diff cero cuando sea práctico.

Salidas recomendadas de GitHub Actions

Publicar artefactos como:

• arwp-audit.json
• arwp-growth.json
• arwp-receipt.json
• instantáneas/informes de desviaciones del resolvedor

Usar el resumen del trabajo para hallazgos P0/P1 concisos. No fallar la compilación porque una característica puramente opcional como Preferred Sources o un protocolo experimental esté ausente.