바이브코딩 너머: GitHub PR 로 백엔드엑스 앱에 요구사항 전달하기

바이브코딩만으로도 충분하지만, 코어 개발자라면 GitHub PR 로 변경을 보여 줄 수도 있어요. 백엔드엑스가 PR 을 요구사항으로 읽고 앱을 업데이트하는 방법을 알아봐요.

바이브코딩 너머: GitHub PR 로 백엔드엑스 앱에 요구사항 전달하기

백엔드엑스의 많은 기능은 바이브코딩 방식으로 동작하지만, 코어 개발자를 위한 기능들도 숨어 있어요. 그 중에 이번에는 GitHub 의 PR(pull request) 기능을 이용해서 프로젝트에 요구사항을 전달하는 방법을 알아볼게요.

백엔드엑스에서는 백엔드엑스 채팅창에 "이렇게 바꿔 주세요"라고 말로 적기만 하면 앱이 업데이트돼요. 바이브코더라면 그걸로 충분해요. 그런데 코드를 직접 읽는 개발자라면, 말로 길게 설명하는 것보다 "이 함수의 이 줄을 이렇게"라고 코드로 보여 주는 편이 훨씬 빠를 때가 있죠. 이 글은 그런 고급 사용자를 위한 기능을 소개해요.

⚠️
먼저 알아 둘 점 — 보내 주신 코드는 프로젝트에 그대로 합쳐지지 않아요. 백엔드엑스는 PR 을 "이렇게 동작하게 해 달라"는 요구사항으로 읽고, 무엇이 바뀌는지 말로 다시 정리해 확인받은 다음, 그 요구사항대로 앱을 다시 만들어요. 그래서 결과 코드는 PR 의 코드와 다를 수 있어요.

왜 코드를 그대로 합치지 않을까요?

백엔드엑스가 만드는 앱은 요구사항 문서(SRS)와 API 문서에서 출발해요. 코드, 테스트, 배포가 모두 이 문서들을 따라가죠. 코드만 몰래 바꾸면 다음 업데이트 때 문서와 코드가 어긋나고, 테스트도 바뀐 동작을 모르는 채로 남아요.

그래서 PR 의 변경을 문서에 먼저 반영하고, 문서에서 코드와 테스트를 다시 만들어요. 이렇게 하면 요청하신 동작이 다음 업데이트에서도 사라지지 않고, 테스트로 검증도 돼요.

준비: 프로젝트 GitHub 저장소에 참여하기

백엔드엑스는 Builder 이상 플랜의 프로젝트마다 소스 코드를 담은 비공개 GitHub 저장소를 제공해요. 이 저장소는 백엔드엑스가 관리하고, 참여한 구성원은 읽기 권한으로 코드를 볼 수 있어요.

소스 코드 탭의 GitHub 저장소 바로가기 버튼
오른쪽 패널의 소스 코드 탭과 GitHub 저장소 바로가기 버튼
  1. 프로젝트 화면 오른쪽 패널에서 소스 코드 탭을 열어요.
  2. GitHub 저장소 바로가기 버튼을 눌러요. GitHub 계정이 아직 연결되어 있지 않다면 GitHub 연결하기로 먼저 연결해요. (설정 → 계정에서도 연결할 수 있어요.)
GitHub 계정 연결 안내 창
GitHub 계정이 연결되어 있지 않으면 먼저 GitHub 연결하기를 눌러요
  1. 처음 참여할 때는 BackendX GitHub 저장소 제공 정책 부속합의서를 확인하고 동의하고 참여하기를 눌러요.
GitHub 저장소 제공 부속합의서 동의 창
부속합의서에 동의하고 동의하고 참여하기를 눌러요
  1. "준비됐어요"라는 안내가 보이면 버튼을 한 번 더 눌러요. GitHub 가 새 탭에서 열리고, 저장소 초대를 수락하면 참여가 끝나요. 초대는 7일 동안 유효해요.
참여 준비 완료 안내
버튼을 한 번 더 누르면 GitHub 가 새 탭에서 열려요

프로젝트 소유자와 관리자·편집자처럼 소스 코드를 받을 수 있는 구성원이라면 누구나 자기 GitHub 계정으로 직접 참여할 수 있어요.

💡
GitHub 저장소 바로가기 버튼이 안 보이나요? GitHub 저장소는 Builder 이상 플랜에서 제공돼요. 무료 플랜 프로젝트라면 소스 코드 탭에 Builder부터 표시와 플랜 업그레이드 버튼만 보여요. 플랜을 올리면 바로 참여할 수 있어요. 그 밖에도 이런 경우에는 참여할 수 없어요: 앱이 아직 한 번도 완성되지 않아 소스 코드가 없을 때, 그리고 내 역할이 소스 코드를 받을 수 없는 역할(보기 전용 등)일 때예요. 역할 때문이라면 프로젝트 소유자에게 관리자나 편집자 역할을 요청해 주세요.
무료 플랜 프로젝트의 소스 코드 탭
무료 플랜에서는 Builder부터 표시와 플랜 업그레이드 버튼이 보여요

PR 만들기

저장소는 읽기 전용이라 직접 push 할 수는 없어요. 대신 GitHub 의 fork 를 이용해요.

