GitHub 한 장 요약
AI TF GitHub 가이드 6편 · v0.6 (2026-09-21) · A4 한 장으로 인쇄해 모니터 옆에 두세요. 웹판에서는 아래 인쇄하기 버튼이나
Ctrl + P를 누르면 이 편만 인쇄됩니다.
작업 시작 순서
- Current Repository 확인
- Current Branch 확인: 실제 프로젝트는
work, 연습장은work-…(main이면 바꾸고 시작) - Fetch origin → Pull origin 으로 바뀌면 누름. 안 바뀌면 받을 것이 없는 것 (정상)
커밋 전 세 가지 확인
- 예상하지 못한 파일 변경이 없는가
- 실행하거나 열어 보니 요청한 대로 동작하는가
- 비밀번호·API 키·개인정보·업무 원본 자료가 없는가
확인을 마친 뒤의 커밋·푸시는 교육 기간에는 직접 하고, 실무에서는 Codex에게 시켜도 됩니다. 확인은 언제나 내가 합니다.
버튼 설명 (GitHub Desktop)
| 버튼 | 뜻 |
|---|---|
| Fetch origin | GitHub에 새 소식이 있는지 확인만 |
| Pull origin | GitHub 쪽 같은 브랜치에 새로 올라온 것 받기. 받을 것이 있을 때만 나타남 |
| Commit to work | "여기까지 저장" 도장. 체크된 파일만 담김 |
| Push origin | 커밋을 GitHub에 올리기. 늦어도 하루를 마칠 때 |
| Discard Changes | 선택한 파일의 커밋 안 한 변경 버리기. 필요한 수정도 함께 사라지니 대상 확인 |
| Revert Changes in Commit | 선택한 커밋의 변경만 취소하는 새 커밋. 폴더 전체 되감기가 아님 |
| Preview Pull Request | PR 만들기. base: main 확인 후 작성, 팀장에게 메신저로 알림 |
PR 이후
검토·승인 → 팀장이 병합(main 반영) → 별도 단계로 서버 배포. main 은 아무도 직접 고치지 않고 PR 병합으로만 바뀝니다. 병합 뒤에도 같은 작업본을 계속 씁니다. PR이 열려 있는 동안 푸시한 것은 그 PR에 들어가므로, 관련 없는 새 작업은 병합 뒤에 시작합니다.
우리 TF 규칙
| 항목 | 내용 |
|---|---|
| 올리지 않는 것 | NDA 자료, 개인정보, 입찰·견적 정보, 비밀번호·API 키·.env, 문서 원본. 시험은 가짜 데이터로 |
| 누르지 않는 버튼 | Merge pull request · Delete branch · 새 브랜치 만들기 |
| 작업 장소 | 회사 PC의 C:\tf 안에서만. Codex 권한은 Approve for me(나 대신 승인), Full access 금지 |
| 실수했을 때 | 지우지 말고 더 진행하기 전에 팀장에게 알림 |
| 충돌(conflict)이 뜨면 | 멈춤 → 캡처 → Abort merge → 팀장에게 메신저. 직접 해결하지 않음 (7편) |
| 15분 넘게 막히면 | 팀장에게 메신저로 도움 요청. 캡처에 민감정보가 없는지 확인. 적을 내용은 5편 6절 |
이어서 읽기
- 다음 편: 7편. 브랜치 분기와 충돌 대처 — 브랜치의 원리, 충돌 안내가 떴을 때
- 전체 목록: 가이드 전체 구성