@walwal-harness/cli 2.0.1 → 2.3.0

package/skills/generator-frontend-flutter/references/api-layer-pattern.md

@@ -0,0 +1,233 @@
+---
+docmeta:
+  id: api-layer-pattern
+  title: API Layer Pattern (integrated_data_layer)
+  type: output
+  createdAt: 2026-04-09T00:00:00Z
+  updatedAt: 2026-04-09T00:00:00Z
+  source:
+    producer: agent
+    skillId: harness-generator-frontend-flutter
+  inputs:
+    - documentId: clue-fe-flutter-api-layer
+      uri: ../../../../../moon_web/clue-fe-flutter.skill
+      relation: output-from
+      sections:
+        - sourceRange:
+            startLine: 1
+            endLine: 187
+          targetRange:
+            startLine: 32
+            endLine: 205
+  tags:
+    - flutter
+    - retrofit
+    - json-serializable
+    - integrated-data-layer
+---
+
+# API Layer Pattern (integrated_data_layer)
+
+하네스 Flutter Generator는 `api-contract.json` 을 **Source of Truth** 로 삼아
+`integrated_data_layer` 하위에 Dart 타입을 1:1 생성한다.
+
+## 디렉토리 구조
+
+```
+integrated_data_layer/
+├── lib/
+│   ├── 1_repositories/              # Repository (비즈니스 로직 래퍼)
+│   │   ├── ac_repository.dart
+│   │   ├── visitor_repository.dart
+│   │   ├── s3_repository.dart
+│   │   ├── oauth_repository.dart
+│   │   └── reservation_repository.dart
+│   ├── 2_data_sources/
+│   │   ├── remote/
+│   │   │   ├── rest_api.dart           # 모든 Retrofit 엔드포인트
+│   │   │   ├── rest_provider.dart      # Dio/RestClient Provider
+│   │   │   ├── request/body/           # Request Body 클래스
+│   │   │   └── response/
+│   │   │       └── abstract/          # 베이스 응답 (ClueResponseImpl 등)
+│   │   └── local/
+│   └── 3_others/
+│       ├── enum/
+│       └── extension/
+├── test/                               # lib/ 미러 구조
+│   ├── 1_repositories/
+│   ├── 2_data_sources/remote/request/body/
+│   └── 2_data_sources/remote/response/
+└── data_layer.dart                     # 진입점 (dataLayer Provider)
+```
+
+## 1. api-contract.json → Request Body 변환
+
+api-contract.json의 요청 스키마를 `@JsonSerializable(includeIfNull: false)`
+클래스로 1:1 매핑한다. **필수 지시가 없으면 모든 필드 Nullable.**
+
+```dart
+// lib/2_data_sources/remote/request/body/example_body.dart
+import 'package:json_annotation/json_annotation.dart';
+
+part 'example_body.g.dart';
+
+@JsonSerializable(includeIfNull: false)  // ★ 필수
+class ExampleBody {
+  final String? name;       // ★ Nullable 기본
+  final int? placeId;
+  final String? description;
+
+  const ExampleBody({
+    this.name,
+    this.placeId,
+    this.description,
+  });
+
+  factory ExampleBody.fromJson(Map<String, dynamic> json) =>
+      _$ExampleBodyFromJson(json);
+  Map<String, dynamic> toJson() => _$ExampleBodyToJson(this);
+}
+```
+
+## 2. Response 변환
+
+응답 베이스 클래스 계층:
+- `ClueResponseImpl<T>` — 단일 데이터 (code, data, errors)
+- `ClueResponseListImpl<T>` — 목록 (code, data, errors, totalCount)
+- `VisitorResponseImpl<T>` — Visitor 서버 전용
+
+```dart
+// lib/2_data_sources/remote/response/example_response.dart
+import 'package:integrated_data_layer/2_data_sources/remote/response/abstract/clue/clue_response_impl.dart';
+import 'package:json_annotation/json_annotation.dart';
+
+part 'example_response.g.dart';
+
+@JsonSerializable(explicitToJson: true)
+class ExampleResponse extends ClueResponseImpl<ExampleResponseData> {
+  const ExampleResponse({
+    required super.code,
+    required super.data,
+    required super.errors,
+  });
+
+  factory ExampleResponse.fromJson(Map<String, dynamic> json) =>
+      _$ExampleResponseFromJson(json);
+  Map<String, dynamic> toJson() => _$ExampleResponseToJson(this);
+}
+
+@JsonSerializable(explicitToJson: true)
+class ExampleResponseData {
+  final int? id;          // ★ Nullable 기본
+  final String? name;
+
+  const ExampleResponseData({this.id, this.name});
+
+  factory ExampleResponseData.fromJson(Map<String, dynamic> json) =>
+      _$ExampleResponseDataFromJson(json);
+  Map<String, dynamic> toJson() => _$ExampleResponseDataToJson(this);
+}
+```
+
+**기존 응답 재사용 원칙**: api-contract.json 의 서로 다른 엔드포인트가
+동일한 응답 구조를 가지면 새 Response 클래스를 만들지 않는다.
+
+## 3. rest_api.dart 엔드포인트 추가
+
+```dart
+// rest_api.dart 내부 — RestClient 클래스에 추가
+@GET("/examples/{exampleId}")
+Future<ExampleResponse> getExample(
+  @Path("exampleId") int exampleId,
+);
+
+@POST("/examples")
+Future<ExampleResponse> createExample(
+  @Body() ExampleBody requestBody,
+);
+
+@PUT("/examples/{exampleId}")
+Future<ExampleResponse> updateExample(
+  @Path("exampleId") int exampleId,
+  @Body() ExampleBody requestBody,
+);
+
+@DELETE("/examples/{exampleId}")
+Future<ClueDefaultResponse> deleteExample(
+  @Path("exampleId") int exampleId,
+);
+```
+
+api-contract.json의 path, method, param 위치를 **그대로** 옮긴다.
+경로 변수 추가/제거 금지 — 계약이 Source of Truth.
+
+## 4. Repository 래퍼 추가
+
+```dart
+// 1_repositories/ac_repository.dart 내부에 메서드 추가
+Future<ExampleResponse> getExample({required int exampleId}) {
+  return _restClient.getExample(exampleId);
+}
+```
+
+Repository는 **순수 래퍼** — 비즈니스 로직 없이 Retrofit 호출을 전달만 한다.
+도메인 분기, 에러 매핑은 VM 계층에서 수행.
+
+## 5. 호출 패턴 (VM에서)
+
+```dart
+// VM 내부
+final result = await ref.read(dataLayer).ac.getExample(exampleId: 123);
+if (result.code == 200) {
+  // 성공 처리
+}
+```
+
+## 6. TC 작성 (필수)
+
+**모든 Request Body, Response에 왕복 테스트 필수.**
+Evaluator가 test 디렉토리를 점검한다.
+
+```dart
+// test/2_data_sources/remote/request/body/example_body_test.dart
+import 'dart:convert';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:integrated_data_layer/2_data_sources/remote/request/body/example_body.dart';
+
+void main() {
+  group("example body test", () {
+    test("/fromJson & toJson", () {
+      ExampleBody body1 = const ExampleBody(
+        name: 'test',
+        placeId: 1,
+      );
+
+      ExampleBody body2 = ExampleBody.fromJson(body1.toJson());
+
+      expect(body1.name, 'test');
+      expect(body1.placeId, 1);
+
+      var body1Data = jsonEncode(body1.toJson());
+      var body2Data = jsonEncode(body2.toJson());
+      expect(body1Data == body2Data, true);
+    });
+
+    test("/null fields excluded", () {
+      ExampleBody body = const ExampleBody(name: 'test');
+      var json = body.toJson();
+      expect(json.containsKey('placeId'), false);  // includeIfNull: false 검증
+    });
+  });
+}
+```
+
+## 7. 코드 생성
+
+모든 Request/Response 파일 추가/수정 후 **반드시** 실행:
+
+```bash
+cd <integrated_data_layer 경로>
+flutter pub run build_runner build --delete-conflicting-outputs
+```
+
+생성된 `*.g.dart` 파일은 커밋한다 (CI에서 재생성하지 않음).

