From aea787cc8d8771634dfa126f6133eb5d899dce14 Mon Sep 17 00:00:00 2001 From: umsangdon Date: Sat, 12 Sep 2026 09:37:25 +0900 Subject: [PATCH] =?UTF-8?q?docs(verification):=20=EA=B9=83=20=EA=B7=B8?= =?UTF-8?q?=EB=AC=BC=EB=A7=9D=EC=97=90=EC=84=9C=20=ED=95=A9=EB=A5=98?= =?UTF-8?q?=EC=A0=90=20dev=20=EB=A1=9C=20=EC=A0=84=ED=99=98=20=EA=B8=B0?= =?UTF-8?q?=EB=A1=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../2026-09-12_깃_합류점_dev_전환.md | 94 +++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 docs/raw/verification/2026-09-12_깃_합류점_dev_전환.md diff --git a/docs/raw/verification/2026-09-12_깃_합류점_dev_전환.md b/docs/raw/verification/2026-09-12_깃_합류점_dev_전환.md new file mode 100644 index 00000000..2d908f46 --- /dev/null +++ b/docs/raw/verification/2026-09-12_깃_합류점_dev_전환.md @@ -0,0 +1,94 @@ +# 깃 운영 전환 — 그물망에서 합류점(`dev`)으로 (2026-09-12) + +작성: desktop-main (Claude). 지시: 사용자. +바뀐 파일은 **전부 git 밖**(`.claude/` · `CLAUDE.md` · `AGENTS.md` · `OWNERS.md`) — +시놀로지로만 건너감. 이 문서만 git 에 남김. + +--- + +## 1. 왜 — 실측 + +VSCode 에서 ORCA 로 옮기며 워크트리를 **넷에서 여섯으로** 늘리기로 함 +(클로드 4 · 코덱스 1 · 안티그래비티 1). 늘리기 전에 깃 그림이 이미 엉켜 있었음. + +| 본 것 | 값 | +| ------------------------------ | ------------------------------------------------------- | +| 최근 이틀(9/11~9/12) 커밋 | 머지 **27** / 실제 작업 **12** — 머지가 2.25배 | +| 저장소 전체 `Merge remote-tracking` | **319** / 전체 1,782 커밋 = 18% | +| 얽힘 구조 | 창마다 **남의 환경 브랜치를 전부** 되받음 (그물망) | +| 갈래 수 | 창 4개 = 12갈래 → **창 6개 = 30갈래** (2.5배 악화 예정) | +| `origin/main` | 이미 `main_desktop_1` 의 **조상** — 합류점 자리가 비어 있었음 | + +원인은 브랜치 개수가 아니라 `git-sync.ps1` **2.5단계**였음 — 세션·지시마다 다른 환경 +브랜치를 전부 자기 브랜치로 merge 함. N개 창이 서로를 보므로 머지 커밋이 N×N 으로 늘어남. + +## 2. 사용자 결정 + +- `main` = **정본 유지.** 창은 손대지 않음. 합류점은 **새로 만듦**(`dev`). +- **받기** — 미커밋이 있으면 **통째로 건너뜀.** 옛 판의 「docs/ 만 받기」 예외 **폐기** + (위키 작업도 코드 작업과 동일하게 운영). +- **밀기** — 커밋 뒤 **자기 브랜치로만** push. `dev` 는 다음 받기가 올림. +- **싱크** — 환경 브랜치 여섯을 한 점으로 모음. +- 저장소 무게(`.git` 9.1GB · 중단 찌꺼기 `tmp_pack` 3.5GB · 추적 중인 `resources` 3.18GB)는 + **이번에 건드리지 않음** — 사용자 보류. +- 코덱스·안티그래비티도 **코드 작업 가능**하게 `AGENTS.md` 개정. + +## 3. 새 한 바퀴 + +``` +받기 미커밋이면 건너뜀. 깨끗하면 + ① origin/dev 담기(대개 빨리감기) + ② dev 가 아직 못 품은 환경 브랜치를 **한 번의 옥토퍼스 머지로** 담기 + ③ dev 를 내 자리로 빨리감기로 올리기 +작업 자기 브랜치에서 +밀기 커밋 → 자기 브랜치로만 push +싱크 -Converge : 환경 브랜치 여섯을 내 자리로 빨리감기 (main 은 제외) +``` + +## 4. 고친 것 + +| 파일 | 무엇 | +| -------------------------- | ----------------------------------------------------------------------- | +| `.claude/git-sync.ps1` | 2.5단계를 그물망 되받기 → 합류점 따라오기로 교체(옥토퍼스 1회 + dev 올리기) | +| | 7단계 모으기에서 `main` 만 제외 — 코덱스·안티그래비티도 함께 모음 | +| | 3단계 「새 원격 브랜치」 알림에서 `dev` 제외 · `-Brief` 필터 갱신 | +| `.claude/git-autopush.ps1` | **안 고침** — 이미 자기 브랜치로만 push 함(사용자 규칙과 일치) | +| `CLAUDE.md` 6·7장 | 줄 셋(main/dev/환경6) · 새 한 바퀴 · 창 여섯 | +| `AGENTS.md` | 제목·1장(코덱스+안티그래비티, 코드 작업 경계) · **4장 코드 작업 규칙 신설** | +| | 5장 작업 보조 · 6장 작업 환경(6환경) + **깃 한 바퀴** · 7장 공통 원칙 | +| `OWNERS.md` | codex · antigravity 두 줄 추가 (포트 8002·5175 / 8003·5176) | +| ORCA 저장소 설정 | `worktreeBaseRef` → `origin/dev`, setup 문구 되살림 | + +`dev` 는 **원격 전용**으로 둠(로컬 브랜치 안 만듦) — 워크트리가 물고 있지 않아야 +어느 창에서도 `HEAD:dev` 로 올릴 수 있음. 끊은 자리는 `cecd12e3` — 그때 여섯 브랜치가 +모두 `main_desktop_1` 에 흡수돼 있어 **머지 0회**로 출발함. + +## 5. 자체검증 — 모형 저장소 실행 + +진짜 저장소를 건드리지 않으려고 `git init` 으로 작은 모형(bare 1 + 워크트리 3)을 세워 +**고친 스크립트를 그대로** 돌림. + +| 시험 | 결과 | +| ------------------------------------ | --------------------------------------------------------- | +| ② 밀린 브랜치 1개 흡수 + ③ dev 올리기 | ✅ 머지 커밋 **1개**, dev 3커밋 전진 | +| ① dev 받기 (내 것이 이미 dev 에 있음) | ✅ **빨리감기** — 새 머지 커밋 0개 | +| ② 밀린 브랜치 **2개** 동시 | ✅ 옥토퍼스 **한 방** — 머지 커밋 1개, 부모 2개 | +| 미커밋 있을 때 받기 | ✅ 통째로 건너뜀 + 「커밋·push 한 뒤 다시 하세요」 | +| `-Converge` 모으기 | ✅ dev·main_desktop_1·sub_laptop_1 **세 브랜치가 같은 SHA** | +| 진짜 저장소에서 훅 실행 | ✅ 최신일 때 조용함, `-Brief` 는 아무것도 안 찍음 | + +⚠ 옥토퍼스 실패 시 하나씩 다시 머지하는 갈래는 **모형에서 안 걸림**(충돌을 못 만듦) — +코드상 각 머지를 `--abort` 로 감싸 둠. 실제로 부딪히면 작업 트리는 그대로 두고 보고만 함. + +⚠ 옥토퍼스가 `Fast-forwarding to:` 같은 줄을 stderr 로 뱉음. PowerShell 5.1 에서 +네이티브 stderr 를 돌리면 `$?` 가 뒤집히는 자리라 **일부러 안 막음.** + +## 6. 남은 것 · 주의 + +- **창 여섯을 전부 다시 켜야 함.** 한 창이 옛 훅으로 남으면 그 창 혼자 그물을 다시 침. + `.claude` 는 데스크탑은 심볼릭 링크 한 벌, 랩탑은 시놀로지가 옮김. +- ORCA setup 문구는 앱이 자기 상태로 **되돌려 쓴 적이 있음**(이번에도 `npm install` 로 + 돌아가 있었음). ORCA 를 다시 켠 뒤 `orca repo show --repo id: --json` 으로 확인할 것. +- 코덱스·안티그래비티는 클로드 훅이 안 돎 — `AGENTS.md` 6장대로 **손으로** + `.claude\git-sync.ps1` 을 자기 워크트리 폴더에서 부를 것. +- 저장소 무게 정리(찌꺼기 팩 3.5GB · `resources` PDF 원문 3GB)는 사용자 보류 중.