코드 관리
저장소(Repository)
저장소(Repository)은(는) 바이브 코딩 중 자주 마주치는 핵심 개념입니다. 정의만 외우기보다 실제 작업 흐름에서 어떤 역할을 하는지 이해하는 것이 중요합니다.
쉬운 설명
프로젝트 파일과 Git 변경 이력이 함께 들어 있는 코드 저장소.
배경과 쓰임까지 이해하기
조금 더 자세히
저장소(Repository)는 한 프로젝트의 코드와 변경 기록을 함께 담는 단위입니다. 보통 프로젝트 폴더 하나가 저장소가 되고, 그 안에는 소스 코드, 설정 파일, 문서, 이미지, Git 이력이 들어 있습니다. 예를 들어 웹사이트 저장소, 백엔드 API 저장소, 디자인 시스템 저장소, 문서 사이트 저장소처럼 프로젝트 단위로 나눠 관리합니다.
Github(깃허브)에 올릴 때도 저장소 단위로 올리고, PR이나 이슈도 보통 저장소 안에서 관리합니다. 저장소를 잘 나누면 프로젝트의 책임과 배포 흐름이 선명해집니다. 한마디로, 저장소(Repository)는 하나의 프로젝트를 담는 코드 보관함입니다.
실제로는 이렇게 만나요
`src`, `public`, `package.json`, `.git`이 있는 프로젝트 폴더 하나가 저장소(Repository)가 될 수 있습니다.
- 이런 거 할 때 나와요 AI 코딩 도구는 보통 저장소(Repository)를 기준으로 파일을 읽고 수정합니다. 저장소 구조가 명확할수록 AI도 맥락을 잘 잡습니다.
- 이렇게 생겼어요 저장소(Repository)은(는) Git, GitHub, Commit 같은 주변 개념과 함께 문서, 설정 화면, 오류 메시지에서 자주 보입니다.
- 나오는 화면 예시 코드 관리 작업을 하다가 Git, GitHub, Commit를 확인하는 화면
헷갈리기 쉬운 점
여러 프로젝트가 섞인 폴더를 하나의 저장소처럼 쓰면 AI가 엉뚱한 파일을 수정하기 쉽습니다.
왜 알아두면 좋을까요?
AI 코딩 도구는 보통 저장소(Repository)를 기준으로 파일을 읽고 수정합니다. 저장소 구조가 명확할수록 AI도 맥락을 잘 잡습니다.
Checklist
실제로 볼 때 확인할 것
- 01
프로젝트 루트가 어디인지 확인한다
- 02
README에 실행 방법을 적는다
- 03
불필요한 산출물은 .gitignore에 넣는다