project-auto-wizard 0.12.0 → 0.12.2

package/payload/workflows/flutter/PROJECT-FLUTTER-CI.yaml

@@ -1,7 +1,5 @@
 # project-auto-wizard:managed-workflow
-# ==========================================================================================
 # Flutter CI (코드 분석 및 빌드 검증) 워크플로우
-# ==========================================================================================
 #
 # 이 워크플로우는 PR 생성 또는 {{MAIN_BRANCH}} 브랜치 푸시 시
 # 코드 정적 분석(flutter analyze)과 Android/iOS 앱 빌드를 검증합니다.
@@ -22,9 +20,7 @@
 # 3. ENABLE_ANDROID, ENABLE_IOS로 빌드 대상 플랫폼 선택
 # 4. ENV_FILE_PATH로 환경변수 파일 경로 커스터마이징
 #
-# ==========================================================================================
-# 🔧 프로젝트별 설정
-# ==========================================================================================
+# 프로젝트별 설정
 #
 # ANALYZE_ONLY    : true면 analyze만 실행, 빌드 스킵 (기본: false)
 # ENABLE_ANDROID  : Android 빌드 활성화 여부 (ANALYZE_ONLY=false일 때)
@@ -37,15 +33,12 @@
 # FLUTTER_PROJECT_DIR : Flutter 루트 경로 (설치 시 자동 설정, 모노레포는 app 등)
 # PROJECT_PATH    : 변경 감지 기준 경로 (설치 시 자동 설정, "."이면 항상 실행)
 #
-# ==========================================================================================
-# 🔑 필수 GitHub Secrets
-# ==========================================================================================
+# 필수 GitHub Secrets
 # ENV_FILE (선택): .env 파일 내용
 #
 # ※ CI는 빌드 검증 목적이므로 서명/배포 관련 Secrets 불필요
 # ※ 모노레포에서 이 CI를 required check로 쓰려면 개별 job이 아니라 `ci-gate` 하나만 등록하세요.
 #    (경로가 바뀌지 않아 건너뛴 job은 Success로 집계되고, ci-gate가 최종 결과를 판정합니다)
-# ==========================================================================================
 
 name: PROJECT-Flutter-CI
 
@@ -74,25 +67,23 @@ permissions:
   contents: read
   pull-requests: write
 
-# ==========================================================================================
-# 🔧 프로젝트별 설정 (아래 값들을 수정하세요)
-# ==========================================================================================
+# 프로젝트별 설정 (아래 값들을 수정하세요)
 env:
-  # 🎯 모노레포 변경 감지 경로 (설치 시 자동 설정, 단일 레포는 ".")
+  # 모노레포 변경 감지 경로 (설치 시 자동 설정, 단일 레포는 ".")
   PROJECT_PATH: "."  # @wizard auto:project-path
   # Flutter 루트 경로(레포 루트 기준). 단일레포면 ".", 모노레포면 "app" 등 — 설치 시 자동 설정
   FLUTTER_PROJECT_DIR: "."  # @wizard auto:flutter-root
   # 환경변수 전달 방식 (dart-define | dotenv) — 설치 시 선택값으로 자동 설정
   ENV_MODE: "dart-define"  # @wizard auto:flutter-env-mode
 
-  # 🎯 CI 모드 설정
+  # CI 모드 설정
   ANALYZE_ONLY: "false"     # true: analyze만 실행 (빌드 스킵), false: analyze + 빌드
 
-  # 🎯 빌드 대상 플랫폼 설정 (ANALYZE_ONLY=false일 때만 적용)
+  # 빌드 대상 플랫폼 설정 (ANALYZE_ONLY=false일 때만 적용)
   ENABLE_ANDROID: "true"    # Android 빌드 활성화 (true/false)
   ENABLE_IOS: "true"        # iOS 빌드 활성화 (true/false)
 
-  # 🔧 프로젝트별 설정
+  # 프로젝트별 설정
   FLUTTER_VERSION: "3.35.5"
   JAVA_VERSION: "__JAVA_VERSION__"  # @wizard ask:17
   XCODE_VERSION: "26.0"
