@walwal-harness/cli 4.0.0-alpha.9 → 4.0.0-beta.2

package/skills/evaluator-functional-flutter/SKILL.md

@@ -1,206 +0,0 @@
----
-name: harness-evaluator-functional-flutter
-description: "하네스 Flutter Functional Evaluator. Playwright 대신 flutter analyze / flutter test / build_runner 일관성 / 정적 anti-pattern 검증으로 Flutter 앱을 평가한다. Step 0 IA Gate → Step 1-6 정적/동적 검증. 기준 미달 = FAIL."
-disable-model-invocation: true
----
-
-# Evaluator-Functional-Flutter — Dart/Flutter 정적·동적 검증
-
-> **이 에이전트는 `fe_target = mobile` 또는 `desktop` 일 때만 사용된다.**
->
-> Flutter Mobile/Desktop 앱은 브라우저가 아니므로 Playwright MCP(`browser_*`)를 쓸 수 없다.
-> 이 에이전트는 `flutter analyze`, `flutter test`, `dart format`, 정적 grep 검증, 생성 파일
-> 일관성으로 평가한다. 실기기/시뮬레이터 UI 검증은 사람 QA 또는 별도 파이프라인으로 위임.
->
-> **`fe_target = web` 인 Flutter Web 프로젝트는 이 에이전트가 아니라 일반 `evaluator-functional`
-> 과 `evaluator-visual` 이 Playwright 로 검증한다** (컴파일 결과가 HTML+JS+CSS 이므로).
-> 이 경우 Generator-Frontend-Flutter 의 Self-Verification 단계에서 `flutter analyze` /
-> `flutter test` / `flutter build web --release` 가 이미 통과했음이 전제된다.
-
-## Session Boundary Protocol
-
-### On Start
-1. `.harness/progress.json` 읽기 — `next_agent`가 `"evaluator-functional-flutter"`인지 확인
-2. `.harness/actions/pipeline.json.fe_stack == "flutter"` 재확인 — 아니면 즉시 STOP + 불일치 보고
-3. progress.json 업데이트: `current_agent` → `"evaluator-functional-flutter"`, `agent_status` → `"running"`, `updated_at` 갱신
-
-### On Complete (PASS)
-1. progress.json 업데이트:
-   - `agent_status` → `"completed"`
-   - `completed_agents`에 `"evaluator-functional-flutter"` 추가
-   - `next_agent` → `"archive"` (fe_stack=flutter 이면 evaluator-visual 생략)
-   - `failure` 필드 초기화
-2. `feature-list.json`의 통과 feature `passes`에 `"evaluator-functional-flutter"` 추가
-3. `.harness/progress.log`에 PASS 요약 추가
-4. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
-5. 출력: `"✓ Evaluator-Functional-Flutter PASS. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
-
-### On Fail
-1. progress.json 업데이트:
-   - `agent_status` → `"failed"`
-   - `failure.agent` → `"evaluator-functional-flutter"`
-   - `failure.location` → `"frontend"` (Flutter 앱은 항상 FE 재작업)
-   - `failure.message` → 실패 요약 (1줄)
-   - `failure.retry_target` → `"generator-frontend-flutter"`
-   - `next_agent` → `"generator-frontend-flutter"`
-   - `sprint.retry_count` 증가
-2. `sprint.retry_count >= 10`이면 `agent_status` → `"blocked"`, 사용자 개입 요청
-3. `.harness/progress.log`에 FAIL 요약 추가
-4. **STOP.**
-5. 출력: `"✖ Evaluator-Functional-Flutter FAIL. bash scripts/harness-next.sh 실행하여 재작업 대상 확인."`
-
-## Critical Mindset
-
-- **회의적 평가자**. Generator의 자체 평가를 신뢰하지 말고 직접 돌려라.
-- `flutter analyze` 경고가 있으면 "사소하다"고 자기 설득 금지 — 기준 미달.
-- 코드 읽기만으로 PASS 판정 금지 — **반드시 `flutter analyze` + `flutter test` 실행**.
-- 기준 미달 = FAIL. 예외 없음.
-
-## Startup
-
-1. `AGENTS.md` 읽기 — IA-MAP (Flutter 경로 확인)
-2. `.harness/gotchas/evaluator-functional-flutter.md` (없으면 skip) — **과거 실수 반복 금지**
-3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
-4. `actions/sprint-contract.md` — FE 성공 기준
-5. `actions/feature-list.json` — 이번 스프린트 범위 (`layer: "frontend"` + `fe_stack: "flutter"`)
-6. `actions/api-contract.json` — 기대 API 계약 (Retrofit 매핑 대조용)
-7. `.harness/progress.json`
-8. **Generator의 anti-patterns.md 로드** — 정적 검증 rule 소스
-   → `skills/generator-frontend-flutter/references/anti-patterns.md`
-
-## Evaluation Steps
-
-### Step 0: IA Structure Compliance (GATE)
-
-AGENTS.md IA-MAP vs 실제 구조 대조. **미통과 시 이하 전체 SKIP, 즉시 FAIL.**
-
-상세 → [IA 검증 가이드](references/ia-compliance.md)
-
-### Step 1: `flutter analyze` (정적 분석)
-
-```bash
-# 프로젝트 루트 또는 integrated_data_layer 하위에서
-flutter analyze --no-fatal-infos
-```
-
-- **warning / error 1개 이상 → FAIL**
-- info 수준은 허용 (하지만 evaluation 보고서에 카운트 기록)
-
-### Step 2: `flutter test` (단위/위젯 테스트)
-
-```bash
-# integrated_data_layer 테스트
-cd <integrated_data_layer 경로>
-flutter test
-
-# 앱 테스트 (존재 시)
-cd <app 루트>
-flutter test
-```
-
-- **실패 1개 이상 → FAIL**
-- 이번 스프린트에서 추가된 Request Body / Response에 `fromJson`/`toJson` 왕복 테스트 **존재 확인**
-  - 누락 시 → FAIL (Coverage gate)
-
-### Step 3: build_runner 일관성
-
-```bash
-cd <integrated_data_layer 경로>
-flutter pub run build_runner build --delete-conflicting-outputs
-git diff --name-only
-```
-
-- 재생성 후 `*.g.dart` diff 가 발생하면 → **FAIL** (Generator가 수동 편집 또는 재생성 누락)
-
-### Step 4: Anti-Pattern 정적 검증
-
-`skills/generator-frontend-flutter/references/anti-patterns.md` 의 **"셀프 체크 스크립트"** 섹션을
-그대로 실행한다. 하나라도 결과가 있으면 → **FAIL**.
-
-상세 → [정적 검증 룰](references/static-check-rules.md)
-
-### Step 5: API Contract Compliance
-
-`api-contract.json` 의 엔드포인트 vs `rest_api.dart` 의 Retrofit 어노테이션 대조:
-
-- 계약에 있는 모든 엔드포인트가 `rest_api.dart` 에 존재하는가
-- method, path, path param, body 타입이 일치하는가
-- Response 타입이 계약 스키마와 구조적으로 일치하는가 (필드 존재 + nullable 여부)
-- **불일치 1개 이상 → FAIL**
-
-### Step 6: Sprint Contract Criteria
-
-`sprint-contract.md` 의 FE 성공 기준을 순서대로 검증:
-
-- 새 페이지가 `xxx_page.dart` + `xxx_page_vm.dart` 쌍으로 존재하는가
-- VM이 `NotifierProvider` 를 사용하는가
-- i18n 키가 모든 arb 파일에 등록되었는가
-- 기준별 PASS/FAIL 기록 → 충족률 계산
-
-## Scoring
-
-| 차원 | 가중치 | 하드 임계값 | 측정 방법 |
-|------|--------|------------|----------|
-| Static Analysis | 25% | warning/error 0개 | `flutter analyze` |
-| Test Pass Rate | 25% | 100% | `flutter test` |
-| API Contract 준수 | 25% | 100% | rest_api.dart vs api-contract.json |
-| Anti-Pattern 청결 | 15% | 위반 0건 | 정적 grep |
-| Contract Criteria 충족률 | 10% | 80% | sprint-contract 기준 |
-
-**어떤 차원이든 하드 임계값 미달 → 스프린트 FAIL**
-
-상세 채점 → [스코어링 루브릭](references/scoring-rubric.md)
-
-## evaluation-functional.md 출력
-
-```markdown
-# Flutter Functional Evaluation: Sprint [N]
-
-## Date: [날짜]
-## Verdict: PASS / FAIL
-## Attempt: [N] / 10
-## Stack: flutter
-
-## Step 0: IA Structure Compliance
-- Verdict: PASS / FAIL (GATE)
-
-## Step 1: Flutter Analyze
-- errors: [N]
-- warnings: [N]
-- infos: [N]
-
-## Step 2: Flutter Test
-- total: [N], passed: [N], failed: [N]
-- missing_roundtrip_tests: [목록]
-
-## Step 3: build_runner 일관성
-- drift: [none | 목록]
-
-## Step 4: Anti-Pattern
-| Rule | Count | Files |
-| dart:html | 0 | - |
-| print() | 0 | - |
-| Color(0x...) in 신규 | 0 | - |
-| bridges/ 신규 | 0 | - |
-| Text('한글') 신규 | 0 | - |
-
-## Step 5: API Contract Compliance
-| EP ID | Method + Path | Dart Match | Issues |
-
-## Step 6: Contract Criteria Results
-| # | Criterion | Result | Evidence |
-
-## Scores
-| Dimension | Score | Threshold | Status |
-
-## Failures Detail
-### [#N] [기준/항목]
-- **Expected**: ...
-- **Actual**: ...
-- **Recommendation**: ...
-```
-
-## After Evaluation
-
-- **PASS** → Session Boundary Protocol On Complete (PASS) 실행
-- **FAIL** → Session Boundary Protocol On Fail 실행 (retry_target = generator-frontend-flutter)

package/skills/evaluator-functional-flutter/references/ia-compliance.md

@@ -1,77 +0,0 @@
----
-docmeta:
-  id: ia-compliance
-  title: IA Structure Compliance — Step 0 (Gate) for Flutter
-  type: output
-  createdAt: 2026-04-09T00:00:00Z
-  updatedAt: 2026-04-09T00:00:00Z
-  source:
-    producer: agent
-    skillId: harness-evaluator-functional-flutter
-  inputs:
-    - documentId: evaluator-functional-ia-compliance
-      uri: ../../evaluator-functional/references/ia-compliance.md
-      relation: output-from
-      sections:
-        - sourceRange:
-            startLine: 1
-            endLine: 37
-          targetRange:
-            startLine: 32
-            endLine: 120
-  tags:
-    - evaluator
-    - flutter
-    - ia-compliance
-    - gate
----
-
-# IA Structure Compliance — Step 0 (Gate) for Flutter
-
-## 검증 방법
-
-```bash
-# 1. 실제 Flutter 구조 확인
-ls -R lib/ integrated_data_layer/lib/ 2>/dev/null
-
-# 2. git diff로 소유권 위반 검출 (이번 스프린트 범위)
-git log --name-only --pretty=format: HEAD~[sprint_commits].. | sort -u
-```
-
-## 검증 항목
-
-| 검증 | 판정 | 예시 |
-|------|------|------|
-| IA-MAP 경로가 실제 존재하는가 | 누락 → FAIL | `lib/ui/pages/` 미생성 |
-| IA-MAP에 없는 경로가 생겼는가 | 미등록 → DRIFT 기록 | `lib/services/` 무단 생성 |
-| `[FE]` 소유를 BE가 수정했는가 | 침범 → FAIL | `lib/ui/` BE 수정 |
-| `[META]`/`[HARNESS]` 침범 | 침범 → FAIL | `AGENTS.md` 수정 |
-| `pubspec.yaml` 의존성 추가가 계약 범위 내인가 | 범위 이탈 → DRIFT 기록 | 승인 없는 의존성 추가 |
-
-## Flutter 전용 추가 검증
-
-| 검증 | 판정 |
-|------|------|
-| `integrated_data_layer/lib/2_data_sources/remote/` 내 파일이 프로젝트 컨벤션(`request/body/`, `response/`, `rest_api.dart`)을 지키는가 | 위반 → FAIL |
-| `lib/ui/pages/` 내 새 페이지가 `xxx_page.dart` + `xxx_page_vm.dart` 쌍으로 존재하는가 | 파트너 누락 → FAIL |
-| `bridges/` 하위에 신규 파일이 추가되었는가 | 추가 → FAIL (레거시 금지) |
-| `lib/l10n/` 의 arb 파일 키 집합이 모든 언어에서 동일한가 | 불일치 → FAIL |
-
-## 판정 규칙
-
-- **경로 누락 / 소유권 침범 / 파트너 누락** → 즉시 FAIL, Step 1 이하 SKIP
-- **미등록 경로 (Drift)** → FAIL 아님, evaluation에 `## AGENTS.md Drift` 기록
-- **arb 키 불일치** → FAIL (i18n 원칙 위반)
-
-## Output (evaluation-functional.md에 포함)
-
-```markdown
-## Step 0: IA Structure Compliance
-- Verdict: PASS / FAIL (GATE)
-- IA-MAP paths checked: [N]개
-- Missing paths: [목록 또는 "none"]
-- Unregistered paths: [목록 또는 "none"]
-- Ownership violations: [목록 또는 "none"]
-- Page/VM pair check: [N pages checked, N missing partners]
-- arb key diff: [none | "app_ja.arb missing: cancel, confirm"]
-```

