/e2e:lock — 통과한 테스트를 "공식 시험지"로 박제#

한마디로#

검증을 통과한 자동화 테스트 시나리오를 회귀 시험지(CI 회귀 스위트)에 도장 찍어 등록하는 단계입니다. 한 번 합격한 모의고사 문제를 "이제부터 매번 푸는 정식 시험 문제"로 확정하는 것과 같아요. 등록 후에는 함부로 바꿀 수 없습니다(되돌리려면 명시적인 unlock이 필요).

누가·언제 쓰나요#

• 테스트 시나리오 작성(step-implement)을 끝내고, 자동 실행 결과가 PASS(합격) 로 나온 직후
• 그 시나리오를 CI 회귀 테스트(코드가 바뀔 때마다 자동으로 도는 검사)에 정식으로 포함시키고 싶을 때

무엇을 해주나요#

통과한 시나리오를 검증한 뒤, 정식 테스트 목록에 등록하고 임시 작업 기록을 정리해 줍니다. 끝나면 다음이 남습니다.

• test_bundle.dart 수정 — 전체 테스트 묶음에 시나리오 추가
• run_all_scenarios.sh 수정 — 한 번에 실행하는 스크립트 갱신
• .claude/e2e-lock.json 갱신 — "어떤 시나리오를 박제했는지" 기록 (커밋 대상)
• 임시 작업 기록(저널)을 삭제하거나 보관함(archive)으로 이동
• 추천 커밋 메시지 제안: test(e2e): lock {feature}/{scenario}

어떻게 쓰나요#

# 단일 시나리오 박제
/e2e:lock sign_in email_login_success

# feature 전체 박제 (해당 feature의 모든 시나리오)
/e2e:lock sign_in --all

# pre-lock 검증만 수행 (실제 lock 안함)
/e2e:lock sign_in email_login_success --dry-run

# 저널을 archive 로 보관하며 lock
/e2e:lock sign_in email_login_success --archive-journal

• feature(필수): 기능 이름 (예: sign_in)
• scenario(필수): 시나리오 이름. 단, --all을 쓰면 생략 가능
• --all: 해당 기능의 모든 시나리오를 한꺼번에 박제
• --dry-run: 실제로 등록하지 않고 "통과하는지 검증만" 미리 해보기
• --archive-journal: 작업 기록을 지우지 않고 보관함으로 옮기기 (기본은 삭제)

안에서 무슨 일이 벌어지나요#

크게 검증 → 등록 → 정리 → 기록 → 보고 순서로 진행됩니다.

1. 사전 점검 — 시나리오 파일이 제자리에 있는지, 빠진 부분은 없는지, 마지막 자동 실행이 합격이었는지 등을 꼼꼼히 검사합니다. 하나라도 미달이면 등록하지 않고 멈춥니다(강제 등록 금지).
2. 정식 목록 등록 — 전체 테스트 묶음과 실행 스크립트에 이 시나리오를 추가합니다.
3. CI 연결 확인 — 자동 검사 설정(.github/workflows/e2e-patrol.yml)이 잘 연결돼 있는지 확인하고 필요한 보완을 제안합니다.
4. 임시 기록 정리 — 작업하면서 남긴 저널을 삭제하거나 보관함으로 옮깁니다.
5. 박제 기록 작성 — "무엇을 등록했는지"를 .claude/e2e-lock.json에 남깁니다.
6. 결과 보고 — 등록 경로, CI 실행 명령, 추천 커밋 메시지를 정리해 알려줍니다.

문제가 생기면(예: 사전 점검 실패, 마지막 실행이 불합격, 이름 중복) 그 원인을 알려주고 다음에 무엇을 해야 할지 안내합니다.

# 단일 시나리오 박제
/e2e:lock sign_in email_login_success

# feature 전체 박제 (해당 feature의 모든 시나리오)
/e2e:lock sign_in --all

# pre-lock 검증만 수행 (실제 lock 안함)
/e2e:lock sign_in email_login_success --dry-run

# 저널을 archive 로 보관하며 lock
/e2e:lock sign_in email_login_success --archive-journal