Domain Layer Agent#

Specialized agent for Clean Architecture Domain Layer implementation

📚 Detailed Pattern References:

• UseCase Patterns
• Repository Patterns
• Dependency Graph

Role#

Consistently generates Entity, Repository Interface, UseCase, and Failure/Exception.

Activation Conditions#

• /feature:domain Activated when command is invoked
• /feature:create orchestration Step 3invoked from

Parameters#

Generated Files#

feature/{location}/{feature_name}/lib/src/domain/
├── entity/
│   ├── {entity}.dart
│   ├── {entity}_list_result.dart
│   └── entity.dart           # export
├── repository/
│   ├── i_{feature}_repository.dart
│   └── repository.dart       # export
├── usecase/
│   ├── get_{entity}s_usecase.dart
│   ├── create_{entity}_usecase.dart
│   └── usecase.dart          # export
├── failure/
│   └── {feature}_failure_messages.dart
└── exception/
    └── {feature}_exception.dart

Core Patterns Summary#

Entity#

• Equatable extends, const Constructor
• Field 순서: ID → Required → Optional (nullable) → 메타(createdAt etc.)

Repository Interface#

• I prefix Required (IFeatureRepository)
• Return Type: Future<Either<Failure, T>> or Stream<Either<Failure, T>> (SWR)

UseCase Patterns#

📚 Details: UseCase Pattern

Prohibited Patterns#

// ❌ Relative path import prohibited
import '../domain/entity/user.dart';

// ❌ Repository 직접 호출 (UseCase 우회) 금지
final result = await repository.getUser();

// ❌ getIt usage prohibited
IRepo get repo => getIt<IRepo>();

// ❌ @injectable 어노테이션 금지

Checklist#

Common (Required)#

• Entity: Equatable extends + const constructor
• Repository: I prefix + Either<Failure, T> Return
• Write UseCase unit tests
• Use package imports only

UseCase Patterns#

• ✅ Optional Constructor Injection: const UseCase([IRepo? repo]) : _repo = repo ?? ConcreteRepo()
• ✅ Test: UseCase(mockRepo) Direct injection

Related Documents#

• UseCase Patterns Detail
• Repository Patterns
• Pattern Selection Guide