data-layer-agent

Clean Architecture Data Layer specialist. Used for Repository implementation, caching, and Drift DAO work

항목	내용
Invoke	/feature:data
Aliases	/data:create, /layer:data
Tools	Read, Edit, Write, Glob, Grep
Model	sonnet
Skills	feature

Data Layer Agent#

Specialized agent for Clean Architecture Data Layer implementation

📚 Detailed Pattern References:

Role#

Consistently generates Repository implementation, API Mixin (namespace import), Cache strategy, and Local DB.

Activation Conditions#

/feature:data Activated when command is invoked
Invoked from /feature:create orchestration Step 4

Parameters#

Parameter	Required	Description
`feature_name`	✅	Feature module name (snake_case)
`entity_name`	✅	Entity name (PascalCase)
`location`	❌	`application` , `common` , `console` (default: `application` )
`caching`	❌	`swr`, `cache-first`, `none` (default: `swr`)

Generated Files#

feature/{location}/{feature_name}/lib/src/data/
├── repository/
│   ├── {feature}_repository.dart
│   ├── mixins/
│   │   └── {feature}_api_mixin.dart
│   └── repository.dart
├── cache/
│   └── {entity}_cache_repository.dart
└── local/
    ├── tables/
    │   └── {entity}_table.dart
    ├── dao/
    │   └── {entity}_dao.dart
    └── {feature}_database.dart

Core Patterns Summary#

Repository Implementation#

📚 Details: Repository Pattern

@LazySingleton(as: IFeatureRepository) Annotation
Mixin separation pattern recommended (network logic reuse)

API Mixin (Namespace required!)#

import 'package:serverpod_service/serverpod_service.dart' as serverpod;

mixin FeatureApiMixin implements IFeatureRepository {
  serverpod.ServerpodClient get client;  // ✅ 네임스페이스로 충돌 방지
}

Caching Strategy Selection#

📚 Details: Caching Pattern

Pattern	Selection Criteria
SWR	Frequent updates, Real-time
Cache-First	Minimize network, Static data

Critical Import Pattern#

// Repository: dependencies만 사용
import 'package:dependencies/dependencies.dart';

// Mixin: 네임스페이스 필수!
import 'package:serverpod_service/serverpod_service.dart' as serverpod;

// Domain Entity (네임스페이스 없음)
PostCategory category = PostCategory.qna;

// API DTO (네임스페이스로 충돌 방지)
serverpod.PostCategory apiCategory = serverpod.PostCategory.qna;

Checklist#

Repository: @LazySingleton(as: Interface) Annotation
API Mixin: as serverpod Namespace import
양방향 DTO 변환: _mapFromDto, _categoryToDto
Caching strategy: SWR or Cache-First
Drift: Table + DAO Generation
Return Type: Either<Failure, T> consistency