dkharlanau/agent-ready-web-profile

Evidências e CI do ARWP

Use este skill após um site ter sido preparado ou quando uma equipe deseja que a qualidade do ARWP permaneça estável ao longo do tempo.

Fluxo de Trabalho

1. Estabeleça o contrato.

   • Identifique as interfaces públicas que o publicador espera que permaneçam disponíveis.
   • Use arwp assert para intenções obrigatórias/opcionais/proibidas e expectativas de protocolo.
   • Evite uma pontuação universal de prontidão.

2. Adicione verificações de qualidade recorrentes.

   • Execute arwp audit para recomendações de Search/AI/agentes baseadas em fontes.
   • Execute arwp-growth para criar um backlog de melhorias priorizado.
   • Execute build/lint/testes do site primeiro quando a geração de metadados local fizer parte da implantação.
   • Use uma cadência semanal, a menos que o site mude tão rapidamente que outra cadência seja justificada.

3. Capture evidências duráveis para estados importantes.

   • Use arwp-receipt capture <url> para observações explícitas de evidências mais altas.
   • Preserve IDs de recibos e registros históricos imutáveis.
   • Separe project-reference, independent-benchmark e outras classes de evidência.
   • Nunca trate a observação de um site público como prova de que o publicador adotou o ARWP.

4. Monitore desvios.

   • Use snapshots do resolvedor e arwp drift quando a seleção de interface/identidade canônica for importante.
   • Falhe na CI por quebra explícita de contrato, não por oportunidades opcionais.
   • Preserve resultados negativos e regressões em vez de removê-los silenciosamente.

5. Anexe proveniência com cuidado.

   • Registre IDs de commit/workflow/release apenas quando estiverem realmente disponíveis.
   • Vincule evidências de SBOM/atestação apenas ao artefato exato correspondente.
   • Um recibo SHA-256 válido prova a integridade do recibo, não a verdade, autorização, endosso do publicador ou segurança.

6. Mantenha métricas da plataforma externas.

   • Métricas de IA generativa do Google Search Console, AI Performance do Bing, dados de referência do ChatGPT e análises semelhantes de propriedade exclusiva do proprietário são entradas de evidência.
   • Armazene observações de antes/depois com datas e escopo.
   • Não afirme que o ARWP causou mudanças de classificação/citação sem evidências controladas.

7. Verifique a qualidade da CI.

   • Fixe/aprove versões de ação de acordo com a política do repositório.
   • Mantenha permissões somente leitura, a menos que uma gravação específica seja necessária.
   • Nunca coloque segredos em artefatos, fixtures, recibos ou logs.
   • Garanta que os artefatos públicos gerados se reproduzam com diferença zero quando prático.

Saídas recomendadas do GitHub Actions

Publique artefatos como:

• arwp-audit.json
• arwp-growth.json
• arwp-receipt.json
• snapshots do resolvedor/relatórios de desvio

Use o resumo do job para descobertas concisas de P0/P1. Não falhe o build porque um recurso puramente opcional, como Preferred Sources ou um protocolo experimental, está ausente.