[클로드 코드 완독 챌린지] - 3주차 : 부트스트래핑 - 프로젝트 초기 구성 자동화

프로젝트를 설계하고 계획을 세운 뒤, 실제 개발에 들어가기 전에 필요한 과정이 있다. 바로 초기 구성을 빠르게 준비하는 일이다.

디렉터리 구조, 설정 파일, 환경 변수, 기본 보일러 플레이트 코드 등을 미리 갖추면 핵심 기능 구현에 집중할 수 있다.

---

프로젝트 템플릿 생성

커스텀 보일러플레이트 생성

서비스를 기반으로 보일러플레이트를 만들어 보자. 앞서 설계한 요소들을 그대로 초기 템플릿에 담으면, 새 프로젝트를 시작할 때 즉시 활용할 수 있다.

먼저 CLAUDE.md 부터 만든다.

> /init
> 지금 문서를 기반으로 프로젝트 템플릿을 생성해줘

여기서 생성된 보일러플레이트는 단순한 뼈대가 아니라, 앞서 설계 단계에서 고민했던 결정들을 구체화한 결과물이다.

---

의존성 관리

패키지 버전 최적화

같은 패키지가 여러 버전으로 섞여 있으면 보안 취약점이 그대로 남거나 런타임에서 예상치 못한 충돌이 발생할 수 있다. 따라서 패키지 버전을 통일하면 보안,성능,안정성,관리 효율성을 모두 높일 수 있다.

> package.json 의 의존성을 분석하고 다음 작업을 수행해줘.
1. 보안 취약점 확인
2. 최신 안정 버전으로 업데이트 가능한 패키지 목록
3. 버전 충돌 가능성 확인
4. 불필요한 의존성 제거

모노레포 의존성 관리

> pnpm workspace를 사용한 monorepo 의존성을 설정해줘
- 공통 의존성은 루트에 설치
- 패키지 간 의존성 연결
- 타입스크립트 프로젝트 래퍼런스 설정

---

개발 환경 구성

바이브 코딩에서 IDE 설정에 신경을 안 쓰는 건 모순되는 일이다. 개발 환경을 잘 관리하고 유지하는 건 일반적인 소프트웨어 엔지니어링 활동에 포함되어 있고 팀 차원에서도 관심이 필요한 사항이다.

VS Code 설정

> VS Code 설정 파일을 생성해줘
- 추천 익스텐션 목록
- 디버깅 설정
- 태스크 러너
- 코드 스니펫

깃 훅 설정

깃 훅을 자동으로 구성하여 코드 품질을 보장한다.

> Git hooks 를 설정해줘
- pre-commit : 린트와 포맷팅 체크
- commit-msg : 커밋 메시지 규칙 검증
- pre-push : 테스트 실행

---

컨테이너 환경 구성

개발용 도커 설정

클로드 코드는 완전한 컨테이너 기반 개발 환경을 자동으로 생성한다. 핫 리로드, 데이터베이스 연동, 볼륨 마운트, 네트워크 설정 등 로컬 개발에 필요한 모든 도구 구성을 한 번에 만들어 낸다.

> 개발용 Docker 환경을 구성해줘
- Hot reload 지원
- 데이터베이스 연동
- 볼륨 마운트 설정
- 네크워크 설정

쿠버네티스 매니페스트

로컬 쿠버네티스 환경에서 테스트할 수 있는 설정 파일도 생성할 수 있다.

> 로컬 테스트용으로 k8s manifest 를 작성해줘

---

테스트 환경 부트스트래핑

> 테스트 환경을 설정해줘
  - 테스트 커버리지 설정
  - Jest 설정(unit test)
  - React Testing Library(component test)
  - Playwright(E2E test)

---

부트스트래핑

복잡한 풀스택 애플리케이션의 전체 구조를 한 번에 생성하고, 모든 구성 요소를 자동으로 구축한다.

> 현재까지 구상된 문서 및 설계를 바탕으로 MVP 를 구현해줘
  docker-compose 를 통해 실행 가능한 형태로, 구현 내용은 playwright 를 통해 검증해줘