/cc-e2e:kick-off — 기능과 함께 5종 검증 작성

기능 구현 직후나 테스트 번들을 작성할 때 사용합니다. unit, widget, golden, Widgetbook, BDD 5종 파일·등록·실행 증거를 만들고 co_bdd와 수기 Patrol legacy를 구분해 기능 소유 카탈로그·골든 갤러리를 연결합니다.

항목	내용
실행 명령	`/cc-e2e:kick-off`
분류	E2E 작성
난이도	●●● 높음
MCP 서버	`flutter-skill`, `patrol`

새 기능이나 변경 기능의 unit, widget, golden, Widgetbook, BDD를 한 흐름에서 준비·작성·등록·검증한다. 파일 생성이나 TODO만으로 완료하지 않는다. 실행 본체는 feature-test-bundle, 정본은 feature-verification이다.

/cc-e2e:kick-off sign_in
/cc-e2e:kick-off sign_in --dry-run
/cc-e2e:kick-off sign_in --with-exploration
/cc-e2e:kick-off sign_in --layers=golden,widgetbook
/cc-e2e:kick-off sign_in --skeleton-only

옵션	의미	기본
feature	실제 feature 식별자	필수
--layers	unit,widget,golden,widgetbook,bdd 선택; e2e는 실제 앱 실행을 추가	unit,widget,golden,widgetbook,bdd
--dry-run	소유 경로·기존 파일·명령·누락 계획만 출력	false
--with-exploration	실제 앱 탐색을 통해 AC/시나리오·Key를 확인	false
--skeleton-only	미완 스캐폴드 작성까지만; 완료/PASS 아님	false
--device	실제 Patrol 실행 대상	저장소 규칙으로 선택

부분 --layers는 다른 필수 항목의 면제가 아니다. headless feature는 UI 3종 N/A의 소스 근거를 기록하고 unit·실제 API 시나리오를 검증한다.

실행#

.cob/feature-layout.json, 기존 marker·pubspec/build.yaml·CI·lock 기록을 읽고 배치 계약을 적용한다.
AC·Page/Widget·도메인/데이터/상태 계약을 기존 5종 검증 파일에 매핑한다.
기능 역할의 test/src에 unit/widget/golden을 작성하고 test/fixtures·support를 정리한다.
기능의 별도 widgetbook/ 패키지에 use-case/demo/fixture를 두고 workspace·조립 registry를 갱신한다. 모든 공개 Page와 주요 Widget의 등록·실제 상태 Knob을 검증한다.
골든 기준·report는 기능 소유로 두고 중앙 gallery의 수집·표시·배포를 연결한다.
BDD 모드를 확인한다. co_bdd는 기능 test/src/bdd의 widget-only와 실행 앱의 both/patrol-only를 구분한다. 수기 Patrol을 명시한 저장소만 legacy app integration_test/scenarios·step·배치/리셋 절차를 따른다. 파일을 강제 이관하지 않는다.
실제 생성·분석·관련 테스트·렌더·compare를 실행하고 PR preflight에 증거를 전달한다. 순수 서버 unit은 기능, Session/DB/SDK 통합은 실행 호스트에 배치한다.
작성/생성/실행/비교/배포를 분리해 PASS/FAIL/BLOCKED/DEFERRED/N/A로 보고한다. 디바이스 부재는 BDD 작성 누락을 허용하지 않으며 위젯 PASS는 Patrol PASS가 아니다.

출력#

기능별 5종 파일·등재 목록·실제 실행 명령/결과
Page↔Widgetbook, feature↔golden 이미지/gallery, AC↔BDD scenario 매핑
TODO·미실행 환경·승인된 후속 작업과 전체 기능 완료 여부