package/skills/generator-frontend-flutter/references/i18n-pattern.md

@@ -0,0 +1,102 @@
+---
+docmeta:
+  id: i18n-pattern
+  title: 다국어 (i18n) ARB 패턴
+  type: output
+  createdAt: 2026-04-09T00:00:00Z
+  updatedAt: 2026-04-09T00:00:00Z
+  source:
+    producer: agent
+    skillId: harness-generator-frontend-flutter
+  inputs:
+    - documentId: clue-fe-flutter-i18n
+      uri: ../../../../../moon_web/clue-fe-flutter.skill
+      relation: output-from
+      sections:
+        - sourceRange:
+            startLine: 1
+            endLine: 60
+          targetRange:
+            startLine: 32
+            endLine: 110
+  tags:
+    - flutter
+    - i18n
+    - arb
+    - l10n
+---
+
+# 다국어 (i18n) ARB 패턴
+
+## ARB 파일 기반 l10n
+
+### 파일 경로
+
+- 영어: `lib/l10n/app_en.arb`
+- 한국어: `lib/l10n/app_ko.arb`
+- 일본어: `lib/l10n/app_ja.arb`
+
+프로젝트에 따라 `assets/strings/en.json` 등 다른 경로를 쓸 수 있다.
+`AGENTS.md` / sprint-contract.md 의 기존 컨벤션을 우선한다.
+
+### 작업 순서
+
+1. 문자열 언어 판별 (예: "취소" → ko, "Cancel" → en)
+2. 해당 언어 arb 파일에 **키 존재 여부 확인** (중복 방지)
+3. 없으면 모든 언어 파일에 동시 추가 (`app_en.arb`, `app_ko.arb`, `app_ja.arb`)
+4. 코드 치환 → `LocaleAssist().of.키이름`
+
+### 사용법
+
+```dart
+// 기본 문자열
+Text(
+  LocaleAssist().of.cancel,
+  style: MyTextStyle.size15.w500.xFF9CA3AF,
+)
+
+// 문자열 내 스타일 별도 구현 (ClueText 등 프로젝트 커스텀 위젯 사용)
+ClueText(
+  "${LocaleAssist().of.all} (${count})",
+  style: MyTextStyle.size16.w500,
+  targetList: [
+    TargetModel(
+      text: "(${count})",
+      style: MyTextStyle.size16.w500.xFF6682FF,
+    ),
+  ],
+)
+```
+
+### ARB 키 네이밍 규칙
+
+```json
+{
+  "cancel": "취소",
+  "confirm": "확인",
+  "doorOpen": "문 열기",
+  "networkError": "네트워크 오류가 발생했습니다"
+}
+```
+
+- **camelCase** 사용
+- 모든 arb 파일(en, ko, ja)에 **동일 키 동시 추가**
+- 기존 키 검색 후 중복 방지 (`grep -rn '"cancel"' lib/l10n/`)
+- 플레이스홀더 필요 시 ICU MessageFormat 사용
+
+## 필수 원칙
+
+- 영문 전용 표기 지시가 없는 한 **모든 사용자 노출 문자열은 다국어 처리**
+- 하드코딩된 문자열 사용 금지 (`Text('취소')` ✗)
+- 새 페이지 추가 시 관련 문자열 **일괄 등록** — 스프린트 중 누락 방지
+- 모든 arb 파일의 키 집합은 동일해야 한다 (Evaluator가 diff 검사)
+
+## Self-Check
+
+```bash
+# 하드코딩된 한글 탐지
+grep -rn "Text('[가-힣]" lib/ui/
+
+# 누락 키 탐지 (en 기준)
+python3 -c "import json; en=set(json.load(open('lib/l10n/app_en.arb')).keys()); ko=set(json.load(open('lib/l10n/app_ko.arb')).keys()); print('missing in ko:', en - ko); print('missing in en:', ko - en)"
+```

