준비 상태 확인
$check-readiness diff, $check-readiness pr <URL>, $check-readiness release, $check-readiness full 명령으로 호출합니다.
기본적으로 읽기 전용입니다. 문제점과 구체적인 해결 방안을 보고합니다. 사용자가 명시적으로 수정 또는 결과 적용을 요청할 때만 편집하며, 그 후 영향을 받는 동작을 검증합니다.
1. 대상 선택
| 모드 | 대상 | 완료 기준 |
|---|---|---|
diff | 현재 저장소의 staged, unstaged 및 관련 untracked 변경 사항과 영향을 받는 호출자 및 테스트. 변경 사항이 대상일 때 기본값입니다. | 모든 변경된 동작과 영향을 받는 경계가 설명되었습니다. |
pr <URL> | 연결된 PR의 diff, base, 대화, 검사 및 영향을 받는 컨텍스트. | 모든 변경된 동작이 설명되었습니다. 누락된 로컬 또는 원격 증거가 명명되었습니다. |
release | 현재 저장소와 명명된 배포 대상, 또는 저장소 설정에서 찾은 대상. | 모든 중요 흐름과 릴리스 종속성에 상태가 있습니다. |
full | 적용 가능한 백엔드 및 프론트엔드 영역 전체의 현재 저장소. | 모든 주요 라우트, 작업, 신뢰 경계, 데이터 저장소 및 수명 주기 경로가 목록화되고 평가되었습니다. |
사용자가 명명한 모드를 사용하세요. 명명된 모드가 없으면 PR URL, 현재 변경 사항 또는 명시된 릴리스에서 유추하고, 그렇지 않으면 full을 사용하세요. 검사 전에 정확한 대상, 리비전 또는 diff, 환경 및 사용 가능한 검증 경로를 기록하세요. PR URL에 접근할 수 없으면 차단된 사항을 보고하고, 관련 없는 로컬 diff로 대체하지 마세요.
심각도
모든 FAIL은 차단(blocking) 또는 권고(advisory) 입니다. 차단: 보안, 인증/인가, 데이터 손실 또는 손상, 중요 흐름 중단, 확인되지 않은 결제 또는 웹훅 처리, 유출된 비밀, 빌드 또는 테스트 실패. 그 외 모든 것은 권고이며 그 자체로 READY를 방해하지 않습니다. 각 준비 상태 스킬은 자체적인 차단 영역을 명시합니다.
모드별 검증 깊이
diff 및 pr: 변경 사항이 영향을 주는 동작만 검사하고, 나머지는 한 줄로 N/A (영향 없음)으로 표시합니다(검사 항목별이 아님). 릴리스 게이트 검사(Lighthouse, 배포 환경 스모크 테스트, 공유 프리뷰)는 변경 사항이 이에 영향을 주지 않는 한 release와 full에만 적용됩니다.
2. 증거 수집
diff의 경우 git status --short --branch, staged 및 unstaged diff, 관련 untracked 파일을 검사합니다. pr의 경우 연결된 PR과 해당 diff, 검사 및 토론을 읽고, 리비전이 확인된 경우에만 일치하는 로컬 체크아웃을 테스트에 사용합니다. release 및 full의 경우 테스트 전에 범위 내 애플리케이션을 매핑합니다. 각 영향을 받는 영역에 대해 호출자, 데이터 영향, 설정, 테스트 및 배포 종속성을 추적합니다.
백엔드 코드나 동작이 범위 내에 있으면 backend-readiness를 실행합니다. 프론트엔드 코드나 동작이 범위 내에 있으면 frontend-readiness를 실행합니다. 선택한 모드와 대상을 각각에 전달합니다. 둘 다 적용되면 결과를 결합합니다. 변경 검토의 경우 영향을 받는 동작에 검사를 적용합니다. 릴리스의 경우 중요 흐름과 대상 환경에 검사를 적용합니다. full의 경우 저장소 전체에 걸쳐 적용 가능한 모든 검사를 평가합니다. 각 적용 가능한 검사에 PASS, FAIL, BLOCKED 또는 N/A를 표시하고, 모든 PASS에는 현재 증거를, 모든 N/A에는 이유를 첨부합니다.
소스, 자동화된 테스트, 로컬 런타임, 제공자 샌드박스 및 배포 환경을 별개의 증거 계층으로 사용합니다. 빌드는 빌드를 증명합니다. 사용할 수 없는 자격 증명, 인프라 또는 환경은 BLOCKED로 기록하고, 여전히 필요한 정확한 증거를 명시합니다. 대상을 검증할 수 있는 집중된 검사를 실행합니다. 소스만으로 런타임이나 릴리스 동작을 주장하지 마세요.
적용 가능한 검사에 상태가 있고, 실패에는 원인과 해결 방안이 있으며, 각 준비 상태 주장이 해당 증거 계층과 일치하면 완료됩니다.
3. 보고 및 조치
모드와 대상을 보고한 후 보안, 데이터 손실, 정확성 및 사용자 영향 순서로 결과를 정리합니다. 각 결과는 위치 또는 흐름, 증거, 결과 및 가장 작은 구체적인 해결 방안을 명시합니다. 정확한 결과와 함께 실행된 검사, 차단되거나 확인되지 않은 항목을 포함합니다. 선택한 대상에 대해 READY, NOT READY 또는 UNVERIFIED로 종료합니다: READY는 알려진 차단 실패가 없고 적용 가능한 게이트에 대한 증거가 필요합니다. UNVERIFIED는 누락된 증거로 인해 해당 주장을 할 수 없음을 의미합니다.
다음 템플릿을 사용하세요:
모드 / 대상: <모드, 리비전 또는 diff, 환경>
결과
| 심각도 | 위치 또는 흐름 | 증거 | 결과 | 해결 방안 |
실행된 검사
| 명령어 또는 테스트 | 결과 |
차단됨 / 확인되지 않음
- <항목>: <여전히 필요한 증거>
평결: READY | NOT READY | UNVERIFIED
검토 실행은 읽기 전용으로 유지하세요. 사용자가 결과를 수정하도록 요청하면 영향받는 코드에 요청된 수정 사항을 적용하고, 집중 검증을 실행한 후 남은 위험을 보고하세요. 준비 상태 확인 요청에서 편집 권한을 유추하지 마세요.
보고서가 검증된 동작과 차이점을 구분하거나, 요청된 수정 사항이 적용되고 검증되었을 때 완료됩니다.