@@ -103,9 +94,7 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  # ===================================================================
   # Job 0: 변경 감지 (PROJECT_PATH 아래가 바뀌었을 때만 이후 job 실행)
-  # ===================================================================
   changes:
     name: 변경 감지
     runs-on: ubuntu-latest
@@ -127,9 +116,7 @@ jobs:
             project:
               - '${{ env.PROJECT_PATH == '.' && '**' || format('{0}/**', env.PROJECT_PATH) }}'
 
-  # ===================================================================
   # Job 1: 준비 단계
-  # ===================================================================
   prepare:
     name: CI 준비
     needs: changes
@@ -147,7 +134,6 @@ jobs:
 
     steps:
       # 설정 값 outputs으로 전달
-      # workflow_dispatch 입력값이 있으면 우선 사용, 없으면 env 값 사용
       - name: 설정 값 전달
         id: config
         run: |
@@ -171,7 +157,6 @@ jobs:
           echo "  iOS: $ENABLE_IOS"
           echo "  트리거: ${{ github.event_name }}"
 
-      # 빌드 정보 수집
       - name: 빌드 정보 수집
         id: info
         run: |
@@ -189,7 +174,6 @@ jobs:
           echo "  브랜치: $BRANCH_NAME"
           echo "  커밋: $COMMIT_HASH"
 
-      # PR인 경우 진행 상황 댓글 생성
       - name: 진행 상황 댓글 생성
         id: comment
         if: github.event_name == 'pull_request'
@@ -261,9 +245,7 @@ jobs:
             core.setOutput('comment_id', comment.id);
             core.setOutput('start_time', startTime);
 
-  # ===================================================================
   # Job 2: 코드 분석 (병렬)
-  # ===================================================================
   analyze:
     name: 코드 분석
     runs-on: ubuntu-latest
@@ -303,7 +285,6 @@ jobs:
             echo "dart-define file prepared"
           fi
 
-      # Flutter 설정
       - name: Set up Flutter
         uses: subosito/flutter-action@v2
         with:
@@ -315,7 +296,6 @@ jobs:
           echo "✅ Flutter setup completed"
           flutter --version
 
-      # Flutter 캐시
       - name: Cache Flutter dependencies
         uses: actions/cache@v6
         with:
@@ -323,7 +303,6 @@ jobs:
           key: ${{ runner.os }}-flutter-pub-${{ hashFiles(format('{0}/**/pubspec.lock', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: ${{ runner.os }}-flutter-pub-
 
-      # 프로젝트 의존성 설치
       - name: Install dependencies
         run: |
           flutter pub get
@@ -332,7 +311,6 @@ jobs:
           fi
           echo "✅ Dependencies installed"
 
-      # Flutter Analyze 실행
       - name: Run Flutter Analyze
         id: analyze
         run: |
@@ -340,7 +318,6 @@ jobs:
           flutter analyze --no-fatal-infos
           echo "✅ 코드 분석 완료"
 
-      # 분석 결과 기록
       - name: 분석 결과 기록
         id: result
         if: always()
@@ -360,9 +337,7 @@ jobs:
             core.setOutput('duration', duration);
             console.log(`📋 코드 분석 결과: ${status} (${duration})`);
 
-  # ===================================================================
   # Job 3: Android 빌드 (조건부, 병렬)
-  # ===================================================================
   build-android:
     name: Android 빌드
     if: |
@@ -405,7 +380,6 @@ jobs:
             echo "dart-define file prepared"
           fi
 
-      # Flutter 설정
       - name: Set up Flutter
         uses: subosito/flutter-action@v2
         with:
@@ -417,7 +391,6 @@ jobs:
           echo "✅ Flutter setup completed"
           flutter --version
 
-      # Flutter 캐시
       - name: Cache Flutter dependencies
         uses: actions/cache@v6
         with:
