Phase 0: Preflight (MCP  &   환경 점검)
    ↓ - marionette_mcp 실행 파일 확인
    ↓ - 미설치 시 `fvm dart pub global activate marionette_mcp` 자동 실행
    ↓ - `claude mcp list`로 연결 상태 확인, 실패 시 절대 경로로 재등록
    ↓ - Cursor/Zed 설정(`~/.cursor/mcp.json`, `~/.config/zed/settings.json`) 동기화
    ↓ (실패 시 중단 후 사용자에게 보고)
Phase 0.5: Check existing Feature
    ↓ (Select update/skip/regenerate)
Phase 1: Requirements gathering (Interactive)
    ↓
Phase 2: Plan creation (TodoWrite)
    ↓
Phase 3: Backend implementation
  - Step 1: /cc-serverpod:model 호출
  - Step 2: /cc-serverpod:endpoint 호출
  - Step 3: backend:pod:generate
  - Step 4: 마이그레이션
    ↓
Phase 4: Frontend implementation
  - Step 5: /cc-flutter:feature:domain 호출
  - Step 6: /cc-flutter:feature:data 호출
  - Step 7: /cc-flutter:feature:presentation 호출
    ↓
Phase 4.5: Figma style application (conditional)
    ↓
Phase 4.7: Actual behavior implementation
    ↓
Phase 5: Integration and verification
  - DI 등록, Route 등록
  - 코드 생성, 분석, 테스트
  - 로컬 풀스택 통합 검증 ⭐ (serverpod start: server+내장 Postgres+app)
    · 로컬 백엔드 대상 통합 (backend: dart test -t integration / front: 로컬 백엔드)
    · 백엔드 변경 시 마이그레이션/로그는 Serverpod MCP, 폴백(3.x): docker compose + dart run

backend/kobic_server/lib/src/feature/{feature}/
├── model/entities/*.spy.yaml
├── model/dto/*.spy.yaml
├── endpoint/{feature}_endpoint.dart
└── service/{feature}_service.dart

feature/{location}/{feature}/lib/src/
├── domain/ (entity, repository, usecase)
├── data/ (repository, mixin, cache, local)
├── presentation/ (bloc, page, widget, route)
└── di/injection.dart

set -euo pipefail

MCP_BIN= " $HOME/.pub-cache/bin/marionette_mcp " 
 FVM_BIN= " /Users/dongwoo/fvm/default/bin " 

 # 1) 실행 파일 확인 + fvm 경유 자동 설치
if [ ! -x  " $MCP_BIN "   ]; then
  echo  " ⚠️  marionette_mcp 미설치 — fvm dart pub global activate 실행 " 
   fvm dart pub global activate marionette_mcp
fi

# 2) PATH 주입 (GUI 앱 고려: ~/.zshrc 업데이트 + 현재 쉘 반영)
case  " :$PATH: "   in
  * " :$HOME/.pub-cache/bin: " *) ;;
  *)
    echo  ' export PATH= " $PATH:$HOME/.pub-cache/bin " '   > >   " $HOME/.zshrc " 
     export PATH= " $PATH:$HOME/.pub-cache/bin " 
     ;;
esac

# 3) Claude Code MCP 등록 상태 확인/재등록
if ! claude mcp list 2 > & 1 | grep -q  " marionette:.*✓ Connected " ; then
  claude mcp remove marionette 2 > /dev/null || true
  claude mcp add --transport stdio marionette --  " $MCP_BIN " 
 fi

# 4) Cursor/Zed 설정 부재 시 생성 안내 (GUI 앱은 절대 경로 + env.PATH 필수)
test -f  " $HOME/.cursor/mcp.json "              || echo  " ℹ️  Cursor 설정 필요 (~/.cursor/mcp.json) " 
 test -f  " $HOME/.config/zed/settings.json "    || echo  " ℹ️  Zed 설정 필요 (~/.config/zed/settings.json) "