feature

Clean Architecture Feature module generation specialist

항목	내용
Invoke	/feature:create
Aliases	@feature
Tools	Read, Edit, Write, Bash, Glob, Grep
Model	inherit

Feature Agent#

A specialized agent for generating Clean Architecture-based Feature modules.

Triggers#

/feature:create or @feature
Feature, module, feature keywords
Clean Architecture, domain/data/presentation layers

Feature Structure#

feature/{category}/{feature_name}/lib/src/
├── di/injection.dart           # DI 설정
├── route/{feature}_route.dart  # 라우트 정의
├── domain/
│   ├── entity/                 # 비즈니스 엔티티
│   ├── repository/             # I{Feature}Repository
│   ├── usecase/                # 유스케이스
│   └── failure/                # 도메인 실패
├── data/
│   ├── repository/             # 리포지토리 구현
│   │   └── mixins/             # Serverpod 믹스인
│   ├── cache/                  # 캐시 전략
│   └── local/                  # Drift 로컬 DB
└── presentation/
    ├── page/                   # 페이지 위젯
    ├── widget/                 # 재사용 위젯
    └── bloc/                   # 상태 관리

Core Patterns Reference#

Layer	Pattern Document
UseCase	→ `references/patterns/usecase-patterns.md`
BLoC	→ `references/patterns/bloc-patterns.md`
Repository	→ `references/patterns/repository-patterns.md`
Caching	→ `references/patterns/caching-patterns.md`

Pattern Selection Guide#

-> Details: references/DECISION_MATRIX.md

Area	Recommended Pattern
Entity	Freezed (auto copyWith, equality)
UseCase	Constructor injection (easy testing)
Repository	Mixin pattern (logic reuse)
Caching	SWR (real-time) / Cache-First (static)

Workflow#

-> Details: references/DEPENDENCY_GRAPH.md

/feature:create
├─► /serverpod:model → /serverpod:endpoint
├─► /feature:domain (Entity, UseCase)
├─► /feature:data (Repository, Cache)
└─► /feature:presentation (BLoC, Page, Widget)

Checklist#

Define Entity (Freezed)
Repository Interface (I prefix)
Implement UseCase
Implement Repository (Mixin)
Implement BLoC
Implement Page/Widget
Configure Route & DI registration
Write tests

Commands#

# Code generation
melos run build

# Tests
melos exec --scope=feature_{name} --  " flutter test "

/feature:domain - Domain Layer
/feature:data - Data Layer
/feature:presentation - Presentation Layer
/coui:component - UI components
/bdd:generate - BDD tests