package/skills/evaluator-functional-flutter/references/scoring-rubric.md

@@ -1,132 +0,0 @@
----
-docmeta:
-  id: scoring-rubric
-  title: Flutter Functional Evaluation 스코어링 루브릭
-  type: output
-  createdAt: 2026-04-09T00:00:00Z
-  updatedAt: 2026-04-09T00:00:00Z
-  source:
-    producer: agent
-    skillId: harness-evaluator-functional-flutter
-  inputs:
-    - documentId: react-evaluator-scoring-rubric
-      uri: ../../evaluator-functional/references/scoring-rubric.md
-      relation: output-from
-      sections:
-        - sourceRange:
-            startLine: 1
-            endLine: 53
-          targetRange:
-            startLine: 32
-            endLine: 160
-  tags:
-    - evaluator
-    - flutter
-    - scoring
-    - rubric
----
-
-# Flutter Functional Evaluation 스코어링 루브릭
-
-## 차원별 채점
-
-| 차원 | 가중치 | 하드 임계값 | 측정 방법 |
-|------|--------|------------|----------|
-| Static Analysis | 25% | warning/error 0개 | `flutter analyze --no-fatal-infos` |
-| Test Pass Rate | 25% | 100% | `flutter test` 모든 스위트 |
-| API Contract 준수 | 25% | 100% | rest_api.dart vs api-contract.json 대조 — 불일치 즉시 FAIL |
-| Anti-Pattern 청결 | 15% | 위반 0건 | static-check-rules.md 의 FL-01 ~ FL-08 |
-| Contract Criteria 충족률 | 10% | 80% | sprint-contract.md FE 기준 통과 수 / 전체 |
-
-**어떤 차원이든 하드 임계값 미달 → 스프린트 FAIL**
-
-## 차원별 점수 계산
-
-### Static Analysis (25점)
-
-| 결과 | 점수 |
-|------|------|
-| error 0, warning 0 | 25 |
-| error 0, warning 1~2 | 0 (하드 임계값 미달 → FAIL) |
-| error 1+ | 0 (즉시 FAIL) |
-
-info 수준은 점수에 반영하지 않지만 보고서에 카운트 기록.
-
-### Test Pass Rate (25점)
-
-```
-score = 25 * (passed / total)
-```
-
-- `total == 0` (테스트 존재하지 않음) → **0점 + FAIL** (Coverage gate)
-- `fromJson/toJson` 왕복 테스트 누락 (이번 스프린트 추가분) → **FAIL**
-
-### API Contract 준수 (25점)
-
-```
-score = 25 * (matched_endpoints / total_endpoints)
-```
-
-불일치 허용 없음 — 1개라도 불일치면 즉시 FAIL (하드 임계값 100%).
-
-매칭 체크:
-- method (GET/POST/PUT/DELETE)
-- path (변수명 포함)
-- path param → `@Path(...)` 매핑
-- body → `@Body() XxxBody`
-- response 타입 → 계약 스키마의 code/data/errors 구조
-
-### Anti-Pattern 청결 (15점)
-
-```
-score = 15 * (passed_rules / total_rules)
-```
-
-- 8개 룰 중 1개라도 FAIL → **0점 + 스프린트 FAIL**
-- 위반 0건이면 15점
-
-### Contract Criteria 충족률 (10점)
-
-```
-score = 10 * (passed_criteria / total_criteria)
-```
-
-- 80% 미달 → FAIL
-- 개별 기준의 실패 사유를 "Failures Detail"에 기록
-
-## Total
-
-```
-total = static_analysis + test_pass + api_contract + anti_pattern + contract_criteria
-verdict = PASS (if all hard thresholds met AND total >= 80) else FAIL
-```
-
-## failure_location 라우팅
-
-Flutter 앱은 항상 FE 재작업이므로:
-
-| location | 재작업 대상 |
-|----------|-----------|
-| `frontend` (기본) | `generator-frontend-flutter` |
-
-예외: API Contract 불일치가 **서버 측 계약 오류**로 확인된 경우 → Planner에게 계약 수정 요청 필요.
-이 경우 evaluation에 `## Change Request` 섹션 추가.
-
-## evaluation-functional.md 헤더
-
-```markdown
-# Flutter Functional Evaluation: Sprint [N]
-
-## Date: [YYYY-MM-DD]
-## Verdict: PASS / FAIL
-## Attempt: [N] / 10
-## Stack: flutter
-
-## Total Score: [N] / 100
-| Dimension | Score | Threshold | Status |
-| Static Analysis | X/25 | warning=0 | PASS/FAIL |
-| Test Pass Rate | X/25 | 100% | PASS/FAIL |
-| API Contract | X/25 | 100% | PASS/FAIL |
-| Anti-Pattern | X/15 | 0 violations | PASS/FAIL |
-| Contract Criteria | X/10 | 80% | PASS/FAIL |
-```

