docs: 로컬 워크플로우 보완 - 커밋범위·push reject rebase·workspace-config 경계

Made-with: Cursor

workflow/local_developer_workflow.md

@@ -29,7 +29,8 @@ tags: [infra, workflow, local, git, sync, developer]
 - 워크스페이스 루트는 환경마다 다릅니다. 로컬 PC의 경우 예: `$HOME/projects` 또는 `$WORKSPACE_ROOT`.
 - 스크립트·경로는 `$WORKSPACE_ROOT` 기준 상대 경로로 해석합니다.
 - 교차 저장소 단일 커밋 금지. 각 레포별로 add·커밋·푸시합니다.
-- 푸시 전 `git status`로 수정·추가·미추적(untracked) 파일을 모두 확인하고, 해당 레포 내 변경은 전부 add·커밋·푸시 대상에 포함합니다.
+- **커밋 범위**: 사용자 지시가 없는 한, 기존 미커밋 변경은 내 작업과 함께 커밋하지 않습니다. 사용자가 "푸시해 모두" 등으로 명시 지시한 경우에만 해당 레포 내 변경 전부를 add·커밋·푸시 대상에 포함합니다.
+- **workspace-config 경계**: `runtime.env`, `secrets.env`는 공용 기준(구조·키·역할)의 SSOT입니다. 실제 값 파일은 `.gitignore`·비추적·로컬 오버라이드 전용이며, 커밋 대상에 포함하지 않습니다.
 
 ## 표준 흐름
 
@@ -64,7 +65,7 @@ done
 
 ### 3. 작업 종료 전 정리
 
-각 변경된 레포에서:
+각 변경된 레포에서 (사용자 명시 지시가 있는 경우에만 해당 레포 내 변경 전부 포함):
 
 ```bash
 cd "$REPO_PATH"
@@ -74,6 +75,7 @@ git commit -m "적절한 메시지"
 git push
 ```
 
+- **push reject 시**: `git pull --rebase` 후 `git push` 재시도.
 - 미커밋 상태가 남으면 이유(보류/폐기/후속작업)를 명시합니다.
 - "완료" 보고는 커밋 해시/푸시 브랜치 기준으로만 합니다.
 
@@ -81,9 +83,10 @@ git push
 
 | 스크립트 | 경로 | 용도 |
 |----------|------|------|
-| git_pull_all.sh | `$WORKSPACE_ROOT/scripts/git_pull_all.sh` | 전체 레포 `git pull --no-rebase` |
+| git_pull_all.sh | `$WORKSPACE_ROOT/scripts/git_pull_all.sh` | 전체 레포 `git pull --no-rebase` (일괄 동기화용) |
 
-스크립트가 없으면 `scripts/` 폴더에 생성 후 실행 권한 부여합니다.
+- 일괄 pull은 `--no-rebase`로 단순화. 개별 레포에서 push reject 시에는 `pull --rebase` 후 push.
+- 스크립트가 없으면 `scripts/` 폴더에 생성 후 실행 권한 부여합니다.
 
 ## 참고