수락 조정자 (Acceptance Orchestrator)

수락 조정자 (Acceptance Orchestrator)은(는) 무엇을 하나요?

개요

코딩 작업을 상태 머신으로 orchestration하여 수락 기준이 증거와 함께 검증되거나 작업이 명시적으로 에스컬레이션될 때만 종료됩니다.

핵심 규칙: "코드 변경"에 최적화하지 말고 "완료 정의(DoD) 입증"에 최적화하십시오.

사용 시기

• 작업에 이미 이슈 또는 명확한 수락 기준이 있으며 최소한의 인간 재개입으로 종단간 실행되어야 할 때
• 구현, 리뷰, 배포, 최종 검증 단계 간 구조화된 핸드오프가 필요할 때
• 명시적인 중단 조건과 에스컬레이션을 원하고, 묵시적인 부분 완료를 원하지 않을 때

필수 하위 스킬

• create-issue-gate
• closed-loop-delivery
• verification-before-completion

선택적 지원 스킬:

• deploy-dev
• pr-watch
• pr-review-autopilot
• git-ship

입력값

다음 입력값이 필요합니다:

• 이슈 ID 또는 이슈 본문
• 이슈 상태
• 수락 기준 (DoD)
• 대상 환경 (dev 기본값)

고정 기본값:

• 최대 반복 라운드 = 2
• PR 리뷰 폴링 = 3m -> 6m -> 10m

상태 머신

• intake
• issue-gated
• executing
• review-loop
• deploy-verify
• accepted
• escalated

워크플로우

1. 수락 (Intake)

   • 이슈를 읽고 작업 목표와 DoD를 추출합니다.

2. 이슈 게이트 (Issue gate)

   • create-issue-gate 로직을 사용합니다.
   • 이슈가 ready 상태가 아니거나 실행 게이트가 allowed가 아니면 즉시 중단합니다.
   • 이슈가 draft 상태인 동안에는 아무것도 구현하지 마십시오.

3. 실행 (Execute)

   • 구현 및 로컬 검증을 위해 closed-loop-delivery에 핸드오프합니다.

4. 리뷰 루프 (Review loop)

   • PR 피드백이 관련된 경우, 배치 폴링 윈도우를 다음과 같이 설정합니다:
     • 3m 대기
     • 그 다음 6m
     • 그 다음 10m
   • 10m 라운드 후에는 대기를 중단하고 보이는 모든 댓글을 함께 처리합니다.

5. 배포 및 런타임 검증 (Deploy and runtime verification)

   • DoD가 런타임 동작에 의존하는 경우, 기본적으로 dev에만 배포합니다.
   • 가정이 아닌 실제 로그/API/Lambda 동작으로 검증합니다.

6. 완료 게이트 (Completion gate)

   • 완료를 주장하기 전에 verification-before-completion을 요구합니다.
   • 새로운 증거 없이 성공을 주장하지 마십시오.

중단 조건

모든 수락 기준에 일치하는 증거가 있을 때만 accepted 상태로 전환합니다.

다음 중 하나라도 발생하면 escalated 상태로 전환합니다:

• DoD가 2회 전체 라운드 후에도 여전히 실패하는 경우
• 누락된 비밀/권한/외부 종속성이 진행을 차단하는 경우
• 작업에 프로덕션 조치나 파괴적 작업 승인이 필요한 경우
• 리뷰 지침이 충돌하여 둘 다 충족할 수 없는 경우

인간 게이트

다음 상황에서는 항상 인간 확인을 위해 중단합니다:

• 합의된 범위를 벗어난 프로덕션/스테이징 배포
• 파괴적인 git/데이터 작업
• 청구 또는 보안 상태 변경
• 사용자가 제공한 수락 기준 누락

출력 계약

상태를 보고할 때 항상 다음을 포함하십시오:

• Status: intake / executing / accepted / escalated
• Acceptance Criteria: pass/fail 체크리스트
• Evidence: 명령어, 로그, API 결과 또는 런타임 증거
• Open Risks: 여전히 불확실한 사항
• Need Human Input: 차단된 경우 필요한 가장 작은 다음 결정

상태가 accepted가 아니면 "완료"로 보고하지 마십시오.

제한 사항

• 이 스킬은 작업이 위에서 설명한 범위와 명확히 일치할 때만 사용하십시오.
• 출력을 환경별 검증, 테스트 또는 전문가 리뷰를 대체하는 것으로 취급하지 마십시오.
• 필요한 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 중단하고 명확히 요청하십시오.