실행 연결 계약

`run`은 단일 이슈, `batch`는 자식 작업을 가진 컨테이너의 실행 원본입니다.

run은 단일 이슈, batch는 자식 작업을 가진 컨테이너의 실행 원본입니다. 연결 명령은 입력 정규화 → 옵션 확인 → 한 번 위임 → 반환 기록만 수행합니다. 구현·브랜치·테스트·PR·머지 루프를 다시 만들지 않습니다.

공통 매핑#

입력/의도	처리
GitHub/ZenHub 이슈 번호	실제 이슈·자식을 조회. leaf → run, container → batch
STORY-ID/스토리 파일	문서/스프린트의 zh_issue_id 조회. 없으면 기존 이슈 검색 후 run의 이슈 생성 경로에 AC 전달
`--no-merge`	PR/CI/리뷰까지 수행하고 PR_READY 반환. 이슈 Close 금지. 다른 머지 옵션보다 우선
`--merge=pre-authorized`	run/batch에 그대로 전달. 품질/점유/열린 자식/스폰 승인 면제 아님
`--unattended`	그대로 전달. 승인 권한으로 해석하지 않음
`--base`, `--device`, `--skip-device`	지원 실행기에 원형 전달. 지정한 기기 미발견은 중단
`--skip-tests`, `--skip-review`	leaf run의 승인/기록 계약 적용. 해당 옵션을 지원하지 않는 batch에는 전달 전 명시적으로 거부
알 수 없거나 전달할 수 없는 옵션	`unsupported_option`과 지원 경로를 알리고 외부 변경 전에 중단

서로 충돌하는 이슈 번호/스토리 연결/부모 정보는 추측으로 합치지 않습니다. --issue 같은 연결 명령 옵션으로 실제 열린 자식을 숨기거나 leaf로 강제하지 않습니다. 추가 도구가 없으면 필요한 플러그인과 원본 문서 위치를 알리고 이전 규칙을 복사해 대체하지 않습니다.

반환#

결과	연결 명령의 행동
MERGED	PR/이슈 종료를 원격 확인한 결과만 완료로 집계
PR_READY	PR URL·검증·미머지 상태 기록. BMAD는 dev-complete/Review/QA이며 merged/closed 아님
INCOMPLETE / BLOCKED	원인·재개 명령·원본 게이트 판정을 그대로 반환
SKIPPED-OCCUPIED	남의 보드/대장에 쓰지 않고 점유자와 재개 안내 반환
조회 실패/미확정	unknown. 완료/실패 0건으로 해석하지 않음

파이프라인 상태는 실행 결과를 미러링할 뿐 원격 이슈·PR 판정을 뒤집지 않습니다. 재개도 로컬 완료 표시만 믿지 않고 공통 실행기의 원격 재조회 계약을 사용합니다.

전환 정책#

bugfix의 이전 독립 fast-path에 있던 암묵적 품질 게이트 면제는 사용하지 않습니다. 기본은 run의 표준 검증/머지 승인이고, 명시적 생략은 run의 승인·기록 계약을 적용합니다.
dev-story의 기본 PR-only 의미는 --no-merge로 표현합니다. 호출자의 머지 승인을 받아도 이 모드를 조용히 뒤집지 않습니다. 머지까지 필요하면 run/develop을 명시적으로 선택합니다.
각 명령이 지원한다고 문서화한 기존 입력은 매핑하고, 지원 불가능한 옵션을 무시하며 진행하지 않습니다.
단축 표기를 실행 가능한 별도 alias로 보장하지 않습니다. 실제 정식 명령/런타임 변환 이름을 사용합니다.