package/skills/evaluator-functional-flutter/references/static-check-rules.md

@@ -1,99 +0,0 @@
----
-docmeta:
-  id: static-check-rules
-  title: Flutter 정적 검증 룰 (Anti-Pattern Gate)
-  type: output
-  createdAt: 2026-04-09T00:00:00Z
-  updatedAt: 2026-04-09T00:00:00Z
-  source:
-    producer: agent
-    skillId: harness-evaluator-functional-flutter
-  inputs:
-    - documentId: flutter-anti-patterns
-      uri: ../../generator-frontend-flutter/references/anti-patterns.md
-      relation: output-from
-      sections:
-        - sourceRange:
-            startLine: 1
-            endLine: 280
-          targetRange:
-            startLine: 32
-            endLine: 180
-  tags:
-    - evaluator
-    - flutter
-    - static-check
-    - anti-pattern
----
-
-# Flutter 정적 검증 룰
-
-Generator의 `anti-patterns.md` 를 Source of Truth 로 삼아 정적 검증을 수행한다.
-Generator가 신규 룰을 추가하면 Evaluator는 자동으로 그 룰을 따르게 된다 — **두 문서 간 drift 금지.**
-
-## 실행 방법
-
-**Evaluator는 반드시** `skills/generator-frontend-flutter/references/anti-patterns.md` 의
-"셀프 체크 스크립트" 섹션을 **파일로 읽어서 그대로 실행**한다. 하네스의 단일 진실 원칙.
-
-```bash
-# anti-patterns.md 에서 bash 블록만 추출해서 실행
-awk '/^```bash$/,/^```$/' skills/generator-frontend-flutter/references/anti-patterns.md
-```
-
-## 룰 요약 (Evaluator가 결과를 표로 정리)
-
-| Rule ID | 설명 | 명령 | Fail 조건 |
-|---------|------|------|----------|
-| FL-01 | 웹 API 직접 참조 | `grep -rn "dart:html\|universal_html" lib/ integrated_data_layer/lib/` | 매치 1+ |
-| FL-02 | print/console 남발 | `grep -rn "^\s*print(" lib/ integrated_data_layer/lib/` | 매치 1+ |
-| FL-03 | 하드코딩 색상 (신규) | `git diff --name-only --diff-filter=A HEAD~N..HEAD \| grep '\.dart$' \| xargs grep -n "Color(0x"` | 매치 1+ (`ColorManager` 참조 제외) |
-| FL-04 | StatefulWidget 직접 API 호출 | 수동 감사 — `_page.dart` 에 `dataLayer\|DataLayer` 호출이 있는데 짝 `_page_vm.dart` 없음 | 패턴 발견 |
-| FL-05 | bridges/ 신규 참조 | `git diff HEAD~N..HEAD \| grep "^+.*bridges/"` | 매치 1+ |
-| FL-06 | 하드코딩 한글 (신규 UI) | `git diff --name-only --diff-filter=AM HEAD~N..HEAD \| grep 'lib/ui/.*\.dart$' \| xargs grep -n "Text('[가-힣]"` | 매치 1+ |
-| FL-07 | JsonSerializable includeIfNull 누락 | `grep -rn "@JsonSerializable" integrated_data_layer/lib/2_data_sources/remote/request/body/ \| grep -v "includeIfNull: false"` | 매치 1+ |
-| FL-08 | API 키/시크릿 하드코딩 | `grep -rEn "(api[_-]?key\|secret\|token)\s*=\s*['\"][A-Za-z0-9]{16,}['\"]" lib/ integrated_data_layer/lib/` | 매치 1+ |
-
-> `HEAD~N` 의 N은 sprint_commits 수 — `git log --format=%h HEAD~sprint_start..HEAD` 로 결정.
-
-## FL-04 수동 감사 방법
-
-```bash
-# 1. 신규/수정된 page 파일 목록
-PAGES=$(git diff --name-only HEAD~N..HEAD | grep '_page\.dart$')
-
-# 2. 각 page에서 API 호출 존재 여부
-for p in $PAGES; do
-  if grep -q "dataLayer\|DataLayer" "$p"; then
-    vm="${p%_page.dart}_page_vm.dart"
-    if [ -f "$vm" ] && grep -q "dataLayer\|DataLayer" "$vm"; then
-      echo "OK (VM handles API): $p"
-    else
-      echo "FAIL (page calls API without VM): $p"
-    fi
-  fi
-done
-```
-
-VM이 없고 페이지가 직접 호출하면 **FL-04 FAIL**.
-
-## 결과 집계
-
-```markdown
-## Step 4: Anti-Pattern
-
-| Rule | Status | Count | Files |
-|------|--------|-------|-------|
-| FL-01 dart:html | PASS/FAIL | 0 | - |
-| FL-02 print | PASS/FAIL | 0 | - |
-| FL-03 color hardcode | PASS/FAIL | 0 | - |
-| FL-04 stateful API call | PASS/FAIL | 0 | - |
-| FL-05 bridges/ new | PASS/FAIL | 0 | - |
-| FL-06 ko hardcode | PASS/FAIL | 0 | - |
-| FL-07 includeIfNull missing | PASS/FAIL | 0 | - |
-| FL-08 secret hardcode | PASS/FAIL | 0 | - |
-
-Overall: PASS / FAIL
-```
-
-**어떤 룰이든 FAIL 1건 → Step 4 전체 FAIL → 스프린트 FAIL** (하드 임계값: 위반 0건).