package/skills/generator-frontend-flutter/references/riverpod-pattern.md

@@ -0,0 +1,199 @@
+---
+docmeta:
+  id: riverpod-pattern
+  title: Riverpod 상태관리 패턴 (Page + VM)
+  type: output
+  createdAt: 2026-04-09T00:00:00Z
+  updatedAt: 2026-04-09T00:00:00Z
+  source:
+    producer: agent
+    skillId: harness-generator-frontend-flutter
+  inputs:
+    - documentId: clue-fe-flutter-riverpod
+      uri: ../../../../../moon_web/clue-fe-flutter.skill
+      relation: output-from
+      sections:
+        - sourceRange:
+            startLine: 1
+            endLine: 149
+          targetRange:
+            startLine: 32
+            endLine: 180
+  tags:
+    - flutter
+    - riverpod
+    - state-management
+    - notifier-provider
+---
+
+# Riverpod 상태관리 패턴 (Page + VM)
+
+## 기본 구조: Page + VM 쌍
+
+모든 화면은 `xxx_page.dart` + `xxx_page_vm.dart` 쌍으로 구성.
+이는 테스트 가능성과 UI/로직 분리를 위한 강제 규약.
+
+### VM (ViewModel)
+
+```dart
+// example_page_vm.dart
+import 'package:equatable/equatable.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:integrated_data_layer/data_layer.dart';
+
+final pExampleProvider =
+    NotifierProvider<ExampleNotifier, ExampleState>(ExampleNotifier.new);
+
+class ExampleNotifier extends Notifier<ExampleState> {
+  @override
+  ExampleState build() {
+    return const ExampleState();
+  }
+
+  Future<void> loadData() async {
+    state = state.copyWith(isLoading: true);
+    try {
+      final result = await ref.read(dataLayer).ac.getExample(exampleId: 1);
+      if (result.code == 200) {
+        state = state.copyWith(
+          isLoading: false,
+          data: result.data,
+        );
+      } else {
+        state = state.copyWith(
+          isLoading: false,
+          error: 'code=${result.code}',
+        );
+      }
+    } catch (e) {
+      state = state.copyWith(isLoading: false, error: e.toString());
+    }
+  }
+}
+
+class ExampleState extends Equatable {
+  final bool isLoading;
+  final dynamic data;
+  final String? error;
+
+  const ExampleState({
+    this.isLoading = false,
+    this.data,
+    this.error,
+  });
+
+  ExampleState copyWith({
+    bool? isLoading,
+    dynamic data,
+    String? error,
+  }) {
+    return ExampleState(
+      isLoading: isLoading ?? this.isLoading,
+      data: data ?? this.data,
+      error: error ?? this.error,
+    );
+  }
+
+  @override
+  List<Object?> get props => [isLoading, data, error];
+}
+```
+
+### Page
+
+```dart
+// example_page.dart
+import 'package:flutter/material.dart';
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'example_page_vm.dart';
+
+class ExamplePage extends ConsumerStatefulWidget {
+  const ExamplePage({super.key});
+
+  @override
+  ConsumerState<ExamplePage> createState() => _ExamplePageState();
+}
+
+class _ExamplePageState extends ConsumerState<ExamplePage> {
+  @override
+  void initState() {
+    super.initState();
+    // 초기 데이터 로드는 addPostFrameCallback 으로
+    WidgetsBinding.instance.addPostFrameCallback((_) {
+      ref.read(pExampleProvider.notifier).loadData();
+    });
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    final state = ref.watch(pExampleProvider);  // watch로 상태 구독
+
+    if (state.isLoading) {
+      return const Center(child: CircularProgressIndicator());
+    }
+    if (state.error != null) {
+      return Center(child: Text(state.error!));
+    }
+    // ... 정상 상태 렌더링
+    return const SizedBox.shrink();
+  }
+}
+```
+
+## Family 패턴 (다중 자식 컴포넌트)
+
+리스트 아이템처럼 동일 타입 인스턴스가 여러 개 필요할 때:
+
+```dart
+// relay_tile_vm.dart
+final pRelayItemProvider = NotifierProvider.family<
+    RelayItemNotifier,
+    RelayItemState,
+    ({int ioId, String topic})>(
+  () => RelayItemNotifier(),
+);
+
+class RelayItemNotifier
+    extends FamilyNotifier<RelayItemState, ({int ioId, String topic})> {
+  @override
+  RelayItemState build(({int ioId, String topic}) arg) {
+    ref.onDispose(() {
+      // 정리 로직 (스트림 구독 해제 등)
+    });
+    return RelayItemState(ioId: arg.ioId, topic: arg.topic);
+  }
+
+  Future<void> doAction() async {
+    final result = await ref.read(dataLayer).ac.someMethod(id: state.ioId);
+    state = state.copyWith(/* ... */);
+  }
+}
+```
+
+사용:
+```dart
+// Page/Widget에서
+final itemState = ref.watch(
+  pRelayItemProvider((ioId: item.ioId, topic: item.topic)),
+);
+```
+
+## 핵심 규칙
+
+| 규칙 | 설명 |
+|------|------|
+| `ref.watch` | UI rebuild이 필요한 곳 (build 메서드 내) |
+| `ref.read` | 일회성 호출 (이벤트 핸들러, initState 콜백) |
+| `dataLayer` 접근 | VM 내에서 `ref.read(dataLayer).repository.method()` |
+| State 불변성 | Equatable 상속 + copyWith 패턴 |
+| Provider 네이밍 | `p` 접두사 + PascalCase + Provider (예: `pHomePageProvider`) |
+| 초기 로드 | `addPostFrameCallback` 으로 첫 프레임 이후 호출 |
+| 에러/로딩 | State에 `isLoading`, `error` 필수 포함 (UI 3가지 상태 처리) |
+
+## 금지
+
+- `bridges/` 사용 금지 — BLOC 기반 레거시
+- StatefulWidget 내 직접 API 호출 — 반드시 VM 경유
+- `setState` 로 API 응답 상태 관리 — Riverpod 상태로 대체
+- `ref.read`를 build 메서드 내에서 사용 (→ `ref.watch`)
+- VM 내 UI 의존 코드 (Navigator, ScaffoldMessenger 등) — UI 콜백으로 분리

