Skip to content
김수환 edited this page Aug 25, 2025 · 6 revisions

🧾 팀 협업 그라운드 룰

1. 목적 (Agile Mindset)

변경 사유: 팀원 1명 감소로 규칙 최소화 필요

  • 속도 & 추적 가능성 ― 3 주 동안 최소 규칙으로 빠르게 개발하되, 언제든 변경 내역을 추적할 수 있게 한다.
  • 마지막 주 집중 ― 4 주차는 안정화(버그·부하)와 발표 자료 준비에 집중.
  • Rule & Docs Minimalism ― “규칙을 위한 규칙, 문서화를 위한 문서”를 지양하고 Just-Enough 원칙을 지킨다.

2. 협업 관리

구분 도구 메모
버전 관리 GitHub main / develop / feature-* / hotfix-* / chore-*
Task GitHub Projects & Issues 칸반 보드(아래 4. 참조)
문서 GitHub Wiki (기술) / /docs 디렉토리 (그라운드 룰·기획) Wiki 홈에 필수 링크 첨부
소통 Slack · KakaoTalk · 오프라인 결정 사항은 항상 이슈·Wiki에 남긴다
코드 컨벤션 FE·BE 각 파트에서 정의 후 /docs/code-style.md에 기록

3. Git / PR / Issue 규칙

항목 규칙
머지 전략 mainRebase & Merge / developSquash & Merge
브랜치 네이밍 feature/{part}/{issue#}-{title}
hotfix/{part}/{issue#}-{title}
chore/bundle-{YYYYMMDD}
1 이슈 = 1 PR 추적·롤백을 쉽게 하기 위함.
예외: chore 라벨이 달린 30 분 ~ 1 시간 이내 작업은 “Chore Bundle PR” 허용
PR 템플릿 라벨·연결 Issue 필수. 제목 예시: Feature/be/#12 - 로그인 필터 구현
Issue 서브이슈가 있으면 Epic 생성 후 연결.
마감일: Best Case / Worst Case 함께 기입

4. 칸반 보드 (GitHub Projects)

  • Todo ― 하기 전
  • In Progress ― 진행 중
  • Under Review ― 작업 완료·리뷰 대기
  • Done ― Merge & 배포 완료

5. 작업 단위 · 마일스톤

  • 기본 단위: Issue 1개 = PR 1개
  • 일정은 항상 목표치(Best)와 최소 보장선(Worst)로 작성

6. 회의 · 스크럼

종류 형식 최대 시간 내용
데일리 스크럼 Slack 워크플로 + 5 분 대면 10 분 어제 한 일 / 오늘 할 일
데일리 회고 Slack 워크플로 + 5 분 대면 10 분 오늘 한 일 / 오늘의 감상
위클리 회고 KPT + 자유 피드백 30 분 (유동적) 개인 KPT → 파트(BE·FE)팀 전체
기타 회의 필요 시 소집, 30 분 초과 금지 시간 초과 시 커피 벌칙

시간 약속: 지각 = 커피 1 잔. 회의·스크럼·데모는 정시 시작.


7. 문서화 규칙

대상 저장 위치 참고
기술 선정 과정·설계 근거 GitHub Wiki PR 설명에 링크 첨부
정책(파트 간 공유) GitHub Wiki Wiki 홈의 Policy 섹션
그라운드 룰·기획 /docs 디렉토리 ex) docs/ground-rules.md
코드 변경 설명 PR Template, 주석, PR Comment

8. 일정 · 품질 관리

  • 일정 미달성 시 ⚖️ 인민재판 + ☕ 커피 벌칙
  • 4 주차: 버그 수정 · 부하 테스트 · 발표 자료에 집중
  • 모든 룰은 팀 상황에 따라 유동적 으로 변경 가능

Clone this wiki locally