Clarify branch and environment rules

CONTRIBUTING.md

@@ -3,6 +3,9 @@
 ## 기본 규칙
 
 - `main`은 팀 기준 브랜치로 사용합니다.
+- `dev`는 팀 개발 통합 브랜치로 사용합니다.
+- `main`, `dev`는 브랜치이고 `8080`, `8081`은 실행 환경입니다.
+- 권장 운영은 `main -> 8080`, `dev 또는 작업 브랜치 -> 8081`입니다.
 - 기능 개발과 버그 수정은 각자 작업 브랜치에서 진행합니다.
 - 직접 `8080` 기준 파일을 수정하지 않습니다.
 - 검증은 먼저 `8081` 개발 환경에서 수행합니다.

README.md

@@ -25,6 +25,8 @@
 - `incoming-files/served/*`와 `legacy/static/*`는 런타임 자산입니다.
 - 조직현황/멤버/자리배치 관련 검증은 `8081` 개발 환경에서 먼저 수행합니다.
 - `8080`은 기준 데이터와 공개 환경, `8081`은 검증 환경으로 다룹니다.
+- `main`, `dev`는 Git 브랜치이고 `8080`, `8081`은 실행 환경입니다.
+- 권장 운영은 `main -> 8080`, `dev 또는 작업 브랜치 -> 8081`입니다.
 
 ## 시작 문서
 

docs/TEAM_GUIDE.md

@@ -32,6 +32,14 @@
 
 ## 2. 환경 원칙
 
+팀 규칙 문장:
+
+- `main`과 `dev`는 코드 브랜치다.
+- `8080`과 `8081`은 실행 환경이다.
+- 브랜치 이름을 포트와 같은 뜻으로 쓰지 않는다.
+- 기본 운영은 `main`을 `8080` 기준 브랜치로 본다.
+- 개발 검증은 `dev` 또는 작업 브랜치를 `8081`에서 먼저 확인한다.
+
 - `8080`
   - 공개 기준 환경
   - 기준 데이터가 있는 쪽