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

1. 무엇을 하나

앞에서는 프로젝트를 처음부터 만들었습니다. 실무는 대부분 남이 이미 만들어 둔 프로젝트에 합류해 고치는 일입니다.

• 대상: 실제 사내 프로젝트 popax (내가 만든 게 아니라, 이미 돌아가고 있는 남의 프로젝트)
• 흐름: 가져오기 → 파악 → 작은 개선 → 커밋·푸시
• 여기서 넣는 개선은 실제 popax 에 남습니다. 온보딩을 거치는 동안 popax 는 조금씩 나아집니다.

2. popax 가져오기

devtools 런처에서 남의 저장소를 내 서버로 가져옵니다. (참고: 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

• 결과물은 ~/popax/src 에 준비됩니다.
• 데이터베이스·.env 가 더 필요하면 Claude Code 가 안내해 줍니다. 안내대로 따르면 됩니다.

3. 띄워서 파악하기

프로젝트 안에서 개발 서버를 켜고, 어떤 프로젝트인지 눈으로 파악합니다.

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

개발 서버 띄워줘

• 안내된 dev 주소가 열리면, 화면을 몇 개 눌러보며 무엇을 하는 프로젝트인지 파악합니다.
• 코드를 다 이해할 필요는 없습니다. "어떤 기능이 있는지" 감을 잡는 정도면 됩니다.

4. 작은 개선 하나

같은 프로젝트 세션에서 작은 변경을 요청합니다. 남의 코드이니, 처음부터 큰 걸 건드리지 않습니다.

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

• 중간에 나오는 계획과 스펙 확인에 답합니다.
• 무엇을 바꿀지 막연하면, 어디에 무엇이 보이면 되는지 한 문장으로 적어 줍니다.
• 끝나면 dev 주소에서 바뀐 화면을 확인합니다.

5. 커밋하고 올리기

개선을 실제 popax 에 반영합니다. 올리는 방식은 프로젝트의 팀 정책을 따릅니다.

• popax 는 보호된 저장소가 아니라 master 에 직접 올려도 되는 프로젝트입니다.
  • 참고: PR(리뷰 요청)이 꼭 필요한 곳은 공용 패키지(standarda-core·standarda-template) 뿐입니다.

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

• 올리기 전에 다른 사람의 최신 변경이 있을 수 있습니다. 충돌이 나도 직접 손대지 말고 "충돌 해결해줘" 라고 하면 Claude Code 가 정리해 줍니다.

6. 확인

• GitHub 저장소(https://github.com/popupstudio-ai/popax)의 최근 변경 목록에 방금 올린 개선이 보이면 성공입니다.
• 남이 만든 프로젝트에 내 개선이 실제로 들어간 것입니다.

마무리

• 핵심 정리: 남이 만들어 둔 실제 popax 를 가져와(가져오기 → 파악 → 작은 개선 → 커밋·푸시) 실제 코드에 기여했습니다. 기존 프로젝트에 합류했을 때의 기본 흐름입니다.
• 주의 사항: 남의 코드는 처음부터 크게 바꾸려 하지 않습니다. 작은 변경 하나로 흐름을 익힙니다. 올리는 방식은 프로젝트마다 다르니 팀 정책(직접 push 인지 PR 인지)을 먼저 확인합니다.
• 다음 시간: 온보딩을 마쳤습니다. 더 깊은 원리와 응용은 세션에서 이어집니다.
• 참고: standarda 가 내부적으로 어떻게 구성되는지(core·template·devtools)는 상단 제품 소개 → standarda 생태계 메뉴에서 볼 수 있습니다.