개발자가 30일 단독 빌드에 Linear와 Discord에서 Claude Code를 활용한 방법

프로젝트와 기술 스택

한 개발자가 경쟁 포켓몬(VGC)을 위한 팀 리포트 빌더인 VGC Team Report(pokemonvgcteamreport.com)를 만들었습니다. 이 도구는 매치업 계획, 데미지 계산, 스피드 티어, 공유 가능한 리포트를 포함한 상세 분석을 생성합니다. 이 프로젝트는 저녁과 주말을 활용한 30일 동안 274개의 커밋, 약 42,000줄의 TypeScript 코드, Linear를 통해 배포된 25개의 기능, 66개의 React 컴포넌트, 41개의 API 라우트, 22개의 커스텀 훅으로 구축되었습니다. 기술 스택에는 Next.js 16(App Router), React 19, TypeScript(엄격 모드), Tailwind CSS v4, 인증을 위한 Clerk, 서버리스 Postgres를 위한 Neon, 호스팅과 배포를 위한 Vercel이 포함되었습니다.

워크플로우: Linear → Claude → Discord → Vercel

개발자는 Claude Code를 Linear 티켓 추적과 Discord 빌드 알림에 연결하여 자동화된 개발 파이프라인을 구축했습니다. 일반적인 세션은 다음과 같은 순서로 진행되었습니다:

1. Claude가 linear_get_in_progress를 실행하여 Linear 보드에서 티켓 확인
2. 가장 높은 우선순위 티켓 선택(버그 우선)
3. 관련 파일을 읽고 기능 또는 수정 사항 구현
4. tsc --noEmit && npm run build 실행 — 실패 시 Claude가 오류 수정
5. 티켓 ID 형식으로 커밋: VGC-42: Add speed tier chart
6. 메인 브랜치에 푸시
7. GraphQL을 통해 Linear 티켓에 커밋 URL과 변경된 파일 목록으로 댓글 작성
8. 티켓을 '검토 중' 상태로 이동
9. discord_notify_build 호출 — Discord #builds 채널에 커밋, 변경된 파일 목록, 배포 상태가 포함된 임베드 게시
10. Vercel이 메인 브랜치에서 자동 배포
11. 다음 티켓으로 이동

이는 Claude가 직접 호출하는 함수를 포함한 linear.sh bash 스크립트를 통해 구현되었습니다: linear_get_in_progress(Linear GraphQL을 쿼리하여 진행 중인 티켓 조회), linear_move_issue(티켓을 새 상태로 이동), linear_comment_with_changes(커밋 링크와 변경된 파일 목록으로 댓글 작성), discord_notify_build(커밋 정보와 배포 상태가 포함된 Discord 임베드 전송).

CLAUDE.md 운영 매뉴얼

저장소 루트에 위치한 CLAUDE.md 파일은 모든 Claude 세션에 대한 컨텍스트를 제공합니다. 주요 섹션은 다음과 같습니다:

• Git 전략: 트렁크 기반 개발로 일상 작업은 메인 브랜치에 직접 푸시, 대규모 또는 위험한 변경 사항에만 기능 브랜치 사용, 모든 푸시 전 npx tsc --noEmit && npm run build 실행은 필수 조건
• Linear 워크플로우: '진행 중'과 '검토 중' 상태의 정확한 ID, 티켓 쿼리 및 구현 방법, VGC-XX 접두사로 커밋, 커밋 댓글 작성, 티켓 상태 이동, 버그 티켓은 항상 우선 처리
• Discord 알림: discord_notify_build 함수 형식으로 메인 브랜치 직접 푸시와 PR 흐름에 따라 다른 임베드 사용
• 실패 처리: 빌드 실패 → 수정 후 재시도, 절대 깨진 코드 푸시 금지; Linear API 실패 → 여전히 커밋 및 푸시, 사용자에게 실패 사항 기록; 프로덕션 중단 → git revert 실행, 메인 브랜치에 푸시, Discord 알림, 티켓 원상 복구
• 코딩 규칙: 기존 패턴 따르기, 무분별한 리팩토링 금지, 커밋 메시지: 추적 작업에 대해 VGC-XX: description 형식

자동화된 모니터링

두 개의 Vercel cron 작업이 설정되었습니다: 오전 9시에 실행되는 일일 점검으로 사이트 상태, 오래된 티켓 스캔, SEO 감사, 데이터베이스 상태 확인(문제 발생 시에만 Discord에 경고 게시), 그리고 금요일 오후 5시에 실행되는 주간 요약으로 Linear 진행 상황, 사용자 증가, 의존성 업데이트 보고(항상 Discord에 요약 게시). 실시간 가동 시간 모니터링에는 5분 간격으로 핑을 보내는 UptimeRobot이 사용되었습니다.

효과적인 부분

개발자는 몇 가지 효과적인 관행을 강조했습니다: 타입 체킹 게이트(tsc --noEmit && npm run build)가 포함된 트렁크 기반 개발로 모든 메인 브랜치 푸시가 Vercel에서 자동 배포되며 몇 분 안에 피드백 루프 완성; 모든 커밋이 티켓에 연결되고 모든 티켓에 커밋 URL과 변경된 파일 목록이 포함된 댓글이 있는 Linear 티켓 추적성; 모든 빌드가 #builds 채널에 게시되는 Discord 감사 추적; 그리고 세션 간 일관된 컨텍스트 유지를 위한 가장 가치 있는 프로젝트 구성 요소인 CLAUDE.md 파일.