@@ -425,7 +398,6 @@ jobs:
           key: ${{ runner.os }}-flutter-pub-${{ hashFiles(format('{0}/**/pubspec.lock', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: ${{ runner.os }}-flutter-pub-
 
-      # Gradle 캐시
       - name: Cache Gradle dependencies
         uses: actions/cache@v6
         with:
@@ -436,7 +408,6 @@ jobs:
           restore-keys: |
             ${{ runner.os }}-gradle-
 
-      # 프로젝트 의존성 설치
       - name: Install dependencies
         run: |
           flutter pub get
@@ -445,7 +416,6 @@ jobs:
           fi
           echo "✅ Dependencies installed"
 
-      # Java 설정
       - name: Set up Java
         uses: actions/setup-java@v5
         with:
@@ -457,7 +427,6 @@ jobs:
           echo "✅ Java setup completed"
           java -version
 
-      # Gradle 셋업
       - name: Setup Gradle
         working-directory: ${{ env.FLUTTER_PROJECT_DIR }}/android
         run: |
@@ -473,7 +442,6 @@ jobs:
           echo "✅ APK 빌드 완료"
           ls -la ./build/app/outputs/flutter-apk/ || true
 
-      # 빌드 결과 기록
       - name: 빌드 결과 기록
         id: result
         if: always()
@@ -493,9 +461,7 @@ jobs:
             core.setOutput('duration', duration);
             console.log(`📋 Android 빌드 결과: ${status} (${duration})`);
 
-  # ===================================================================
   # Job 4: iOS 빌드 (조건부, 병렬)
-  # ===================================================================
   build-ios:
     name: iOS 빌드
     if: |
@@ -558,7 +524,6 @@ jobs:
             echo "dart-define file prepared"
           fi
 
-      # Flutter 설정
       - name: Set up Flutter
         uses: subosito/flutter-action@v2
         with:
@@ -570,7 +535,6 @@ jobs:
           echo "✅ Flutter setup completed"
           flutter --version
 
-      # Flutter 캐시
       - name: Cache Flutter dependencies
         uses: actions/cache@v6
         with:
@@ -578,7 +542,6 @@ jobs:
           key: ${{ runner.os }}-flutter-pub-${{ hashFiles(format('{0}/**/pubspec.lock', env.FLUTTER_PROJECT_DIR)) }}
           restore-keys: ${{ runner.os }}-flutter-pub-
 
-      # 프로젝트 의존성 설치
       - name: Install dependencies
         run: |
           flutter pub get
@@ -587,7 +550,6 @@ jobs:
           fi
           echo "✅ Dependencies installed"
 
-      # Ruby 및 CocoaPods 설정
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
@@ -600,7 +562,6 @@ jobs:
           cd ios && pod install --repo-update || pod install
           echo "✅ CocoaPods installed"
 
-      # iOS 빌드 (서명 없이)
       - name: Build iOS
         id: build
         run: |
@@ -608,7 +569,6 @@ jobs:
           flutter build ios --release --no-codesign ${DART_DEFINE_FILE:+--dart-define-from-file="$DART_DEFINE_FILE"}
           echo "✅ iOS 빌드 완료"
 
-      # 빌드 결과 기록
       - name: 빌드 결과 기록
         id: result
         if: always()
@@ -628,9 +588,7 @@ jobs:
             core.setOutput('duration', duration);
             console.log(`📋 iOS 빌드 결과: ${status} (${duration})`);
 
-  # ===================================================================
   # Job 5: 결과 보고
-  # ===================================================================
   report:
     name: 결과 보고
     if: always() && github.event_name == 'pull_request' && needs.changes.outputs.project == 'true'
@@ -786,9 +744,7 @@ jobs:
               console.log('⚠️ 댓글 ID가 없어 업데이트를 건너뜁니다.');
             }
 
-  # ===================================================================
   # Job 6: CI Gate (required check로 등록할 단일 진입점)
-  # ===================================================================
   # 건너뛴(skipped) job은 통과로 보고 failure/cancelled가 하나라도 있으면 실패한다.
   ci-gate:
     name: CI Gate

package/payload/workflows/flutter/PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT.yaml

@@ -1,7 +1,5 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Flutter iOS 테스트용 TestFlight 배포 워크플로우
-# ===================================================================
 #
 # 이 워크플로우는 기능 브랜치에서 수동으로 실행하여
 # 테스트용 iOS 빌드를 TestFlight에 배포합니다.
@@ -22,26 +20,22 @@
 #   3. xcodebuild -exportArchive (IPA 생성, ExportOptions.plist 사용)
 #   4. fastlane upload_testflight (ios/fastlane/Fastfile 사용)
 #
-# ===================================================================
-# 🔑 필수 GitHub Secrets
-# ===================================================================
+# 필수 GitHub Secrets
 #
-# 🔐 Apple 인증서 & 프로비저닝 프로파일:
+# Apple 인증서 & 프로비저닝 프로파일:
 # APPLE_CERTIFICATE_BASE64: .p12 인증서 (base64 인코딩)
 # APPLE_CERTIFICATE_PASSWORD: .p12 인증서 비밀번호
 # APPLE_PROVISIONING_PROFILE_BASE64: .mobileprovision 파일 (base64 인코딩)
 # IOS_PROVISIONING_PROFILE_NAME: 프로비저닝 프로파일 이름
 #
-# 🔐 App Store Connect API:
+# App Store Connect API:
 # APP_STORE_CONNECT_API_KEY_ID: API Key ID (10자리)
 # APP_STORE_CONNECT_ISSUER_ID: Issuer ID (UUID 형식)
 # APP_STORE_CONNECT_API_KEY_BASE64: AuthKey_XXXXXX.p8 파일 (base64 인코딩)
 #
-# 📝 환경 설정 (선택):
+# 환경 설정 (선택):
 # ENV_FILE (선택): .env 파일 내용
 # SECRETS_XCCONFIG (선택): ios/Flutter/Secrets.xcconfig 내용
-#
-# ===================================================================
 
 name: PROJECT-Flutter-iOS-Test-TestFlight
 
@@ -54,9 +48,7 @@ on:
   repository_dispatch:
     types: [build-ios-app]
 
-# ===================================================================
-# 🔧 프로젝트별 설정 (아래 값들을 수정하세요)
-# ===================================================================
+# 프로젝트별 설정 (아래 값들을 수정하세요)
 env:
   FLUTTER_VERSION: "3.35.5"
   XCODE_VERSION: "26.0"
@@ -69,9 +61,7 @@ env:
   ENV_FILE_PATH: ".env"
 
 jobs:
-  # ===================================================================
   # 즉시 댓글 생성 (ubuntu-latest로 빠르게 실행)
-  # ===================================================================
   notify-start:
     name: 진행 상황 알림
     runs-on: ubuntu-latest
@@ -183,9 +173,7 @@ jobs:
             core.setOutput('comment_id', comment.id);
             core.setOutput('start_time', startTime);
 
-  # ===================================================================
   # 테스트 빌드 준비 (macOS 환경 설정)
-  # ===================================================================
   prepare-test-build:
     name: 테스트 빌드 준비
     runs-on: macos-26
@@ -233,7 +221,6 @@ jobs:
             echo "ℹ️ Empty Secrets.xcconfig created (no secrets provided)"
           fi
 
-      # 테스트 빌드 버전 설정 (version.yml에서 동적 읽기)
       - name: 테스트 빌드 버전 설정
         id: test_version
         working-directory: ${{ github.workspace }}   # version_manager.py가 레포 루트 version.yml을 읽어야 함
@@ -260,7 +247,6 @@ jobs:
           echo "pr_number=$PR_NUMBER" >> $GITHUB_OUTPUT
           echo "📋 테스트 빌드: 버전=$VERSION, 빌드번호=$BUILD_NUMBER"
 
-      # 브랜치명에서 이슈 번호 추출 및 GitHub API로 이슈 정보 가져오기
       - name: 브랜치명에서 이슈 정보 추출
         id: issue_info
         run: |
@@ -306,7 +292,6 @@ jobs:
             fi
           fi
 
-      # 릴리즈 노트 생성
       - name: 릴리즈 노트 생성
         id: release_notes
         working-directory: ${{ github.workspace }}   # final_release_notes.txt(upload 짝)는 레포 루트 기준
@@ -365,7 +350,6 @@ jobs:
             ${{ env.FLUTTER_PROJECT_DIR }}/assets/
           retention-days: 1
 
-      # 진행 상황 업데이트 - 준비 실패
       - name: 진행 상황 업데이트 - 준비 실패
         if: failure() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
@@ -413,9 +397,7 @@ jobs:
 
             console.log(`❌ 진행 상황 업데이트 완료: 준비 실패`);
 
-  # ===================================================================
   # iOS 빌드 (xcodebuild 직접 사용)
-  # ===================================================================
   build-ios-test:
     name: iOS 테스트 빌드
     runs-on: macos-26
@@ -648,7 +630,6 @@ jobs:
             ${{ env.FLUTTER_PROJECT_DIR }}/build-metadata.json
           retention-days: 1
 
-      # 진행 상황 업데이트 - IPA 빌드 완료
       - name: 진행 상황 업데이트 - IPA 빌드 완료
         id: progress_step2
         if: success() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
@@ -704,7 +685,6 @@ jobs:
             core.setOutput('elapsed', elapsedStr);
             core.setOutput('end_time', now.toString());
 
-      # 빌드 실패 시 progress 댓글 업데이트
       - name: 빌드 실패 시 progress 댓글 업데이트
         if: failure() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
@@ -762,9 +742,7 @@ jobs:
 
             console.log(`❌ 진행 상황 업데이트 완료: IPA 빌드 실패`);
 
-  # ===================================================================
   # TestFlight 배포 (ios/fastlane/Fastfile 사용)
-  # ===================================================================
   deploy-testflight-test:
     name: TestFlight 테스트 배포
     runs-on: macos-26
@@ -884,7 +862,6 @@ jobs:
           echo "❌ TestFlight 테스트 빌드 업로드 실패!"
           echo "로그를 확인해주세요."
 
-      # 진행 상황 최종 업데이트 - 성공
       - name: 진행 상황 최종 업데이트 - 성공
         if: success() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9
@@ -947,7 +924,6 @@ jobs:
 
             console.log(`✅ 진행 상황 최종 업데이트 완료: 전체 성공 (${totalElapsed})`);
 
-      # 진행 상황 최종 업데이트 - 실패
       - name: 진행 상황 최종 업데이트 - 실패
         if: failure() && github.event_name == 'repository_dispatch' && github.event.client_payload.pr_number != '' && needs.notify-start.outputs.comment_id != ''
         uses: actions/github-script@v9

package/payload/workflows/flutter/PROJECT-FLUTTER-IOS-TESTFLIGHT.yaml

@@ -1,7 +1,5 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Flutter iOS TestFlight 자동 배포 워크플로우
-# ===================================================================
 #
 # 이 워크플로우는 Flutter iOS 앱을 빌드하여 TestFlight에 자동 배포합니다.
 #
@@ -14,30 +12,26 @@
 #   3. xcodebuild -exportArchive (IPA 생성, ExportOptions.plist 사용)
 #   4. fastlane deploy (ios/fastlane/Fastfile 사용, DEPLOY_MODE에 따라 TestFlight/심사 제출)
 #
-# ===================================================================
-# 🔑 필수 GitHub Secrets
-# ===================================================================
+# 필수 GitHub Secrets
 #
-# 🔐 Apple 인증서 & 프로비저닝 프로파일:
+# Apple 인증서 & 프로비저닝 프로파일:
 # APPLE_CERTIFICATE_BASE64: .p12 인증서 (base64 인코딩)
 # APPLE_CERTIFICATE_PASSWORD: .p12 인증서 비밀번호
 # APPLE_PROVISIONING_PROFILE_BASE64: .mobileprovision 파일 (base64 인코딩)
 # IOS_PROVISIONING_PROFILE_NAME: 프로비저닝 프로파일 이름
 #
-# 🔑 App Store Connect API:
+# App Store Connect API:
 # APP_STORE_CONNECT_API_KEY_ID: API Key ID (10자리)
 # APP_STORE_CONNECT_ISSUER_ID: Issuer ID (UUID 형식)
 # APP_STORE_CONNECT_API_KEY_BASE64: AuthKey_XXXXXX.p8 파일 (base64 인코딩)
 # IOS_BUNDLE_ID (Secret 우선, 없으면 Variable): 앱 번들 ID —
 #   store_prepare/store_submit을 쓰면 필수(비어 있으면 Fastfile이 명확한 오류로 중단)
 #
-# 📝 환경 설정 (선택):
+# 환경 설정 (선택):
 # ENV_FILE (선택): .env 파일 내용
 # SECRETS_XCCONFIG (선택): ios/Flutter/Secrets.xcconfig 내용
 #
-# ===================================================================
-# 🛠️ 초기 설정 방법
-# ===================================================================
+# 초기 설정 방법
 #
 # 1. GitHub Secrets 설정 (위 목록 참고)
 #
@@ -46,8 +40,6 @@
 #    git commit -m "chore: iOS TestFlight 배포 설정"
 #
 # 3. {{MAIN_BRANCH}} 브랜치로 푸시하여 배포 시작
-#
-# ===================================================================
 
 name: PROJECT-iOS-TestFlight-Deploy
 
@@ -67,9 +59,7 @@ on:
           - store_prepare
           - store_submit
 
-# ============================================
-# 🔧 프로젝트별 설정 (아래 값들을 수정하세요)
-# ============================================
+# 프로젝트별 설정 (아래 값들을 수정하세요)
 env:
   FLUTTER_PROJECT_DIR: "."  # @wizard auto:flutter-root
   # 환경변수 전달 방식 (dart-define | dotenv) — 설치 시 선택값으로 자동 설정
@@ -78,20 +68,14 @@ env:
   XCODE_VERSION: "26.0"
   PROJECT_TYPE: "flutter"
 
-  # ============================================
-  # 📝 환경 파일 설정
-  # ============================================
+  # 환경 파일 설정
   # dotenv 모드에서 .env 파일을 만들 경로 (Flutter 루트 기준)
   ENV_FILE_PATH: ".env"
 
-  # ============================================
-  # 📝 TestFlight Changelog 설정
-  # ============================================
+  # TestFlight Changelog 설정
   SKIP_WAITING_FOR_BUILD_PROCESSING: "false"
 
-  # ============================================
-  # 📝 배포 모드 (store_only | store_prepare | store_submit)
-  # ============================================
+  # 배포 모드 (store_only | store_prepare | store_submit)
   DEPLOY_MODE: ${{ github.event.inputs.deploy_mode || vars.IOS_DEPLOY_MODE || 'store_only' }}  # @wizard fallback:ios-deploy-mode
 
 jobs:
@@ -230,9 +214,7 @@ jobs:
           retention-days: 1
           if-no-files-found: error
 
-  # ============================================
   # iOS 빌드 (xcodebuild 직접 사용)
-  # ============================================
   build-ios:
     name: iOS 앱 빌드
     runs-on: macos-26
@@ -392,9 +374,7 @@ jobs:
           retention-days: 1
           if-no-files-found: error
 
-  # ============================================
   # TestFlight 배포 (ios/fastlane/Fastfile 사용)
-  # ============================================
   deploy-testflight:
     name: TestFlight 배포
     runs-on: macos-26

package/payload/workflows/go/PROJECT-GO-CI.yaml

@@ -1,20 +1,11 @@
 # project-auto-wizard:managed-workflow
-# ===================================================================
 # Go 빌드 검증 워크플로우 (CI Only)
-# ===================================================================
-#
-# 설명:
 # - {{DEVELOP_BRANCH}} 브랜치에 push/PR 시 go build/vet/test/lint로 검증
 # - Dockerfile이 필요 없어 CLI 도구·라이브러리 등 배포하지 않는 Go 프로젝트도 사용 가능
 # - go.mod의 go 지시자 버전을 자동으로 사용 (버전 하드코딩 없음)
-#
-# ===================================================================
 
 name: PROJECT-GO-CI
 
-# ===================================================================
-# 트리거 설정
-# ===================================================================
 on:
   push:
     branches:
@@ -24,9 +15,6 @@ on:
       - "{{DEVELOP_BRANCH}}"  # {{DEVELOP_BRANCH}} 브랜치로의 PR 시 빌드 검증
   workflow_dispatch:  # 수동 실행 허용
 
-# ===================================================================
-# 환경 변수 설정
-# ===================================================================
 env:
   # 프로젝트 고유 식별자
   PROJECT_NAME: "__PROJECT_NAME__"  # @wizard ask:@repo
@@ -34,9 +22,7 @@ env:
   PROJECT_PATH: "."  # @wizard auto:project-path
 
 jobs:
-  # ===================================================================
   # 변경 감지 (모노레포에서 이 프로젝트 경로가 바뀌었는지 판별)
-  # ===================================================================
   changes:
     name: 변경 감지
     runs-on: ubuntu-latest
@@ -58,9 +44,7 @@ jobs:
             project:
               - '${{ env.PROJECT_PATH == '.' && '**' || format('{0}/**', env.PROJECT_PATH) }}'
 
-  # ===================================================================
-  # 빌드 검증 작업
-  # ===================================================================
+  # Job: 빌드 검증
   build-check:
     name: Go 빌드 검증
     runs-on: ubuntu-latest
@@ -68,37 +52,32 @@ jobs:
     if: ${{ github.event_name == 'workflow_dispatch' || needs.changes.outputs.project == 'true' }}
 
     steps:
-      # 1. 소스코드 체크아웃
       - name: 코드 체크아웃
         uses: actions/checkout@v7
 
-      # 2. Go 툴체인 설정 (go.mod의 go 지시자 버전 자동 사용)
+      # go.mod의 go 지시자 버전 자동 사용
       - name: Go 설정
         uses: actions/setup-go@v7
         with:
           go-version-file: go.mod
           cache: true
 
-      # 3. 빌드 검증
       - name: go build 검증
         run: go build ./...
 
-      # 4. 정적 분석
       - name: go vet 검증
         run: go vet ./...
 
-      # 5. 테스트 실행
       - name: go test 실행
         run: go test ./...
 
-      # 6. 린트 (v8은 golangci-lint v2 계열을 요구 — .golangci.yml이 v1 형식이면
-      #    프로젝트에서 별도 조정 필요. version: latest는 v2 최신 패치를 자동으로 받는다)
+      # golangci-lint v8은 golangci-lint v2 계열을 요구 — .golangci.yml이 v1 형식이면
+      # 프로젝트에서 별도 조정 필요. version: latest는 v2 최신 패치를 자동으로 받는다
       - name: golangci-lint
         uses: golangci/golangci-lint-action@v8
         with:
           version: latest
 
-      # 7. 빌드 검증 완료 메시지
       - name: 빌드 검증 완료
         run: |
           echo "✅ Go 빌드 검증이 성공적으로 완료되었습니다!"
@@ -109,9 +88,7 @@ jobs:
           echo "  📝 커밋: ${{ github.sha }}"
           echo "  ⏰ 검증 시간: $(date '+%Y-%m-%d %H:%M:%S')"
 
-  # ===================================================================
-  # CI Gate (required check로 등록할 단일 job)
-  # ===================================================================
+  # Job: CI Gate (required check로 등록할 단일 job)
   ci-gate:
     name: CI Gate
     if: ${{ always() }}