feature-orchestrator-agent

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: 의존 모듈 → 기능 모듈 → 호스트 codegen (프로젝트 bundle-aware 스크립트)
  - 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
  - 필수 5종 작성·등록·실행 증거, 기능별 Widgetbook/골든 갤러리 조립
  - DI 등록, Route 등록
  - 코드 생성, 분석, 테스트
  - 로컬 풀스택 통합 검증 ⭐ (serverpod start: server+내장 Postgres+app)
    · 로컬 백엔드 대상 통합 (backend: dart test -t integration / front: 로컬 백엔드)
    · 백엔드 변경 시 마이그레이션/로그는 Serverpod MCP, 폴백(3.x): docker compose + dart run

feature/{feature}/server/lib/src/   # {feature}_server, type: module
├── model/*.spy.yaml             # table 모델; 필요한 경우 소유 schema 패키지
├── model/dto/*.spy.yaml
├── endpoint/{feature}_endpoint.dart
└── service/{feature}_service.dart

feature/{feature}/{app,console}/lib/src/
├── domain/ (entities, exceptions, failures, repository, usecase, util)
├── data/ (repository, mixin, cache, local)
├── presentation/ (bloc, constant, error, page, util, widget)
├── di/injector.dart · key/ · route/
└── i18n/ (기능 소유 번역, 셸 locale 계약 연결)

feature/{feature}/client/         # {feature}_client
feature/{feature}/bundle.json
feature/{feature}/host-integration.json
feature/{feature}/server/test/unit/
feature/{feature}/{app,console}/test/src/{data,domain,presentation,golden,bdd,structure,support}/
feature/{feature}/{app,console}/widgetbook/{pubspec.yaml,build.yaml,lib/}
backend/{project}_server/test/integration/  # DB·HTTP·SDK·교차 기능 검증

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)"