From 319cff91552d33bd632e7ed6eff36ce0ad7fe595 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 5 Nov 2026 22:04:28 +0900 Subject: [PATCH] =?UTF-8?q?docs(improvement):=20desktop=20=EA=B3=B5?= =?UTF-8?q?=EC=9C=A0=20=EC=9E=A0=EA=B8=88=EA=B3=BC=20=EB=91=90=20repo?= =?UTF-8?q?=EC=9D=98=20=EC=A2=85=EB=A3=8C=20=EC=A1=B0=EA=B1=B4=20=EA=B2=B0?= =?UTF-8?q?=EC=A0=95=EC=9D=84=20=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 07장은 desktop 빌드를 "겹치지 않게"라고만 적고 잠금 파일을 정하지 않았다. 짝 프론트도 같은 desktop에서 돌려 부하와 포트(4173·4174)가 겹칠 수 있다. 또 두 repo 매뉴얼은 장 구성이 같은데, 리뷰 반복 종료 조건은 소유자가 "각자 유지"로 정해 서로 다르다. 이 차이가 매뉴얼에 없으면 같은 뼈대를 보고 같은 조건으로 오해한다. 방법: 07장 6절 절차와 규칙에 `flock /tmp/claude-gates/heavy.lock`을 넣고 한 줄 명령을 적는다(총괄 세션 지시). 08장 색인에 "두 repo의 종료 조건"과 "desktop 공유 잠금" 행을 더하고, 누가 칸에 "총괄 지시"·"정책" 뜻을 적는다. README의 프론트 뼈대 절과 09장 5절에 이 조건만 의도적으로 다르다고 적는다. 검증: 인용 경로·ID·링크·절 번호 대조 스크립트를 다시 돌렸다(새 불일치 없음). 문서 대조 lane은 push 뒤 desktop에서 잠금 아래 다시 돌린다. --- docs/improvement/07-verification-gates.md | 21 ++++++++++++++------- docs/improvement/08-decisions-records.md | 4 ++++ docs/improvement/09-working-method.md | 3 +++ docs/improvement/README.md | 3 +++ 4 files changed, 24 insertions(+), 7 deletions(-) diff --git a/docs/improvement/07-verification-gates.md b/docs/improvement/07-verification-gates.md index 605c86dc..2c5738f5 100644 --- a/docs/improvement/07-verification-gates.md +++ b/docs/improvement/07-verification-gates.md @@ -77,7 +77,7 @@ cd src cd .. && bash scripts/verify-compose-profile-contracts.sh ``` -- 한 번에 하나씩 돌린다. 같은 머신에서 두 빌드를 겹치지 않는다(6절). +- 한 번에 하나씩, 공유 잠금 아래에서 돌린다(6절). - 첫 실행이 실패하면 고치고 다시 돌린다. 둘 다 기록한다(`1103` README 16.1·16.2절). - 합친 뒤에만 드러나는 결함이 있다. 두 묶음의 수정이 처음 한 트리에서 만나면 새 결함이 생긴다(`1101` README 16.1절 `BC_IMPOSSIBLE_INSTANCEOF`). 그래서 묶음별 검증으로 이 단계를 대신하지 않는다. @@ -149,9 +149,9 @@ uptime # 다른 빌드가 돌고 있지 않은지 부 git fetch git switch <내 브랜치> # 처음 받는 브랜치면 origin/<내 브랜치>를 추적하는 로컬 브랜치가 생긴다 -# 3) 돌린다 +# 3) 공유 잠금 아래에서 돌린다 cd src -./gradlew <게이트> --console=plain +flock /tmp/claude-gates/heavy.lock ./gradlew <게이트> --console=plain # 4) 끝나면 원래 브랜치로 되돌린다 git switch <원래 브랜치> @@ -159,9 +159,16 @@ git switch <원래 브랜치> - **checkout을 여러 세션이 함께 쓴다.** 시작 전에 현재 브랜치를 적어 두고, 끝나면 그 브랜치로 되돌린다. 남의 stash는 건드리지 않는다(`git stash`·`git stash pop`을 쓰지 않는다). -- **빌드를 겹치지 않는다.** 이전 라운드는 같은 머신의 빌드를 공유 잠금 파일(`flock `)로 줄 세웠다 - (`1101/09-performance-measurement.md` 「측정 명령」, `1103/round6/01-core-inbound.md` 「실행한 명령과 결과」). desktop에서도 한 번에 - 하나만 돌리고, 결과 표에 직전 부하를 적는다. +- **모든 Gradle·Docker 실행을 공유 잠금으로 감싼다.** 잠금 파일은 `/tmp/claude-gates/heavy.lock`이다. 짝 프론트 repo도 같은 + desktop에서 같은 잠금으로 돌린다. 잠금 없이 돌리면 두 repo의 실행이 부하와 포트(프론트 4173·4174)에서 겹친다(2026-11-05 총괄 + 세션 지시). 한 줄로 쓰면 다음과 같다. + + ```bash + ssh desktop 'cd ~/workspace/clean-architecture-backend-template/src && flock /tmp/claude-gates/heavy.lock ./gradlew <태스크> --console=plain' + ``` + + 이전 라운드도 같은 머신의 빌드를 공유 잠금으로 줄 세웠다(`1101/09-performance-measurement.md` 「측정 명령」, + `1103/round6/01-core-inbound.md` 「실행한 명령과 결과」). 결과 표에는 잠금을 얻은 뒤의 직전 부하를 적는다. - **로그를 남긴다.** 게이트별 로그를 desktop에 파일로 남기고, 그 위치를 보고에 적는다. 결과 표는 리뷰 README에 옮긴다. - **임시 worktree는 지운다.** RED 확인용 worktree를 desktop에 만들었으면 끝나고 지운다(`1103` README 17.2절). @@ -169,4 +176,4 @@ git switch <원래 브랜치> - 작업 중 leaf `check` → 묶음 끝 경계별 게이트 → 라운드 끝 합친 트리 전체 묶음. - 결과는 커밋 sha·rc·시간·부하로 적고, 못 돌린 것·캐시 통과·빠진 lane을 숨기지 않는다. -- 무거운 실행은 desktop에서, 한 번에 하나, 끝나면 원래 브랜치로. +- 무거운 실행은 desktop에서, `flock /tmp/claude-gates/heavy.lock`으로 감싸 한 번에 하나, 끝나면 원래 브랜치로. diff --git a/docs/improvement/08-decisions-records.md b/docs/improvement/08-decisions-records.md index 140269a2..eccfd253 100644 --- a/docs/improvement/08-decisions-records.md +++ b/docs/improvement/08-decisions-records.md @@ -19,6 +19,8 @@ - **위임** — 소유자가 "결정이 필요한 것은 지금 정하고 진행하라"고 맡겨 총괄이 정했다(`1101` README 15절 머리말, `1103` README 4절 제목). 소유자가 뒤집을 수 있다. - **기본값** — 수정 묶음이 정하고 처리 표 「결정」 칸에 남겼다. 소유자 확인 대상이다(`1103` README 8·13.1절). +- **총괄 지시** — 소유자 환경을 운영하려고 총괄 세션이 정한 작업 규칙이다. 소유자가 바꿀 수 있다. +- **정책** — `AGENTS.md`에 적힌 규칙이다. | 분야 | 주제 | 결정 | 누가 | 출처 | | --- | --- | --- | --- | --- | @@ -27,6 +29,8 @@ | 작업 규칙 | 커밋 예외 2026-11-03 | 리뷰 수정을 `refactor/maturity-review-2026-11`에 커밋·push | 소유자 | `1101` README 17절 | | 작업 규칙 | 커밋 예외 2026-11-05 | 개선 매뉴얼 작업 브랜치에 커밋·push. PR·병합·다른 브랜치 push는 하지 않음 | 소유자 | 2026-11-05 총괄 세션 brief(이 매뉴얼 작업) | | 작업 규칙 | 리뷰 발견 처리 | Minor도 기록만 하지 않고 고친다. 보고할 때 남은 문제가 0. 수정이 새 결함을 만들면 리뷰·수정을 0까지 반복 | 소유자 | `1103` README 16절, 09장 5절 | +| 작업 규칙 | 두 repo의 종료 조건 | 의도적으로 다르게 유지한다("각자 유지"). 백엔드는 발견이 심각도와 상관없이 0이 될 때까지 리뷰 → 수정 → 확인 리뷰(09장 5절). 짝 프론트는 새 High 0·새 P1 0·merge 게이트 통과 뒤 그 라운드의 Medium·Low를 고치고 멈춘다. 두 매뉴얼의 장 구성은 같고 이 조건만 다르다 | 소유자 | 2026-11-05 총괄 세션 전달(소유자 원문 "각자 유지") | +| 작업 규칙 | desktop 공유 잠금 | desktop의 Gradle·Docker 실행은 `flock /tmp/claude-gates/heavy.lock`으로 감싼다. 프론트와 부하·포트(4173·4174)가 겹치지 않게 | 총괄 지시 | 2026-11-05 총괄 세션 brief 보충, 07장 6절 | | 작업 규칙 | 옛 멈춤 기준 | "새 Important 0이면 멈춤"(9.1절), "Minor는 기록만"(11.1절) — **거둠** | 위임 → 소유자가 거둠 | `1103` README 9.1·11.1·16절 | | 작업 규칙 | 스킬 | 리뷰·수정에 알맞은 스킬을 쓴다 | 소유자 | 2026-11-05 총괄 세션 brief, 실행 예 `1103` README 2절 | | 작업 규칙 | 무거운 실행 위치 | 노트북에서 Gradle·Docker를 돌리지 않는다. desktop에서 git pull 뒤 | 소유자 | `1103` README 17.1절, 07장 6절 | diff --git a/docs/improvement/09-working-method.md b/docs/improvement/09-working-method.md index 84bb795e..28d8a026 100644 --- a/docs/improvement/09-working-method.md +++ b/docs/improvement/09-working-method.md @@ -105,6 +105,9 @@ brief는 하위 단위가 받는 유일한 맥락이다. 빠뜨린 것은 하위 예전 멈춤 기준("새 Important 0이면 멈춤", "Minor는 기록만")은 소유자가 거뒀다(`1103` README 16절, 08장 1절). +이 종료 조건은 이 repo의 것이다. 짝 프론트 repo는 다른 종료 조건을 쓴다. 소유자가 두 repo의 조건을 "각자 유지"로 정했다 +(08장 1절 「두 repo의 종료 조건」). 장 구성은 같고 이 조건만 다르다. + **코드로 고칠 수 없는 것**: 소유자 결정이 필요한 것만 남을 수 있다. 그것은 근거와 권하는 안을 붙여 질문으로 보고한다. 질문이 답을 받으면 다시 고치기로 돌아간다. diff --git a/docs/improvement/README.md b/docs/improvement/README.md index d52a95e4..1c39b864 100644 --- a/docs/improvement/README.md +++ b/docs/improvement/README.md @@ -80,6 +80,9 @@ "두 repo의 05장"처럼 같은 주제를 바로 비교할 수 있다. 이 repo는 장을 합치거나 더하지 않았다. 부록 파일 이름은 `appendix-defect-patterns.md`다. +두 매뉴얼에서 **의도적으로 다른 것은 리뷰 반복의 종료 조건 하나**다. 소유자가 "각자 유지"로 정했다(08장 1절 「두 repo의 +종료 조건」). 백엔드는 발견이 0이 될 때까지 반복하고(09장 5절), 프론트는 자기 매뉴얼의 조건을 따른다. + ## 공용 리뷰 가이드와의 관계 지금까지 리뷰 기준으로 쓴 가이드는 프론트 repo의 `docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md`다.