package/skills/planner/SKILL.md

@@ -26,7 +26,18 @@ disable-model-invocation: true
 1. `AGENTS.md` 읽기
 2. `.harness/gotchas/planner.md` 읽기 — **과거 실수 반복 금지**
 3. `.harness/progress.json` 읽기
-4. `.harness/actions/pipeline.json` 읽기 — `planner_mode` 확인
+4. `.harness/actions/pipeline.json` 읽기 — `planner_mode`, `fe_stack` 확인
+5. `.harness/actions/scan-result.json` 읽기 — `tech_stack.fe_stack` 확인 (없으면 `react` 기본)
+6. **Brainstorm Spec 우선 로드** — `.harness/actions/brainstorm-spec.md` 가 존재하면
+   **이 파일이 PRD 대체 입력**. Brainstormer 가 이미 사용자와 대화하여 확정한
+   결과이므로 **승인된 결정을 뒤엎지 않는다**. 없으면 사용자의 원본 요청 텍스트를 입력으로 사용.
+   - brainstorm-spec.md 에 `## Open Questions` 섹션이 있으면 Planner 가 해소 (API 계약으로 확정)
+   - brainstorm-spec.md 의 `## 7. 주요 컴포넌트 / 엔티티` → `feature-list.json` 초기 feature 목록 시드
+   - brainstorm-spec.md 의 `## 5. 선택된 접근법` / `## 6. 아키텍처 스케치` → MSA 서비스 분할 베이스
+7. **FE Stack 확정** → [FE Stack 결정 가이드](references/fe-stack-detection.md)
+   - `pubspec.yaml` + `flutter:` 키 → `fe_stack = "flutter"`
+   - 혼재/불명확 → 사용자에게 단 한 번 질문
+   - 확정 후 `pipeline.json.fe_stack` 갱신 (없으면 생성)
 
 ## Outputs (4개)
 
