기존 프로젝트 합류하기 (수정중)

1. 무엇을 하나

앞에서는 프로젝트를 처음부터 만들었다. 실무는 대부분 이미 돌아가는 남의 프로젝트에 합류해 고치는 일이다.

• 대상: 실제 사내 프로젝트 popax(github.com/popupstudio-ai/popax). 내가 만든 게 아니라 이미 운영 중인 코드베이스.
• 흐름: clone-repo 로 가져오기 → 파악 → 작은 개선 → 커밋·푸시
• 여기서 넣는 개선은 실제 popax 에 반영된다.

2. popax 가져오기

런처 디렉토리에서 Claude Code 를 켜고 clone URL 을 위임한다. (참고: CHAP.02 프로젝트 다루기 - L03 프로젝트 가져오기)

# 🖥️ 서버 터미널
gildong@ip-172-31-39-132:~$ cd ~/standarda-devtools
gildong@ip-172-31-39-132:~/standarda-devtools$ claude

clone-repo 로 https://github.com/popupstudio-ai/popax.git 셋업해줘

/exit

clone-repo 는 ~/popax/src 표준 레이아웃으로 clone 하고 .memory symlink·.gitignore 정합성·venv·pip install 까지 처리한다. setup.sh 가 있으면 cd ~/popax && ./setup.sh 한 줄로 DB·.env 까지 끝낼 수 있다. (DB·migrate·포트는 clone-repo 가 자동으로 하지 않고 안내만 한다.)

3. 띄워서 파악하기

프로젝트 src 에서 Claude Code 를 켜고 개발 서버를 자연어로 띄운다.

# 🖥️ 서버 터미널
gildong@ip-172-31-39-132:~$ cd ~/popax/src
gildong@ip-172-31-39-132:~/popax/src$ claude

개발 서버 띄워줘

• 자연어 개발 서버 띄워줘 와 슬래시 /dev 둘 다 같은 스킬이다.
• 안내된 dev 주소에서 화면을 눌러보며 어떤 기능이 있는 프로젝트인지 감을 잡는다.
• 첫 합류에 코드를 전부 이해할 필요는 없다. 어떤 앱·화면·엔드포인트가 있는지 지형을 파악하는 정도면 충분하다.

4. 작은 개선 하나

같은 세션에서 작은 변경을 요청한다. 남의 코드이므로 처음부터 큰 구조를 건드리지 않는다.

메인 화면 제목 옆에 짧은 안내 문구 한 줄을 추가해줘

• /develop 으로 라우팅되면 계획·스펙 게이트에 답한다. 무엇을 바꿀지는 어디에 무엇이 보이면 되는지 한 문장으로 명제화한다.
• 끝나면 dev 주소에서 바뀐 화면을 확인한다.

5. 커밋하고 올리기

개선을 실제 popax 에 반영한다. 올리는 방식은 repo 의 팀 정책을 따른다.

• popax 는 팀 공유 repo(standard)로 master branch protection 이 없어 직접 push 가 기본이다.
  • PR·Code Owner 승인이 강제되는 곳은 보호 repo 인 standarda-core·standarda-template 뿐이다. (SoT: 팀 wiki github/repo-policy.md)

지금까지 변경한 내용을 깃허브에 올려줘

• push 전 다른 사람의 최신 커밋이 있을 수 있다. 충돌이 나면 직접 손대지 말고 "충돌 해결해줘" 로 위임한다.

6. 확인

• github.com/popupstudio-ai/popax 의 최근 커밋 목록에 방금 올린 개선이 보이면 성공이다.
• 남이 만든 실제 프로젝트에 내 기여가 반영된 것이다.

마무리

• 핵심 정리: 실제 popax 를 clone-repo 로 가져와(파악 → 작은 개선 → 커밋·푸시) 운영 중인 코드베이스에 기여했다. 기존 프로젝트에 합류했을 때의 기본 사이클이다.
• 주의 사항: 남의 코드는 처음부터 크게 바꾸지 않는다. 작은 변경 하나로 흐름을 익힌다. push 방식은 repo 마다 다르니, 보호 repo(PR 강제)인지 팀 공유 repo(직접 push)인지 repo-policy.md 로 먼저 확인한다.
• 다음 시간: 온보딩을 마쳤다. 더 깊은 원리와 응용은 세션에서 이어진다.