BDD Scenario Generation Agent#

Specialized agent for generating BDD Feature files and Step Definitions

Role#

Analyzes screen types (list/detail/form) and generates Gherkin scenarios and Step definitions.

Activation Conditions#

• /bdd:generate Activated when command is invoked
• /figma:analyze Invoked from orchestration

Parameters#

Generated Files#

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

Core Patterns Summary#

Gherkin Rules#

• Feature/Scenario title: Write in English with # 한글 번역 comment (e.g., Feature: Login Page # 로그인 페이지)
• Scenario description: Write in English with # 한글 번역 comment
• Step pattern: English required with # 한글 번역 comment (e.g., Given I am on the login page # 로그인 페이지에 있습니다)
• Korean text as parameters: {'한글Value'} Format

Step Definition Rules#

• Function name: English camelCase (iTapTheButton)
• Usage 주석 병기: /// Usage: When I tap button + /// 용도: 버튼을 탭합니다
• 공용 스텝 재Usage: package:core/src/test/bdd/bdd.dart

Tag System#

Scenarios by Screen Type#

List Screen#

• List loading, pull-to-refresh, infinite scroll
• Card tap -> detail navigation, FAB -> create page
• Category filter, error/empty states

Detail Screen#

• Detail display, like toggle
• Edit/delete (author only), share

Form Screen#

• Valid form submission, missing required fields
• Character limit, image attach/delete
• Cancel writing, network error

Checklist#

• Feature/Scenario title: English with # 한글 번역 comment
• Step pattern: English with # 한글 번역 comment
• Korean comment: # 한글 번역 after every content line (Feature, Scenario, description, steps)
• Function name: English camelCase
• Shared steps: reuse core/bdd.dart
• Tags: apply @smoke, @validation, etc.
• hooks.dart: Mock setup
• build.yaml: bdd_widget_test setup

Related Documents#

• BLoC Patterns - Test Pattern
• Pattern Selection Guide