요구사항에서 승인까지
1. 복잡 및 확인
사용자 목표, 비목표, 관찰 가능한 승인 조건, 위험 및 예산 제약을 복잡합니다. 확인 후 구현에 들어갑니다. 이미 명확한 확인이 있으면 이를 그대로 사용하고 승인을 반복해서 요청하지 않습니다. 실제 구현에 영향을 미치는 격차만 보충 질문합니다. 이 프로세스는 도구, 비용, 푸시, 병합 또는 배포 권한을 확장하지 않습니다.
2. 조정자가 직접 분할
- 조정자가 기능 경계, 종속성, 인터페이스, 담당자 및 승인 항목을 직접 제공하며, 분할 에이전트 계층을 더 이상 추가하지 않습니다. 독립적인 작업은 병렬로 진행되고, 종속 작업은 인터페이스와 순서에 따라 진행됩니다.
- 독립적으로 테스트 및 롤백 가능한 각 기능에 대해 독립적인 worktree, 브랜치 및 실제 PR이 생성됩니다. 고정 대상 브랜치 및 base/head SHA가 사용됩니다. 다른 구현자는 작업 디렉토리를 공유하지 않으며, 다른 작업의 브랜치를 빌려 사용하지 않습니다.
- 단일 기능 PR의 최종 additions + deletions은 테스트, 문서 및 생성된 파일을 포함하여 1000줄을 초과하지 않도록 합니다. 초과하는 경우 합리적으로 분할합니다. 분할할 수 없는 경우 이유와 규모를 설명하고, 생성된 파일을 숨기거나 기능의 절반을 강제로 분할하지 않습니다.
- 다기능 배치에서는 하위 PR URL, 종속성 및 독립 승인 항목을 기록합니다. 프로젝트에서 지원하는 스택 PR 또는 통합 브랜치에 따라 구성하고 실제 기능을 확인합니다. 문서의 작업 번호는 실제 PR을 가장할 수 없습니다.
3. 구현자가 실제로 실행하고 스스로 증명
- 구현자는 구현, 자체 점검 및 주요 사용자 경로 실행을 완료한 후에 독립적인 검토를 제출합니다. 주요 실행 검증 및 스크린샷 작업을 검토자에게 전가하지 않습니다.
- 정확한 SHA, 명령어, 환경, 실제 결과, 테스트되지 않은 항목 및 위험을 기록합니다. 버그의 경우 수정 전 재현 단계와 동일 경로의 수정 후 결과를 제공합니다. 빌드, mock, 실제 서비스 승인은 별도로 보고합니다.
- UI 변경의 경우 주요 단계 및 결과의 실제 실행 스크린샷을 제공합니다. 스크린샷은 PR 댓글이나 첨부 파일에 배치하며, 코드 브랜치에 제출하지 않습니다. 먼저 업로드 도구가 지원하는 매개변수를 확인합니다. 업로드가 차단되면 차단을 보고하고 첨부 파일 URL을 임의로 생성하지 않습니다.
- 백엔드 권한, 데이터 또는 자금 관련 동작에 대해 해당 API/데이터 증거를 제공합니다. 테스트는 격리된 환경과 합성 데이터를 사용하며, 자격 증명 및 개인 데이터를 유출하지 않습니다.
- UI가 없는 규칙 또는 문서 변경의 경우 스크린샷을 위조하지 않습니다. 범위, 링크, 규칙 일관성 및 diff를 확인하면 됩니다. 컨테이너 검증은 승인된 격리된 환경을 사용하며, 사용자의 개인 시스템을 무단으로 롤백하지 않습니다.
- PR은 4섹션 템플릿을 사용하며, 각 증거는 실제 커밋과 연결됩니다.
4. 코드와 보안 각각 검토
- 저장소에 이미 구성된 자동 코드 및 보안 검토를 우선 재사용하고, 완료 상태, 포함된 SHA 및 미해결 발견 사항을 각각 확인합니다. 중복 검토를 추가로 파견하거나 수동 트리거를 반복하지 않습니다.
- 구성되지 않았거나, 트리거되지 않았거나, 대상 SHA를 포함하지 않은 경우 격차를 보고합니다. 승인된 대체 방안에 따라 처리하며, 대체 방안에 대한 승인이 없는 경우 결정을 구합니다. 댓글이 없다고 해서 검토가 완료된 것은 아닙니다.
- 코드 품질은 필요에 따라 설치된
yushen-code-quality-review를 읽습니다. 보안은 필요에 따라yushen-security-review를 읽습니다. 경로는 실제 설치 위치를 기준으로 하며, 누락되었거나 읽지 않은 경우 이를 설명합니다. - 검토는 증거가 있는 문제만 제기합니다. 외부 구현은 비교 및 제안할 수 있지만, 사용자가 채택하지 않는 한 솔루션을 변경하거나, 마이그레이션하거나, 종속성을 추가하지 않습니다.
5. 최대 3라운드 수렴
한 라운드는 검토 피드백 → 수정 또는 증거가 있는 처리 → 검증으로 구성됩니다. 코드와 보안을 합산하여 라운드를 계산하며, 총 최대 3라운드입니다. 에이전트, 모델, 재시도, rebase 또는 동일한 작업 PR 재오픈은 라운드를 초기화하지 않습니다.
첫 번째 라운드는 요구사항과 결합하여 전체 diff를 검토합니다. 두 번째 및 세 번째 라운드는 새로운 diff, 기존 문제의 종결 및 영향을 받는 회귀를 확인합니다. 안정적인 문제 ID를 사용하여 동일한 근본 원인의 발견을 통합하고, 위치, 증거, 최초 라운드, 상태, 수정 SHA 및 검증을 기록합니다. 오탐은 증거로 설명하고, 댓글을 제거하기 위해 의미 없는 수정을 해서는 안 됩니다. 재확인 없이 '해결됨'으로 표시하지 않습니다.
동일한 문제에 대해 2라운드의 유효한 수정에도 진전이 없으면 조기 에스컬레이션할 수 있습니다. 세 번째 라운드에도 해결되지 않은 문제가 남아 있으면 자동 수렴을 중단하고, 조정자에게 증거를 종합하고, 접근 방식을 재고하고, 결정을 요청합니다. 기준을 낮추거나, 자동으로 통과시키거나, 병합해서는 안 됩니다.
6. 통합 버전 확인
조정자는 최종 필수 CI, 충돌 해결, 공유 상태 및 통합 사용자 경로를 확인하고, 각 하위 PR SHA와 통합 후보 SHA를 기록합니다. 각 계층이 통과했다고 해서 통합이 통과된 것은 아닙니다. rebase, 충돌 처리 또는 구현 변경 후에는 SHA 매핑을 업데이트하고 영향받는 회귀를 보충합니다. 오래된 증거는 현재 버전의 결과를 가장할 수 없습니다.
7. 인간 승인
후보 SHA, 실행 가능한 산출물, 최단 테스트 단계, 예상 결과 및 잔여 위험을 제공합니다. 사용자가 직접 테스트하고 해당 버전을 명시적으로 확인한 후에만 실제 권한에 따라 병합합니다. 코드가 변경된 후에는 영향받는 부분을 재확인합니다. 자동 테스트 및 봇 승인은 사용자本人的 승인을 대체하지 않습니다. 릴리스 및 배포는 각각의 권한에 따라 처리됩니다.
설치 프로그램, 데스크톱 애플리케이션 또는 기타 실제 릴리스 산출물을 제공할 때는 필요에 따라 설치된 yushen-release-acceptance를 읽고, 최종 다운로드 파일부터 사용 가능까지의 전체 경로를 검증하며, 플랫폼별 결론과 미리보기 제한을 구분합니다. 순수 텍스트 또는 사소한 내부 변경의 경우 전체 릴리스 승인 프로세스를 강제로 수행하지 않습니다.
모델 및 비용 전략
구성 가능한 작업 난이도, 위험, 예산 및 사용 가능한 역량에 따라 모델을 선택합니다. 결정적 검사는 스크립트를 우선 선택합니다. 명확한 부분 구현은 저비용 옵션을 우선 선택합니다. 복잡한 진단, 설계 및 고위험 판단은 역량에 적합한 옵션을 선택합니다. 증거 정리는 저비용 옵션을 사용합니다. 시작 시 선택된 역할, 비용 한도 및 업그레이드 조건을 설명하며, 특정 모델이 공개 환경에서 기본적으로 사용 가능하다고 간주하지 않습니다.
환경 오류 및 컨텍스트 부족을 먼저 배제한 후 업그레이드 여부를 결정합니다. 예산을 초과하거나, 유료 호출을 추가하거나, 승인된 역량을 벗어나는 경우 먼저 해당 결정을 받습니다. 무제한 재시도하지 않습니다. 배치 종료 시 필요에 따라 재작업 요약을 사용하며, 규칙 업데이트는 정상 승인 프로세스를 따릅니다.
프로젝트 규칙 연동
프로젝트 AGENTS.md에서 작업 시 관련 스킬과 REVIEW.md를 읽도록 명시적으로 요구합니다. 링크가 자동으로 확장된다고 가정하지 않습니다. REVIEW.md에는 판단 가능한 장기 프로젝트 규칙만 넣고, 각 라운드의 발견 및 증거는 PR에 남깁니다. 파일이 없거나 제약 조건이 충돌하는 경우 보고해야 하며, 메커니즘을 임의로 추측하지 않습니다.
프로젝트 규칙 생성 시 필요에 따라 일반 REVIEW 예시를 참조할 수 있으며, 실제로 적용 가능하고 검증 가능한 조항만 유지합니다.