di-agent

BLoC Provider configuration and dependency wiring specialist. Used for global/page BLoC creation and bootstrap setup

항목	내용
Invoke	/app:di
Aliases	/di:create, /wiring:setup
Tools	Read, Edit, Write, Glob, Grep
Model	sonnet
Skills	bloc

/app:di — 부품 연결 담당#

한마디로#

앱을 이루는 여러 부품(화면·기능·데이터)을 서로 올바르게 연결해 주는 "전기 배선" 담당입니다. 레고 블록을 따로따로 만들어 두면 소용없듯, 이 명령이 블록들을 제 위치에 끼워 맞춰 앱이 실제로 동작하게 해줍니다.

누가·언제 쓰나요#

새 기능을 만든 뒤, 그 기능이 앱 전체와 제대로 이어지도록 "연결 작업"이 필요한 개발자
/app:di 명령을 직접 실행할 때
기능 전체 자동 생성(/feature:create)이 진행되는 도중, 부품을 합치는 단계에서 자동으로 호출될 때

무엇을 해주나요#

연결 방식을 옛날 방식(getIt/injectable)에서 깔끔한 새 방식으로 통일해 줍니다. 구체적으로는:

앱 전체에서 공용으로 쓰는 기능(예: 로그인 AuthBloc, 알림 NotificationBloc)을 앱 시작 지점(bootstrap.dart)에서 만들어 연결
개별 화면이 자기 기능을 직접 만들어 쓰도록 배선
서로 의존하는 부품 간의 "꼬임(순환 의존)" 문제를 풀어줌
이 모든 규칙을 지켰는지 점검할 체크리스트 제공

어떻게 쓰나요#

# 기본 실행
/app:di

# 같은 기능을 부르는 다른 이름(별칭)도 사용 가능
/di:create
/wiring:setup

전달할 수 있는 값:

feature_name (필수) — 연결할 기능 모듈 이름 (snake_case 형식)
module_type (선택) — app / console / common 중 선택 (기본값 app)
is_global (선택) — 앱 전체 공용 기능인지 여부 (기본값 false)

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

금지된 옛날 방식 제거 — getIt, @injectable 같은 더 이상 쓰지 않는 연결 코드를 쓰지 않도록 막습니다.
화면별 기능 연결 — 각 화면이 필요한 기능을 직접 생성해 끼워 넣습니다.
공용 기능 연결 — 앱 시작 지점에서 로그인·알림 같은 공용 부품을 만들고 앱 전체에 공유합니다.
꼬임 풀기 — 서로 맞물린 부품(알림 ↔ 로그인)의 순환 의존을 분리해 안전하게 초기화합니다.
점검 — 모든 규칙(금지 패턴 미사용, 올바른 생성 방식 등)을 체크리스트로 확인합니다.

⚙️ 상세 옵션·실행 명세 (개발자 / AI 에이전트용)

Role#

Sets up Pure DI-based dependency wiring.

Global BLoC creation (bootstrap.dart)
BlocProvider.value Pattern (App)
Page BLoC direct creation (BlocProvider)
UseCase Optional Constructor Injection
Router initialization (initializeRouter)

Activation Conditions#

/app:di Activated when command is invoked
/feature:create orchestration integration phase

Parameters#

Parameter	Required	Description
`feature_name`	✅	Feature module name (snake_case)
`module_type`	❌	`app`, `console`, `common` (default: `app`)
`is_global`	❌	Global BLoC Whether (default: `false`)

Removed Patterns (Prohibited)#

// ❌ All removed
getIt<T>()
getIt.registerLazySingleton<T>(...)
getIt.registerFactory<T>(...)
@injectable / @lazySingleton / @singleton
@microPackageInit
MicroPackageModule / PackageModule
injector.dart / injector.module.dart
di/ 폴더
ExternalModule(...)
export 'src/di/injector.dart'

Core Patterns#

1. Page BLoC (Most common)#

class {Feature}Page extends StatelessWidget {
  const {Feature}Page({super.key});

  @override
  Widget build(BuildContext context) {
    return BlocProvider(
      create: (_) => {Feature}Bloc()
        ..add(const {Feature}Event.loadRequested()),
      child: const {Feature}View(),
    );
  }
}

2. Global BLoC (Created in bootstrap.dart)#

Authoritative DI paths (verify against the kobic monorepo):
ServiceLocator (get_it 대체) → package/core/lib/src/app/service_locator.dart
App-level wiring / ServiceLocator.instance.registerSingleton(...) → app/kobic/lib/bootstrap.dart and app/kobic_console/lib/bootstrap.dart
❌ No package/core/lib/src/di/ folder — .../di/app_service_locator.dart and .../di/console_service_locator.dart do not exist.

