dkharlanau/agent-ready-web-profile

ARWP 증거 및 CI

이 스킬은 사이트가 준비된 후 또는 팀이 ARWP 품질을 시간이 지나도 안정적으로 유지하려는 경우 사용합니다.

워크플로우

1. 계약을 설정합니다.

   • 게시자가 계속 사용 가능할 것으로 예상하는 공개 인터페이스를 식별합니다.
   • 필수/선택/금지 의도 및 프로토콜 기대치에 대해 arwp assert를 사용합니다.
   • 보편적인 준비 점수는 피합니다.

2. 정기적인 품질 점검을 추가합니다.

   • 소스 기반 검색/AI/에이전트 권장 사항에 대해 arwp audit를 실행합니다.
   • 우선순위가 지정된 개선 백로그를 생성하려면 arwp-growth를 실행합니다.
   • 로컬 메타데이터 생성이 배포의 일부인 경우 사이트 빌드/린트/테스트를 먼저 실행합니다.
   • 주간 주기를 사용하되, 사이트 변경이 너무 빨라 다른 주기가 정당화되는 경우는 예외입니다.

3. 중요한 상태에 대한 내구성 있는 증거를 캡처합니다.

   • 명시적인 높은 증거 관찰을 위해 arwp-receipt capture <url>을 사용합니다.
   • 영수증 ID와 불변 기록을 보존합니다.
   • project-reference, independent-benchmark 및 기타 증거 클래스를 분리합니다.
   • 공개 사이트 관찰을 게시자가 ARWP를 채택했다는 증거로 취급하지 마십시오.

4. 드리프트를 추적합니다.

   • 인터페이스 선택/정식 정체성이 중요한 경우 리졸버 스냅샷과 arwp drift를 사용합니다.
   • 명시적 계약 위반 시 CI를 실패시키고, 선택적 기회에는 실패시키지 않습니다.
   • 부정적 결과와 회귀를 조용히 제거하는 대신 보존합니다.

5. 출처를 신중하게 연결합니다.

   • 실제로 사용 가능한 경우에만 커밋/워크플로우/릴리스 ID를 기록합니다.
   • SBOM/증명 증거를 정확히 일치하는 아티팩트에만 연결합니다.
   • 유효한 SHA-256 영수증은 영수증 무결성을 증명할 뿐, 진실, 권한 부여, 게시자 승인 또는 보안을 증명하지 않습니다.

6. 플랫폼 메트릭을 외부에 유지합니다.

   • Google Search Console 생성형 AI 메트릭, Bing AI 성능, ChatGPT 레퍼럴 데이터 및 유사한 소유자 전용 분석은 증거 입력입니다.
   • 날짜와 범위를 포함한 전후 관찰을 저장합니다.
   • 통제된 증거 없이 ARWP가 순위/인용 변경을 일으켰다고 주장하지 마십시오.

7. CI 품질을 검증합니다.

   • 저장소 정책에 따라 작업 버전을 고정/승인합니다.
   • 특정 쓰기가 필요한 경우가 아니라면 권한을 읽기 전용으로 유지합니다.
   • 아티팩트, 픽스처, 영수증 또는 로그에 비밀을 절대 배치하지 않습니다.
   • 생성된 공개 아티팩트가 실용적인 경우 차이가 0으로 재현되도록 합니다.

권장 GitHub Actions 출력물

다음과 같은 아티팩트를 게시합니다.

• arwp-audit.json
• arwp-growth.json
• arwp-receipt.json
• 리졸버 스냅샷/드리프트 보고서

간결한 P0/P1 결과를 위해 작업 요약을 사용합니다. Preferred Sources 또는 실험적 프로토콜과 같은 순전히 선택적 기능이 없어도 빌드가 실패하지 않도록 합니다.