벽촌

벽촌 FE 공통 모듈 · 사내 CLI

팀이 새 프로젝트를 만들 때 쓰는 사내 CLI와 서비스들이 함께 쓰는 공통 패키지를 관리했습니다. 기능을 붙여 보고, 실제로 쓰지 않는 것은 걷어내 어긋날 틈을 막았습니다.

기간
2025.09 – 현재
역할
CLI 확장과 v3 정리 · 버전 검사 · 공통 패키지 QA
기술
Node CLI, pnpm 모노레포, changesets, Vercel AI SDK, ink, GitHub Actions

숫자로 보면

CLI v3 정리
−5,923줄의존성 9개 제거
공통 패키지 QA
14건MOD-21~35 (결함 수정 12건)
PR 자동화
3종컨벤션 댓글 · 본문 · 빌드 체크
npm 배포
v3.0.0changesets

문제

  • CLI는 프로젝트를 만든 뒤에는 할 일이 없어, Figma · Swagger · 컨벤션 문서를 매번 따로 열어 AI에 설명했습니다.
  • PR마다 같은 컨벤션 지적을 사람이 반복했고, ESLint · tsconfig 사본이 프로젝트마다 달라졌습니다.
  • 시간이 지나자 init마다 묻는 질문과 채팅 기능은 쓰이지 않았고, 오래된 설치본으로 만든 프로젝트는 템플릿이 어긋났습니다.
  • 공통 패키지는 사용처에서 버그가 하나씩 보고되고 있었습니다.

한 일

문맥 등록
bc.config.json에 Figma · API · 문서를 등록해 AI가 프로젝트를 알고 작업하게 했습니다 (v1.4 → v2.0).
PR 봇
변경 줄에 컨벤션 위반을 인라인 댓글로 달고, 커밋에서 PR 본문을 자동으로 씁니다. 설정은 settings 패키지 한 곳에서 관리합니다.
v3 정리
쓰지 않는 채팅과 생성 질문을 걷어내 의존성 9개, 5,923줄을 지웠습니다.
버전 검사
npm 최신보다 patch 하나라도 뒤처지면 업데이트 안내 후 멈춰, 어긋난 프로젝트가 생기지 않게 했습니다.
스타터 확장
Next · React에 더해 React Native(Expo)와 Electron, HTTP 에러 처리와 Sentry, 라이트 · 다크 테마를 기본으로 갖추게 했습니다.
공통 패키지 QA
1월 31일에서 다음 달로 가면 3월이 되던 달력, KST에서 달이 밀리던 문제, SSR에서 SanitizeHtml 크래시, 이메일 · 생년월일 · 주민번호 정규식 오류를 고쳐 changeset으로 배포했습니다.

결과

  • 모든 프로젝트가 같은 버전의 CLI로 생성되고, 규칙이 바뀌면 settings 버전만 올리면 됩니다.
  • 사람 리뷰는 기계적인 지적 대신 설계에 집중합니다.

배운 것

  • Release CI에서 npm 11로 만든 lockfile이 Node 20의 npm ci에서 실패했습니다. npm 10으로 다시 만들어 두 버전 모두 통과시켰습니다.
  • 도구를 늘리기보다, 팀이 실제로 쓰는 것만 남기고 어긋날 틈을 막는 쪽을 택했습니다.

발표 자료

스터디와 회고에서 발표한 자료 일부입니다.

CLI v3 정리와 공통 패키지 QA
스타터에서 워크벤치로: AI 툴 11개, PR 자동화 3종
프로젝트 문맥을 아는 AI 작업 흐름
컨벤션 리뷰 봇과 PR 본문 자동 작성