jay.log

AI 워크플로 기반 팀 프로세스와 컨벤션

라이프오아시스 • 2026.07 - 재직 중

제품마다 프론트엔드가 한 명이라 아키텍처와 컨벤션 해석이 사람마다 달랐고, 코딩 에이전트는 팀 규약을 모른 채 틀렸을 때도 "완료"라고 보고했습니다. 검증한 워크플로(계획 → 구현 → 앱 실행 화면 증거 → 다관점 리뷰)를 팀 작업 프로세스로 정리하고, 프론트엔드 4명이 6주간 정기 회의와 GitHub 논의로 합의한 컨벤션을 워크플로 각 단계에서 불러 쓰는 스킬로 만들었습니다. 필요한 스킬은 훅이 자동으로 불러오고, 리뷰는 5개 관점의 리뷰 에이전트가 같은 컨벤션으로 봅니다. 검사는 단계별로 나눴습니다. 파일을 고칠 때마다 훅이 any 사용을 막고, 작업 중에는 마음 앱의 AST 셀렉터 기반 커스텀 린트를 검증 명령으로 돌리고, 커밋 직전에는 타입체크가 실패하면 커밋을 막습니다. 이 게이트를 쓰려고 깨져 있던 타입체크를 any·as·!·@ts-ignore 없이 정상화하고 TS 7 네이티브 컴파일러를 도입했습니다. 기계가 잡을 수 있는 오류는 에이전트가 리뷰 전에 스스로 고쳐서, 사람은 결과를 한 줄씩 다시 보는 대신 설계 판단을 리뷰합니다.

주요 지표

6주
합의 기간
7.4s → 1.2s
타입체크

도전 과제

  • 사람마다 다른 아키텍처·컨벤션 해석
  • 팀 규약을 모르는 코딩 에이전트
  • 사람마다 다른 AI 활용 수준

해결 방안

  • 워크플로를 팀 프로세스로 정리, 컨벤션을 스킬로 제작
  • 훅으로 스킬 자동 로딩, 5개 관점 리뷰 에이전트
  • 파일 수정 시 any 차단 → 커스텀 린트 → 커밋 전 타입체크
  • 타입체크 정상화와 TS 7 도입

결과

  • 팀원 4명이 같은 플러그인과 워크플로로 작업
  • 모든 PR이 같은 컨벤션으로 1차 리뷰
  • 사람은 설계 판단 리뷰에 집중

기술 스택

Claude CodeTypeScriptESLint

© jay.log powered by Next.js, Vercel