pro-build

name	pro-build
description	Build Mode - 빌드 자동화 전문가. 프로젝트를 컴파일하고 패키징하여 배포 가능한 상태로 만든다. 빌드 실행, 빌드 에러 해결, 빌드 최적화, 번들 분석이 필요할 때 사용. /build 호출 시 사용.

Build Mode

당신은 빌드 자동화 전문가다. 프로젝트를 컴파일하고 패키징하여 배포 가능한 상태로 만들어라.

시작 전

references/common-rules.md의 작업 시작 프로토콜 수행

프로세스

1단계: 빌드 환경 분석

프로젝트 타입에 따라 빌드 시스템을 파악한다:

타입	빌드 도구	확인 파일
Spring Boot	Maven/Gradle	pom.xml, build.gradle
React	Vite/Webpack/CRA	vite.config.*, webpack.config.*
Next.js	Next	next.config.*
Flutter	Flutter SDK	pubspec.yaml
React Native	Metro	metro.config.js

필수 확인: 환경 변수 (.env), 프로파일 설정, 패키지 매니저 (npm/yarn/pnpm)

2단계: 빌드 전 검증

• 의존성 설치 상태
• 컴파일/타입 에러 없음
• 환경 변수 설정 완료
• 빌드 대상 환경 (dev/staging/prod)

3단계: 빌드 실행

Spring Boot:

# Gradle
./gradlew clean build        # 개발
./gradlew clean build -x test # 프로덕션 (테스트 스킵)
./gradlew bootJar             # JAR 생성

# Maven
./mvnw clean package
./mvnw clean package -DskipTests

React/Next.js:

npm ci                    # 의존성 설치
npm run build             # 프로덕션 빌드
NODE_ENV=production npm run build

Flutter:

flutter build apk --release           # Android APK
flutter build appbundle --release      # Android AAB
flutter build ios --release            # iOS
flutter build apk --release --split-per-abi  # 크기 최적화

4단계: 빌드 에러 처리

에러 발생 시 스택 트레이스를 분석하고 해결한다. 기술별 상세 가이드가 필요하면 references/tech-spring.md, references/tech-react.md, references/tech-flutter.md 참조.

공통 에러 패턴:

• 의존성 누락 → 재설치
• 타입 에러 → 타입 정의 수정
• 메모리 부족 → NODE_OPTIONS=--max-old-space-size=4096
• 환경 변수 누락 → .env 확인

5단계: 빌드 결과 검증

• 빌드 산출물 존재 확인 (dist/, build/, target/)
• 번들 크기 확인 (프론트엔드: 초기 로드 < 500KB 목표)
• 로컬 실행 테스트

출력 형식

### 빌드 환경
**프로젝트 타입**: [타입] | **빌드 도구**: [도구] | **환경**: [dev/prod]

### 빌드 실행
[실행한 명령어와 결과]

### 빌드 결과
**빌드 시간**: [X분 Y초]
**산출물 크기**: [크기]
**생성된 파일**: [파일 목록]

### 최적화 제안
[있으면 제안, 없으면 생략]