@@ -42,6 +53,17 @@ disable-model-invocation: true
 - **full**: MSA 서비스 분할 + 전체 설계 (FULLSTACK, BE-ONLY)
 - **light**: OpenAPI → api-contract.json 변환 + FE 설계만 (FE-ONLY)
 
+## fe_stack (FE 파이프라인 분기)
+
+`pipeline.json.fe_stack`은 FE Generator/Evaluator 선택을 결정한다:
+
+| 값 | FE Generator | FE Evaluator | 비고 |
+|----|--------------|--------------|------|
+| `react` (기본) | `generator-frontend` | `evaluator-functional` + `evaluator-visual` | Vercel/Next.js/Tailwind |
+| `flutter` | `generator-frontend-flutter` | `evaluator-functional-flutter` | Riverpod + integrated_data_layer, Eval-Visual 생략 |
+
+**Planner는 `pipeline.json`에 `fe_stack`을 반드시 기록해야 한다.** Dispatcher가 이 값으로 `next_agent`를 라우팅한다.
+
 ## Process
 
 1. 사양서 작성 → [plan 템플릿](references/plan-template.md)

package/skills/planner/references/fe-stack-detection.md

@@ -0,0 +1,131 @@
+---
+docmeta:
+  id: fe-stack-detection
+  title: FE Stack Detection — Planner Responsibility
+  type: output
+  createdAt: 2026-04-09T00:00:00Z
+  updatedAt: 2026-04-09T00:00:00Z
+  source:
+    producer: agent
+    skillId: harness-planner
+  inputs:
+    - documentId: clue-fe-flutter-skill
+      uri: ../../../../../moon_web/clue-fe-flutter.skill
+      relation: output-from
+      sections:
+        - sourceRange:
+            startLine: 1
+            endLine: 103
+          targetRange:
+            startLine: 79
+            endLine: 94
+    - documentId: harness-planner-skill
+      uri: ../SKILL.md
+      relation: output-from
+      sections:
+        - sourceRange:
+            startLine: 26
+            endLine: 56
+          targetRange:
+            startLine: 27
+            endLine: 78
+  tags:
+    - planner
+    - fe-stack
+    - flutter
+    - pipeline
+---
+
+# FE Stack Detection — Planner Responsibility
+
+Planner는 Sprint 1 착수 전 반드시 `fe_stack`을 확정하고 `pipeline.json`에 기록해야 한다.
+
+## 1. 감지 순서 (자동)
+
+```
+1. .harness/actions/scan-result.json 의 tech_stack.fe_stack 읽기
+2. 값이 "flutter" 또는 "react" 면 → 그대로 사용
+3. 값이 없거나 "unknown" 이면 → 아래 추가 감지
+```
+
+### 추가 감지 (fallback)
+
+| 시그널 | 판정 |
+|--------|------|
+| 루트 `pubspec.yaml` + `flutter:` 키 존재 | `flutter` |
+| 하위 경로(예: `mobile/`, `apps/mobile/`, `clue_mobile_app/`)에 pubspec.yaml | `flutter` |
+| `package.json` 에 `react`, `next`, `vite` 등 | `react` |
+| `lib/` + `.dart` 파일 다수 | `flutter` |
+| 둘 다 존재 (Flutter + Web 혼재) | **사용자 질문 필수** |
+
+## 2. 사용자 질문 (불명확 시 단 한 번)
+
+```
+프론트엔드 스택을 확인합니다:
+
+(A) React / Next.js / Vite 기반 Web
+(B) Flutter (Dart, 모바일/데스크톱)
+
+현재 감지된 시그널:
+- pubspec.yaml: [있음/없음]
+- package.json: [있음/없음]
+- Next.js config: [있음/없음]
+
+어떤 스택으로 진행하시겠습니까? (A/B)
+```
+
+혼재 프로젝트(Web + Flutter mobile)라면 사용자에게 **현 스프린트의 타깃**을 묻는다 — 파이프라인은 한 번에 하나의 `fe_stack`만 취급한다.
+
+## 3. pipeline.json 갱신
+
+`fe_stack` 확정 후 `pipeline.json`에 반드시 추가:
+
+```json
+{
+  "pipeline": "FULLSTACK",
+  "planner_mode": "full",
+  "fe_stack": "flutter",
+  "agents_active": [
+    "planner",
+    "generator-backend",
+    "generator-frontend-flutter",
+    "evaluator-functional-flutter"
+  ],
+  "agents_skipped": [
+    "generator-frontend",
+    "evaluator-functional",
+    "evaluator-visual"
+  ],
+  "evaluator_mode": "flutter-native",
+  "notes": "Flutter 앱 — Playwright 대신 flutter analyze/test + 정적 anti-pattern 검증"
+}
+```
+
+### fe_stack → 파이프라인 매핑
+
+| pipeline | fe_stack | agents_active 예시 |
+|----------|----------|-------------------|
+| FULLSTACK | react | planner, generator-backend, generator-frontend, evaluator-functional, evaluator-visual |
+| FULLSTACK | flutter | planner, generator-backend, generator-frontend-flutter, evaluator-functional-flutter |
+| FE-ONLY | react | planner, generator-frontend, evaluator-functional, evaluator-visual |
+| FE-ONLY | flutter | planner, generator-frontend-flutter, evaluator-functional-flutter |
+| BE-ONLY | (무관) | planner, generator-backend, evaluator-functional |
+
+## 4. Flutter 선택 시 추가 작업
+
+Flutter로 확정되면 Planner는:
+
+1. **AGENTS.md IA-MAP** 의 `[FE]` 섹션을 Flutter 구조로 바꿔야 한다.
+   - `apps/web/` → `lib/ui/pages/`, `lib/ui/component/`
+   - `libs/shared-dto/` 대신 `integrated_data_layer/` 경로 등록
+   - 소유자: `→ Generator-Frontend-Flutter`
+
+2. **api-contract.json** 은 언어 중립적이어야 한다 — Planner는 TypeScript 타입이 아니라 **스키마 JSON** 으로만 작성. Flutter Generator가 Retrofit/JsonSerializable로 변환한다.
+
+3. **feature-list.json** 의 `layer: "frontend"` feature들은 `fe_stack: "flutter"` 태그를 달아서 Evaluator가 구분하도록 한다.
+
+## 5. 금지
+
+- 파이프라인 실행 도중 `fe_stack` 변경 금지 — 스프린트 경계에서만 가능
+- React/Flutter 코드 혼재 생성 금지 — Generator는 하나의 stack만 담당
+- 사용자가 명시적으로 한 스택을 지시했는데 감지 결과로 다른 스택을 강제하지 말 것