docs: dev 합류점과 브라우저 운용 위키화

docs/wiki/concepts/browser_verification_operations.md

@@ -0,0 +1,37 @@
+---
+type: concept
+status: stable
+related_pages: ["[[multi_environment_safety]]", "[[design_data_lifecycle]]"]
+last_updated: 2026-09-12
+source: ["docs/raw/verification/2026-09-12_공용_브라우저_운용.md"]
+---
+
+# 화면 검증 브라우저 운용
+
+## 기본 선택
+
+- 화면 검증 기본은 Orca 내장 브라우저다. 공용 브라우저는 사용자가 명시한 때만 쓴다.
+- 공용 창과 Orca 탭을 동시에 띄우면 `snapshot`·`screenshot`이 충돌하므로 함께 사용하지 않는다.
+- 검증은 직접 조작하고 `sessionStorage`, SVG 좌표, 툴팁, 스크린샷 등 수치 근거로 판정한다. 바꾼 값은 원래 상태로 복원한다.
+
+## 공용 브라우저 시동과 조작
+
+| 항목 | 위치·명령 | 역할 |
+|---|---|---|
+| 시동 | `./venv/Scripts/python.exe .claude/dev_up.py` | 서버와 공용 창을 시작하거나 살아 있는 프로세스 재사용 |
+| Orca용 시동 | `dev_up.py --no-browser` | 서버만 시작 |
+| 명령 큐 | `tmp/browser/cmd/NN_이름.py` | `page`, `log`, `shot`, `time` 전역으로 이름순 조작 |
+| 드라이버 로그 | `tmp/browser/driver.log` | RUN·OK·ERROR·SHOT 결과 기록 |
+| 스크린샷 | `tmp/browser/shots/` | 화면 검증 증거 저장 |
+
+`tmp/`는 환경 사이에 전달되지 않는다. 남길 시험은 `resources/tester/`에 둔다. 브라우저 창 종료·재시작은 사용자 지시가 있을 때만 하며, 캐시는 CDP `Network.clearBrowserCache` 뒤 `page.reload()`로 비운다.
+
+## 변경 종류별 반영
+
+| 변경 | 공용 브라우저 | Orca |
+|---|---|---|
+| 페이지·공용 TypeScript | `page.reload()` | `orca reload` |
+| B07 WebCAD | `npm run build` 후 캐시 비우기 | 빌드 후 `orca reload`; 캐시 잔존 여부 미확인 |
+| Python·도면 템플릿 JSON | 백엔드만 재시작 | 백엔드만 재시작 |
+
+공용 서버·브라우저의 포트와 주인은 현재 `OWNERS.md`를 따른다. `sessionStorage`는 포트별로 갈리므로 검증 포트에서 상태를 다시 세운다.

docs/wiki/concepts/multi_environment_safety.md

@@ -1,9 +1,9 @@
 ---
 type: concept
 status: stable
-related_pages: ["[[architecture/shared_resources]]", "[[storage_paths]]", "[[workflow_state]]", "[[design_data_lifecycle]]"]
-last_updated: 2026-09-11
-source: ["docs/raw/verification/2026-09-09d_OWNERS_이력.md", "docs/raw/verification/2026-09-09e_계획서_완료근거_이관.md", "docs/raw/verification/2026-09-09f_계획서_공통기반과_참고_이관.md", "docs/raw/verification/2026-09-11_창환경_링크와_깃운영_조사.md", "docs/raw/plans/2026-09-11_plan_창환경_여섯워크트리_링크_깃운영.md"]
+related_pages: ["[[architecture/shared_resources]]", "[[storage_paths]]", "[[workflow_state]]", "[[design_data_lifecycle]]", "[[browser_verification_operations]]"]
+last_updated: 2026-09-12
+source: ["docs/raw/verification/2026-09-09d_OWNERS_이력.md", "docs/raw/verification/2026-09-09e_계획서_완료근거_이관.md", "docs/raw/verification/2026-09-09f_계획서_공통기반과_참고_이관.md", "docs/raw/verification/2026-09-11_창환경_링크와_깃운영_조사.md", "docs/raw/plans/2026-09-11_plan_창환경_여섯워크트리_링크_깃운영.md", "docs/raw/verification/2026-09-12_깃_합류점_dev_전환.md"]
 ---
 
 # 다중 환경 저장소·공용 DB 안전
@@ -31,15 +31,26 @@ source: ["docs/raw/verification/2026-09-09d_OWNERS_이력.md", "docs/raw/verific
 | 구분 | 확정 운영 |
 |---|---|
 | 코드 환경 | `main_laptop_1`, `sub_laptop_1`, `main_desktop_1`, `sub_desktop_1` |
-| AI 환경 | 데스크탑의 `CODEX`, `안티그래비티`; AI 브랜치는 `docs/`만 전달 |
+| AI 환경 | 데스크탑의 `CODEX`, `안티그래비티`; 코드 작업은 사용자 지시가 있을 때만 수행 |
 | 메인 동기화 | 두 메인 폴더의 `.claude`, `.codex`, 루트 지침·장부는 Synology가 전달 |
 | 보조·AI 링크 | 폴더 `.claude`·`.codex`·`venv`는 정션, 루트 파일 넷은 심볼릭 링크 |
 | 링크 원본 | 각 PC의 `OWNERS.md`에 적힌 자기 PC 메인 경로 |
 | 신규 워크트리 | Orca가 생성·삭제, `worktree_setup.ps1`가 설치 후 `worktree_link.ps1` 실행 |
-| Git 동기화 | 기존 스크립트가 fetch·merge·자동 push 담당; 브랜치 이름 패턴은 넓히지 않음 |
+| Git 동기화 | `main`은 정본, `dev`는 합류점, 환경 브랜치 6개는 작업 자리 |
 
 링크는 Synology 동기화 루트 밖에만 만들고, 지침·장부를 `.claude`나 `.codex` 안으로 옮기지 않는다. `worktree_link.ps1`는 살아 있는 하드링크만 심볼릭 링크로 갈아타며 갈라진 실물은 지우지 않는다.
 
+## Git 한 바퀴
+
+| 단계 | 규칙 |
+|---|---|
+| 받기 | 작업 시작 전 자기 워크트리에서 `.claude\git-sync.ps1`를 인자 없이 한 번 실행 |
+| 작업 | 자기 환경 브랜치에서 지시받은 범위만 변경 |
+| 밀기 | 경로를 지정해 커밋한 뒤 `git push origin HEAD`로 자기 브랜치에만 push |
+| 모으기 | 사용자가 Git 싱크를 지시한 때만 `git-sync.ps1 -Converge` 실행 |
+
+`git-sync.ps1`는 `origin/dev`를 받고, `dev`가 아직 품지 않은 환경 브랜치를 한 번의 옥토퍼스 머지로 담은 뒤 `dev`와 현재 환경 브랜치를 빨리감기한다. `-Brief`는 작업 중 HEAD를 바꾸지 않고 미수신 커밋만 알린다. 미커밋이 있으면 받기를 통째로 건너뛰며, `main`과 `dev`에 손으로 push하지 않는다.
+
 ## 완료 판정
 
 - 랩탑 AI 워크트리 둘 제거, 데스크탑 AI 워크트리 둘 생성, 랩탑·데스크탑 보조 및 AI 워크트리 링크 구성을 완료했다.