package/skills/generator-frontend-flutter/SKILL.md

@@ -1,173 +0,0 @@
----
-name: harness-generator-frontend-flutter
-description: "하네스 Flutter Frontend Generator. Flutter(Dart) + Riverpod + integrated_data_layer(Retrofit) 기반 모바일 앱을 구현한다. ARB 다국어, JsonSerializable, NotifierProvider 패턴 준수. api-contract.json이 Source of Truth — UI 추론 금지."
-disable-model-invocation: true
----
-
-# Generator-Frontend-Flutter — Dart + Riverpod + integrated_data_layer
-
-## Session Boundary Protocol
-
-### On Start
-1. `.harness/progress.json` 읽기 — `next_agent`가 `"generator-frontend-flutter"`인지 확인
-2. `.harness/actions/pipeline.json`의 `fe_stack == "flutter"` 재확인 — 아니면 즉시 STOP + 사용자에게 불일치 보고
-3. progress.json 업데이트: `current_agent` → `"generator-frontend-flutter"`, `agent_status` → `"running"`, `updated_at` 갱신
-4. `failure` 필드 확인 — retry인 경우 평가 문서의 실패 사유 우선 읽기
-
-### On Complete
-1. progress.json 업데이트:
-   - `agent_status` → `"completed"`
-   - `completed_agents`에 `"generator-frontend-flutter"` 추가
-   - `next_agent` → `"evaluator-functional-flutter"`
-   - `failure` 필드 초기화
-2. `feature-list.json`의 해당 feature `passes`에 `"generator-frontend-flutter"` 추가
-3. `.harness/progress.log`에 요약 추가
-4. **STOP. 다음 에이전트를 직접 호출하지 않는다.**
-5. 출력: `"✓ Generator-Frontend-Flutter 완료. bash scripts/harness-next.sh 실행하여 다음 단계 확인."`
-
-## Startup
-
-1. `AGENTS.md` 읽기 — IA-MAP, 권한 확인 (Flutter 소유 경로)
-2. `.harness/gotchas/generator-frontend-flutter.md` 읽기 (없으면 skip) — **과거 실수 반복 금지**
-3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
-4. `pwd` + `.harness/progress.json` + `git log --oneline -20`
-5. `.harness/actions/api-contract.json` 읽기 — **서버 API 계약이 Source of Truth**
-6. `.harness/actions/feature-list.json` — `layer: "frontend"` 필터
-7. `.harness/actions/pipeline.json` 의 **`fe_target`** 확인 (`web` | `mobile` | `desktop`)
-   - 이 값에 따라 허용되는 API, 빌드 명령, 안티패턴이 달라진다 (아래 "fe_target 분기" 섹션 참조)
-8. `pubspec.yaml` 확인 — Flutter 버전, Riverpod/Retrofit/json_serializable 의존성 존재 확인
-   - `fe_target = web` 인 경우 `flutter config --enable-web` 활성화 + `web/index.html` 존재 확인
-
-## AGENTS.md — 읽기 전용
-
-`[FE]` + `→ Generator-Frontend-Flutter` 소유 경로만 쓰기 가능. 일반적으로:
-- `lib/ui/pages/`, `lib/ui/component/`, `lib/l10n/`
-- `integrated_data_layer/lib/`, `integrated_data_layer/test/`
-- `assets/strings/`
-
-Backend 코드, `.harness/`, `AGENTS.md` 수정 금지.
-
-## Sprint Workflow
-
-1. **Sprint Contract FE 섹션 추가** — 페이지, VM, API 연동, 성공 기준
-2. **api-contract.json → Retrofit/JsonSerializable 변환**
-3. **구현** — 아래 4개 레퍼런스를 반드시 참조
-4. **코드 생성**: `flutter pub run build_runner build --delete-conflicting-outputs`
-5. **Self-Verification** — `flutter analyze` + `flutter test` 통과
-6. **Handoff** → Evaluator-Functional-Flutter
-
-## 개발론 레퍼런스 (점진적 로딩)
-
-| 문서 | 내용 | 언제 로드 |
-|------|------|----------|
-| [API Layer Pattern](references/api-layer-pattern.md) | integrated_data_layer 구조, Request/Response, Retrofit | API 연동 시 |
-| [Riverpod Pattern](references/riverpod-pattern.md) | Page+VM 쌍, NotifierProvider, family 패턴 | 페이지/위젯 구현 시 |
-| [i18n Pattern](references/i18n-pattern.md) | ARB 파일, LocaleAssist, 키 네이밍 | 문자열 추가 시 |
-| [Anti-Patterns](references/anti-patterns.md) | 금지 API, 하드코딩, bridges/, StatefulWidget 직접 호출 (fe_target 별 차이 포함) | 구현 완료 후 셀프 체크 |
-| [Flutter Web Pattern](references/flutter-web-pattern.md) | Web 전용 — `dart:html`/`package:web` 허용, 라우팅, 빌드, hosting | `fe_target = web` 일 때만 |
-
-## fe_target 분기
-
-`pipeline.json.fe_target` 에 따라 적용되는 규칙이 다르다:
-
-### `fe_target = web` (Flutter Web)
-
-- **빌드**: `flutter build web --release` / 개발 서버: `flutter run -d chrome`
-- **HTML/JS 인터롭 허용**: `dart:html`, `package:web`, `dart:js_interop` 사용 가능
-  - 단, 가능하면 cross-platform 코드를 우선하고 web 전용 코드는 `if (kIsWeb)` 가드 또는 conditional import
-- **라우팅**: `go_router` 권장 (URL 동기화). `Navigator 1.0` 의 `MaterialApp.routes` 도 OK 지만 hash routing 주의
-- **자산**: `web/index.html`, `web/manifest.json`, `web/icons/` 관리. SEO 가 필요하면 `<meta>` 태그 명시
-- **CORS**: 백엔드 API 가 `localhost:포트` 에서 다른 origin 일 수 있으므로 CORS 설정 확인
-- **Eval 흐름**: Playwright 기반 `evaluator-functional` + `evaluator-visual` 이 정상 작동 (브라우저 E2E + 시각 검증)
-- 상세 → [Flutter Web Pattern](references/flutter-web-pattern.md)
-
-### `fe_target = mobile` (Android / iOS)
-
-- **빌드**: `flutter build apk` / `flutter build ios` / 개발: `flutter run -d <device>`
-- **HTML/JS 인터롭 금지**: `dart:html`, `package:web`, `universal_html` 직접 참조 → 빌드 실패
-- **플랫폼 채널**: 네이티브 기능 사용 시 `MethodChannel` 또는 검증된 plugin 사용
-- **권한**: `AndroidManifest.xml` / `Info.plist` 에 권한 명시
-- **Eval 흐름**: 정적 분석 기반 `evaluator-functional-flutter` 사용 (Playwright 불가)
-
-### `fe_target = desktop` (macOS / Windows / Linux)
-
-- **빌드**: `flutter build macos` / `flutter build windows` / `flutter build linux`
-- **HTML/JS 인터롭 금지**: 모바일과 동일
-- **윈도우 관리**: `window_manager` 등 플러그인으로 윈도우 크기/위치 제어
-- **Eval 흐름**: 정적 분석 기반 `evaluator-functional-flutter` 사용
-
-## 핵심 규칙
-
-### api-contract.json → Dart 변환 규칙
-
-- 각 엔드포인트 → `rest_api.dart`에 Retrofit 어노테이션 (`@GET`, `@POST`, `@PUT`, `@DELETE`)
-- Request body → `2_data_sources/remote/request/body/xxx_body.dart` (`@JsonSerializable(includeIfNull: false)`)
-- Response → `2_data_sources/remote/response/xxx_response.dart` (`ClueResponseImpl<T>` 상속 or 재사용)
-- **필수 지시가 없으면 모든 필드는 Nullable** — 서버가 언제든 필드를 누락할 수 있음
-- **기존 응답 타입 재사용 우선** — 동일 구조면 새 클래스 생성 금지
-- Repository 래퍼 메서드 추가 → `1_repositories/xxx_repository.dart`
-
-### UI / 상태관리
-
-- 모든 페이지 = `xxx_page.dart` + `xxx_page_vm.dart` 쌍
-- Page는 `ConsumerStatefulWidget` 또는 `ConsumerWidget`
-- VM은 `NotifierProvider<Notifier, State>` (다중 인스턴스는 `.family`)
-- State는 `Equatable` + `copyWith` 불변성
-- `ref.watch` (build 내) / `ref.read` (이벤트 핸들러, initState)
-- API 호출은 반드시 VM 안에서 `ref.read(dataLayer).xxx.method()`
-- Provider 네이밍: `p` + PascalCase + `Provider` (예: `pHomePageProvider`)
-
-### 다국어 (i18n)
-
-- 영문 전용 지시가 없는 한 **모든 사용자 노출 문자열은 ARB 경유 필수**
-- ARB: `lib/l10n/app_en.arb`, `app_ko.arb`, `app_ja.arb`
-- 코드 접근: `LocaleAssist().of.키이름`
-- 키 네이밍: camelCase (예: `doorOpen`, `networkError`)
-- 모든 언어 파일에 동일 키 동시 추가
-
-### 코드 생성
-
-Request Body / Response / rest_api.dart 수정 후 **반드시** 실행:
-
-```bash
-cd <integrated_data_layer 경로>
-flutter pub run build_runner build --delete-conflicting-outputs
-```
-
-## Self-Verification (Handoff 전)
-
-1. `flutter analyze` → 경고 0개 (info 수준은 허용, warning/error 금지)
-2. `flutter test` → 100% 통과
-3. integrated_data_layer의 새 Request Body / Response에 `fromJson`/`toJson` 왕복 테스트 존재
-4. `grep -rn 'dart:html\|universal_html\|print(\|console\.log' lib/ integrated_data_layer/lib/` → 0개
-5. `grep -rn "bridges/" lib/` → 신규 코드 내 참조 0개
-6. 하드코딩 색상(`Color(0xFF...`) → `ColorManager` 경유 확인
-7. 새 페이지/위젯은 `StatefulWidget`에서 직접 API 호출하지 않는지 확인 (VM/Provider 경유)
-
-## 금지 사항
-
-- Backend 코드 수정, 서버 API 경로 임의 변경
-- api-contract.json에 없는 엔드포인트 호출/추가
-- `dart:html`, `universal_html` 직접 참조
-- `print()` / `debugPrint` 남발 — `logger` 사용
-- 하드코딩 색상 → `ColorManager` 강제
-- `StatefulWidget` 내 직접 API 호출 → VM/Provider 경유
-- `bridges/` 신규 개발 — BLOC 기반 레거시, 유지보수만 허용
-- AI 추측으로 서버 응답 구조를 만들지 말 것 (계약이 Source of Truth)
-- API 키/시크릿 하드코딩
-
-## 명령어
-
-```bash
-flutter pub get                                                    # 의존성
-flutter run                                                        # 실행
-flutter test                                                       # 테스트
-flutter analyze                                                    # 정적 분석
-flutter pub run build_runner build --delete-conflicting-outputs    # 코드 생성
-```
-
-## After Completion
-
-1. sprint-contract.md의 FE 섹션에 완료 항목 체크
-2. Self-Verification 체크리스트 결과 요약
-3. Session Boundary Protocol On Complete 실행