// app/kobic/lib/bootstrap.dart  (console: app/kobic_console/lib/bootstrap.dart)
final notificationBloc = NotificationBloc();
final authBloc = AuthBloc(notificationBloc: notificationBloc);
notificationBloc.initAuthListener(authBloc);

runApp(App(blocs: GlobalBlocProviders(
  authBloc: authBloc,
  notificationBloc: notificationBloc,
)));

3. App (BlocProvider.value)#

class App extends StatelessWidget {
  const App({required this.blocs, super.key});

  final GlobalBlocProviders blocs;

  @override
  Widget build(BuildContext context) {
    return MultiBlocProvider(
      providers: [
        BlocProvider<AuthBloc>.value(value: blocs.authBloc),
        BlocProvider<NotificationBloc>.value(value: blocs.notificationBloc),
      ],
      child: const MaterialApp(...),
    );
  }
}

4. BLoC Generation (Optional Constructor Injection)#

class {Feature}Bloc extends Bloc<{Feature}Event, {Feature}State> {
  {Feature}Bloc({
    Get{Entity}UseCase? get{Entity}UseCase,
    AuthBloc? authBloc,  // cross-BLoC: nullable
  }) : _get{Entity}UseCase = get{Entity}UseCase ?? const Get{Entity}UseCase(),
       _authBloc = authBloc,
       super(const {Feature}State());

  final Get{Entity}UseCase _get{Entity}UseCase;
  final AuthBloc? _authBloc;
}

5. UseCase (Direct creation)#

class Get{Entity}UseCase {
  const Get{Entity}UseCase([I{Feature}Repository? repo])
      : _repo = repo ?? const {Feature}Repository();

  final I{Feature}Repository _repo;

  Future<Either<Failure, {Entity}>> call(Get{Entity}Params params) {
    return _repo.get{Entity}(params);
  }
}

// ✅ Use context.read
context.read<AuthBloc>().add(const AuthEvent.signOut());

// ❌ getIt usage prohibited

7. Router Initialization#

AppRouter.initializeRouter(authBloc);

Feature Module Barrel File#

// lib/{feature_name}.dart
library;

export 'src/data/data.dart';
export 'src/domain/domain.dart';
export 'src/presentation/presentation.dart';
export 'src/route/route.dart';
// No di/ export!

Circular Dependency Resolution#

// NotificationBloc <-> AuthBloc circular dependency resolution
final notificationBloc = NotificationBloc();
final authBloc = AuthBloc(notificationBloc: notificationBloc);
notificationBloc.initAuthListener(authBloc);  // Separated initialization

Test Patterns#

class MockGetDataUseCase extends Mock implements GetDataUseCase {}

blocTest<{Feature}Bloc, {Feature}State>(
  'emits [loading, loaded] when load succeeds',
  setUp: () {
    when(() => mockGetData(any()))
        .thenAnswer((_) async => right(testData));
  },
  build: () => {Feature}Bloc(get{Entity}UseCase: mockGetData),
  act: (bloc) => bloc.add(const {Feature}Event.loadRequested()),
  expect: () => [
    const {Feature}State.loading(),
    {Feature}State.loaded(data: testData),
  ],
);

di-agent

/app:di — 부품 연결 담당#

한마디로#

누가·언제 쓰나요#

무엇을 해주나요#

어떻게 쓰나요#

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

Role#

Activation Conditions#

Parameters#

Removed Patterns (Prohibited)#

Core Patterns#

1. Page BLoC (Most common)#

2. Global BLoC (Created in bootstrap.dart)#

3. App (BlocProvider.value)#

4. BLoC Generation (Optional Constructor Injection)#

5. UseCase (Direct creation)#

6. Accessing BLoC from Widget#

7. Router Initialization#

Feature Module Barrel File#

Circular Dependency Resolution#

Test Patterns#

Checklist#

di-agent

/app:di — 부품 연결 담당#

한마디로#

누가·언제 쓰나요#

무엇을 해주나요#

어떻게 쓰나요#

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

Role#

Activation Conditions#

Parameters#

Removed Patterns (Prohibited)#

Core Patterns#

1. Page BLoC (Most common)#

2. Global BLoC (Created in bootstrap.dart)#

3. App (BlocProvider.value)#

4. BLoC Generation (Optional Constructor Injection)#

5. UseCase (Direct creation)#

6. Accessing BLoC from Widget#

7. Router Initialization#

Feature Module Barrel File#

Circular Dependency Resolution#

Test Patterns#

Checklist#

Related Documents#