/backlog [티켓번호] — 빌드킷 기존 티켓 실습

"빌드킷 기존 티켓"이 뭐예요?

Ch.3 PLAN 단계에서 본인 서비스의 기능 명세 + 와이어프레임 + 빌드 단계가 자동 분해됐어요. 그 빌드 단계 하나하나가 티켓으로 보드에 들어가 있어요. 보통 다음 같은 것들:

• "회원가입·로그인 기본 흐름" (FLO-001 같은 코드)
• "핵심 기능 ① 데이터 입력 + 저장"
• "핵심 기능 ② 목록 조회"
• "핵심 기능 ③ 상세 페이지"
• "마이페이지 + 내 데이터 관리"
• ... (본인 서비스에 따라 5~15개)

이 티켓들은 빌드킷이 미리 다 깔아 둔 시공 순서예요. 본인은 그냥 한 줄 명령으로 하나씩 실행만 해 주면 돼요. 4-7에서 새 티켓을 직접 만드는 법을 배우지만, 일단은 미리 깔린 길부터 걸어요. 가장 막힘이 적은 단계예요.

2개 환경 동시 사용 — 옆 탭 띄우기

이 lesson은 두 환경을 동시에 보면서 진행해요.

• 왼쪽: Antigravity (Claude Code 채팅 + 코드 변경 + 터미널)
• 오른쪽: 브라우저 새 탭 → vuild.kr/projects/{본인ID}/build/board

화면이 작으면 모니터 한 대를 좌우 분할(Mac: 창 좌상단 녹색 버튼 길게 → "왼쪽 화면 타일링" / Win: Win + 화살표)로 두 창을 50:50으로 띄워요.

단계 1 — 보드에서 첫 티켓 ID 확인

Claude Code에서 /dashboard를 다시 한 번 호출해서 backlog의 첫 번째 티켓 ID를 봐요. 보통 FLO-001처럼 영문-숫자 형식이에요. 또는 vuild.kr 보드에서 첫 카드 클릭 → 우상단 ID 확인.

단계 2 — /backlog 호출

Claude Code 채팅에 다음 한 줄.

/backlog FLO-001

티켓 ID 모르면 그냥 /backlog만 입력 → Claude가 backlog 목록을 보여 주고 어떤 걸 진행할지 물어봐요.

엔터 누르면 다음 흐름이 자동 진행:

1. 티켓 정보 가져옴 (제목·설명·우선순위)
2. 팀리드(메인 Claude)가 작업 단위로 분해 → 서브 티켓 생성
3. 각 서브 티켓을 알맞은 에이전트(개발자·디자이너·리뷰어)에게 위임
4. 개발자 에이전트가 TDD로 구현 (테스트 → 코드 → bin/ci 통과)
5. 리뷰어 에이전트가 디자인·접근성·테스트 검토
6. 완료 시 티켓 상태가 review로 변경
7. 본인에게 "검토 부탁" 메시지

단계 3 — 진행 상황 옆 탭으로 보기

오른쪽 vuild.kr 보드를 보세요. 카드가 backlog → in_progress 컬럼으로 이동하고, 카드 안의 진행률 바가 채워지는 걸 실시간으로 볼 수 있어요. 에이전트가 각 단계에서 남기는 활동 로그도 보드 카드 클릭 → 우측 활동 영역에서 봐요.

단계 4 — 중간 질문이 뜨면 답하기

에이전트가 작업 중에 본인에게 결정을 부탁할 수 있어요. 자주 묻는 것 + 추천 답:

단계 5 — review 상태 결과 검토

에이전트가 끝나면 review 상태로 넘어가고 본인에게 메시지가 와요. 이때 본인이 직접 검토:

1. 변경된 파일 확인: git status로 어떤 파일이 변경됐는지.
2. 코드 차이 보기: git diff (또는 Antigravity 좌측 git 패널). 큰 의미는 못 읽어도 OK. 본인이 알아볼 만한 부분(파일명, 함수명)만 훑어요.
3. 테스트 통과 확인: bin/rails test 또는 에이전트가 이미 실행해 둔 결과 메시지.
4. 화면 동작 확인: 4-9에서 배울 bin/dev로 서버 띄워서 실제 페이지 열기. 일단 이번 lesson에서는 코드만 검토해도 OK.
5. 문제 없으면: /review 호출하거나 직접 보드에서 카드 → "완료" 버튼.
6. 문제 있으면: Claude Code에 "이 부분 다시 해 줘" + 어떤 부분이 어떻게 잘못됐는지 한 줄 설명.

단계 6 — done 처리 + 다음 티켓 준비

검토 OK면 다음 한 줄.

/review

Claude가 review 티켓들을 둘러본 뒤 본인에게 "이 티켓 done 처리 OK?" 확인. y면 done 처리 + 보드 업데이트.

그 다음 git commit으로 의미 있는 단위 세이브.

git add .
git commit -m "FLO-001 회원가입 기본 흐름 완료"

다음 티켓도 같은 패턴

한 티켓이 끝나면 같은 사이클을 반복:

1. /dashboard → 다음 backlog 확인
2. /backlog FLO-002 → 실행
3. 중간 질문 답
4. review → 검토 → done
5. git commit
6. 반복

보통 한 티켓은 10~30분이에요. 빌드킷의 모든 티켓을 끝내려면 평균 2~5일 걸려요.

자주 발생하는 문제 + 해결

자가 진단 — 통과 기준

• ☐ 빌드킷 backlog의 티켓 1개를 /backlog [ID]로 실행해서 review 상태까지 도달했다
• ☐ vuild.kr 보드에서 카드가 in_progress → review로 이동하는 걸 봤다
• ☐ 검토 후 done 처리했다 (또는 "다시 해줘"로 재요청 후 다시 검토)
• ☐ git commit 한 줄로 의미 있는 세이브 포인트를 남겼다
• ☐ 같은 사이클을 다음 티켓에도 자력으로 반복할 자신이 있다