GitHub 저장소의 Fork 버튼
프로젝트 저장소 오른쪽 위의 Fork 버튼
  1. 프로젝트 저장소 페이지에서 Fork 를 눌러 내 계정으로 복사해요.
  2. fork 한 저장소를 clone 하고, 새 브랜치에서 원하는 변경을 커밋한 뒤 push 해요.
  3. GitHub 에서 프로젝트 저장소의 main 을 대상으로 PR 을 열어요. 제목과 설명에 "무엇을 왜 바꾸는지" 적어 두면 더 정확하게 반영돼요.
git clone https://github.com/<내 계정>/<저장소>.git
cd <저장소>
git checkout -b reject-future-run-date
# 코드 수정
git commit -am "미래 날짜의 기록은 거절"
git push -u origin reject-future-run-date
프로젝트 저장소의 main 을 대상으로 연 PR
대상이 프로젝트 저장소의 main 인지 확인해요

백엔드엑스 채팅창에 PR 링크 붙여 넣기

이제 백엔드엑스 프로젝트 화면으로 돌아와, 백엔드엑스 채팅창에 PR 링크(https://github.com/.../pull/번호)를 붙여 넣어요. 말로 하는 요청과 함께 적어도 돼요.

PR 내용을 정리해 보여 주는 백엔드엑스 채팅창
백엔드엑스가 PR 을 읽고 바뀌는 동작을 정리한 뒤, 정할 것이 있으면 물어봐요
⏳
오래전에 만든 프로젝트라면 처음 PR 을 보낼 때 "코드에 대한 정보를 모으고 있어요"라는 답이 올 수 있어요. 보통 몇 분이면 끝나니, 잠시 뒤 PR 링크를 다시 보내 주세요.
  1. 백엔드엑스가 PR 의 변경 내용을 읽고, 어떤 API 의 어떤 동작이 바뀌는지 정리해 보여 줘요.
  2. 정리된 내용이 의도와 맞는지 확인해 주세요. 다르면 채팅으로 바로잡으면 돼요.
  3. 확인이 끝나면 평소 업데이트처럼 앱이 다시 만들어지고, 테스트를 통과한 결과가 저장소의 main 에 올라가요.
  4. 그 뒤 백엔드엑스 봇이 PR 에 "요청이 업데이트에 반영되었다"는 댓글을 남기고 PR 을 닫아요. 댓글은 프로젝트 언어로 남겨요.
업데이트 반영 후 백엔드엑스 봇이 남긴 댓글과 닫힌 PR
업데이트가 main 에 올라가면 봇이 댓글을 남기고 PR 을 닫아요
💡
PR 은 닫혀도 저장소의 PR 목록에 그대로 남아요. 무엇을 요청했고 어떻게 반영됐는지 나중에 다시 볼 수 있어요. 비용은 다른 업데이트와 똑같이 계산돼요.

이런 PR 은 읽을 수 없어요

아래 경우에는 백엔드엑스가 이유를 알려 드리고, 대신 변경 내용(diff)을 채팅에 붙여 넣어 달라고 안내해요. diff 파일을 첨부해도 돼요.

  • 다른 저장소의 PR — 이 프로젝트 저장소를 대상으로 한 PR 만 읽어요.
  • 다른 사람이 연 PR — 저장소에 참여할 때 쓴 내 GitHub 계정으로 연 PR 이어야 해요.
  • 닫혔거나 이미 머지된 PR — 열려 있는 PR 만 읽어요.
  • 너무 큰 PR — 변경 내용이 512KB 를 넘으면 중요한 부분만 따로 보내 주세요.
  • 아직 한 번도 만들어지지 않은 앱 — PR 은 이미 완성된 앱을 업데이트할 때 쓸 수 있어요.

그대로 반영할 수 없는 코드도 있어요

백엔드엑스가 직접 관리하는 부분은 요청으로 바꿀 수 없어요. 로그인, 결제, 이메일, 저장소 같은 기본 제공 기능과 데이터베이스 migration 파일이 그래요. 이런 부분을 고친 PR 이라면, 백엔드엑스가 그 사실을 알려 드리고 내 기능 안에서 할 수 있는 가장 가까운 변경을 제안해요.

화면 코드(.tsx, .css 같은 프런트엔드 파일)를 고친 부분은 "화면이 이렇게 보이거나 동작해야 한다"는 요구사항으로 바꿔 반영해요. 어느 API 에도 속하지 않는 변경은 사용자에게 어떻게 동작해야 하는지 되물어요.

PR 없이 코드를 보내는 방법

GitHub 를 쓰지 않아도 괜찮아요. 백엔드엑스 채팅창에 diff 나 코드 조각을 그대로 붙여 넣어도 PR 과 똑같이 읽고 정리해요. 채팅창의 파일 첨부로 코드 파일(.diff·.patch·.py·.txt, 하나당 512KB 까지)을 올려도 돼요. 코드가 보이면 백엔드엑스도 개발자에게 맞춰 기술 용어로 대화해요.

마무리

정리하면, 바이브코딩으로 말하듯 요청해도 되고, 코어 개발자처럼 코드로 보여 줘도 돼요. 어느 쪽이든 백엔드엑스는 요청을 요구사항으로 정리하고, 문서·코드·테스트를 함께 맞춰 앱을 업데이트해요. 코드로 말하는 게 더 편하다면 다음 업데이트는 PR 로 보내 보세요.