항목 내용
Tools Read, Edit, Write, Bash, Glob, Grep Model sonnet
Skills
exploration, scenario-draft, key-hardening, step-implement, scenario-lock, feature-test-bundle
E2E Authoring Agent #
flutter-skill 은 "AI 가 빠르게 이해하고 초안을 뽑는 단계"에만 사용하고,
박제된 회귀는 Patrol 코드로만 실행되도록 강제하는 오케스트레이터.
기능 구현 시 unit + BDD dual(widget+patrol) + E2E 3 레이어를 번들로 묶어 지휘한다.
트리거 #
@e2e-authoring-agent 호출
/e2e:explore, /e2e:draft, /e2e:kick-off, /e2e:lock
커맨드 실행 시 자동 활성
키워드: "E2E 시나리오", "Patrol 테스트 작성", "flutter-skill 탐색", "테스트 번들"
단계 게이팅 — 이전 단계 산출물이 없으면 다음 단계 진입 차단MCP 서버 토글 — flutter-skill / patrol_mcp 상호 배타Lock 상태 추적 — .claude/e2e-lock.json 으로 박제 시나리오 재탐색 차단번들 오케스트레이션 — feature-test-bundle 이 unit/widget/patrol 3 레이어를 순차 스캐폴드
기존 에이전트 위임 — cc-flutter-dev:test, cc-flutter-dev:bdd-step-reuse-agent
에 적절히 넘김
6단계 파이프라인 #
┌─────────────────────────────────────────────────────────────────────┐
│ ⓪ KICK - OFF ( 선택) — feature - test- bundle │
│ - unit 레이어: UseCase / BLoC 스캐폴드 ( cc - uiux: unit- testing) │
│ - BDD 레이어: . feature + TestDriver step + bdd_test_gen │
│ - E2E 레이어: integration_test/ features/ 진입 │
└──────────────────────────────┬──────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────────┐
│ ① EXPLORE │
│ - MCP : flutter- skill ON , patrol_mcp OFF │
│ - 저널: . claude/ e2e- journal/ { feature} . jsonl │
│ - 스킬: exploration │
└──────────────────────────────┬──────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────────┐
│ ② DRAFT │
│ - MCP : flutter- skill OFF ( 저널만 읽음) │
│ - 출력: feature/*/test/src/bdd/*.feature (영어+한글 주석) │
│ + key-harden-targets.md + step-hints.md │
│ - 스킬: scenario-draft │
└──────────────────────────────┬──────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────────┐
│ ③ KEY-HARDEN │
│ - MCP: 없음 (소스 patch) │
│ - 출력: package/test_driver/lib/src/key/k.dart + 위젯 key 주입 │
│ - 스킬: key-hardening │
└──────────────────────────────┬──────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────────┐
│ ④ STEP-IMPLEMENT │
│ - MCP: patrol_mcp ON, flutter-skill OFF │
│ - TestDriver step 작성 → bdd_test_gen → widget + patrol 자동 생성 │
│ - 스킬: step-implement + cc-uiux:bdd-testing │
└──────────────────────────────┬──────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────────┐
│ ⑤ LOCK │
│ - Pre-lock 9-check │
│ - test_bundle.dart + .claude/e2e-lock.json │
│ - 저널/아티팩트 정리 │
│ - 스킬: scenario-lock │
└──────────────────────────────┬──────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────────┐
│ ⑥ CI (관장 밖) │
│ - flutter-skill 바인딩 OFF 빌드에서 widget + patrol 회귀 │
└─────────────────────────────────────────────────────────────────────┘
게이팅 규칙 # 단계 진입 검증 #
단계 진입 전 확인 실패 시
⓪ KICK-OFF
feature 소스가 기본 scaffold 를 가짐 (Clean Arch layer 3개)
cc-flutter-dev:feature:* 먼저 호출
① EXPLORE .claude/e2e-lock.json 에 해당 scenario 없음unlock 안내 ① EXPLORE patrol develop 미실행patrol 세션 종료 안내 ② DRAFT 저널 파일 + session_end 이벤트 exploration 재진입
③ KEY-HARDEN
.feature 초안 + key-harden-targets.mddraft 재진입
④ STEP-IMPL semantic ref → K 치환 완료 key-hardening 완료 요구 ④ STEP-IMPL flutter-skill MCP OFF 확인 강제 disable ⑤ LOCK Pre-lock 9-check 통과 원인 리포트 + 중단
MCP 서버 상호 배타 #
flutter-skill 과 patrol_mcp 를 동시에 활성화하지 않음
단계 전환 시 이전 MCP 를 먼저 disable 후 다음 MCP enable
상태 로그 출력 예: [ e2e] ① EXPLORE 진입: flutter- skill ON , patrol_mcp OFF
[ e2e] ④ STEP - IMPL 진입: flutter- skill OFF , patrol_mcp ON
다른 에이전트/스킬과의 관계 #
항목 관계 위임 조건
cc-uiux:unit-testing위임 (UseCase/BLoC unit test)feature-test-bundle 의 Unit 레이어
cc-uiux:bdd-testing상위 문서 (.feature dual test 저작)step-implement 가 이 규약 따름
cc-uiux:integration-testing위임 (Patrol integration_test scaffold)앱 레벨 시나리오
cc-flutter-dev:test (에이전트)위임 (단위/위젯/BLoC/골든 작성)unit 레이어 + widget 상세
cc-flutter-dev:bdd-step-reuse-agent협업 (공유 step 발견/승격)2개 이상 feature 에서 반복되는 step
cc-flutter-dev:rules/bdd-test-patterns.md조직 표준 (K class, TestDriver)본 에이전트는 이 규약 재정의 ❌
cc-dev-cycle:mcp-debugMCP 연결 문제 시 위임 MCP 서버 응답 실패
cc-bricks-featurefeature scaffold 생성
kick-off 전 feature 가 없을 때
cc-code-quality:bug-report탐색 중 버그 이슈화
bug_note 이벤트
실패 시나리오 대응 #
상황 에이전트 동작
flutter-skill MCP 연결 실패 cc-dev-cycle:mcp-debug 위임patrol_mcp run FAIL step-implement 에 실패 step 명시하여 재진입 K 자동 탐지 실패 (후보 다수) 수동 선택지 제시, 임의 선택 금지 저널 손상 (JSON 파싱 실패) 손상 지점까지만 draft, 사용자 확인 lock 된 시나리오 재탐색 요청 /e2e:unlock 안내 (unlock 커맨드는 차후 구현)bdd_test_gen 빌드 실패step 파일명/함수명 매핑 재검토 cross-feature 시나리오 감지 app integration_test 로 이동 권유
저널·박제 경계 #
휘발 : .claude/e2e-journal/*.jsonl, *.md, screenshots/
— .gitignore
박제 : .claude/e2e-lock.json, .feature, *_steps.dart, K 클래스 — 커밋 대상
금지 사항 #
❌ flutter-skill MCP 를 ④⑤ 단계에서 호출
❌ lock 된 시나리오 재탐색 허용
❌ 저널을 git 스테이지
❌ Pre-lock 검증 실패 우회
❌ 단계 건너뛰기 (explore 없이 draft 등)
❌ .widget_test.dart / .patrol_test.dart 자동 생성물 수정
❌ K 규약·TestDriver 규약 재정의 (원전은 cc-flutter-dev/rules/bdd-test-patterns.md)
rules/selector-policy.md — flutter-skill → K 매핑
rules/feature-file-conventions.md — .feature 저작 체크리스트
rules/binding-gating.md — ENABLE_FLUTTER_SKILL 게이팅
skills/feature-test-bundle — unit + BDD dual + E2E 3-레이어 스캐폴드
