/bdd:generate — 화면 시나리오 자동 작성기#

한마디로#

새 화면을 만들 때 "이 화면이 이렇게 동작해야 한다"는 테스트 시나리오를 자동으로 써주는 도우미입니다. 신입 직원에게 "이 버튼 누르면 이렇게 되고, 빈칸이면 이런 경고가 떠야 한다"는 업무 매뉴얼을 대신 정리해주는 것과 같아요.

누가·언제 쓰나요#

• 목록·상세·입력 폼 같은 새 화면을 개발하기 직전, 어떻게 동작해야 하는지 합의된 시나리오가 필요할 때
• /bdd:generate 명령을 직접 실행했을 때
• 피그마 분석(/figma:analyze) 흐름에서 자동으로 호출될 때

무엇을 해주나요#

화면 종류(목록 / 상세 / 입력 폼)에 맞는 시나리오 문서와 그 시나리오를 실제로 검증하는 코드 묶음을 만들어 줍니다. 실제로 생기는 파일은 다음과 같습니다.

• {feature}_list.feature, {feature}_detail.feature, {feature}_form.feature — 사람이 읽을 수 있는 "동작 시나리오" 문서 (Gherkin 형식)
• step/ 폴더의 *_steps.dart 파일들 — 각 시나리오 문장을 실제로 검증하는 코드
• hooks/hooks.dart — 테스트에 필요한 가짜 데이터(Mock) 준비 코드

각 시나리오 문장은 영어 원문 + # 한글 번역 주석을 나란히 적어, 개발자와 비개발자가 함께 읽을 수 있게 작성됩니다.

어떻게 쓰나요#

# 기본: 기능 이름과 엔티티 이름을 넘깁니다
/bdd:generate

# 다른 이름으로도 호출할 수 있어요 (별칭)
/bdd:scenario
/test:bdd

넘기는 정보:

• feature_name (필수) — 기능 모듈 이름 (예: community_post)
• entity_name (필수) — 데이터 이름 (예: CommunityPost)
• screen_type (선택) — list(목록) / detail(상세) / form(입력 폼)

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

화면 종류를 판단한 뒤, 종류별로 흔히 필요한 동작들을 시나리오로 풀어냅니다.

1. 목록 화면 — 목록 불러오기, 당겨서 새로고침, 무한 스크롤, 카드 탭 시 상세 이동, 카테고리 필터, 비어 있음·오류 상태
2. 상세 화면 — 상세 정보 표시, 좋아요 토글, (작성자만) 수정·삭제, 공유
3. 입력 폼 화면 — 정상 제출, 필수 항목 누락 경고, 글자 수 제한, 이미지 첨부·삭제, 작성 취소, 네트워크 오류
4. 품질 점검 — 모든 문장에 한글 번역 주석이 붙었는지, 공용 스텝을 재사용했는지, @smoke·@validation 같은 분류 태그를 달았는지 체크리스트로 확인합니다.

feature/{location}/{feature_name}/test/src/bdd/
├── {feature}_list.feature
├── {feature}_detail.feature
├── {feature}_form.feature
├── step/
│   ├── common_steps.dart          # package/core에서 import
│   ├── {feature}_list_steps.dart
│   ├── {feature}_detail_steps.dart
│   └── {feature}_form_steps.dart
└── hooks/
    └── hooks.dart