docs(improvement): desktop 공유 잠금과 두 repo의 종료 조건 결정을 적는다
문제: 07장은 desktop 빌드를 "겹치지 않게"라고만 적고 잠금 파일을 정하지 않았다. 짝 프론트도 같은 desktop에서 돌려 부하와 포트(4173·4174)가 겹칠 수 있다. 또 두 repo 매뉴얼은 장 구성이 같은데, 리뷰 반복 종료 조건은 소유자가 "각자 유지"로 정해 서로 다르다. 이 차이가 매뉴얼에 없으면 같은 뼈대를 보고 같은 조건으로 오해한다. 방법: 07장 6절 절차와 규칙에 `flock /tmp/claude-gates/heavy.lock`을 넣고 한 줄 명령을 적는다(총괄 세션 지시). 08장 색인에 "두 repo의 종료 조건"과 "desktop 공유 잠금" 행을 더하고, 누가 칸에 "총괄 지시"·"정책" 뜻을 적는다. README의 프론트 뼈대 절과 09장 5절에 이 조건만 의도적으로 다르다고 적는다. 검증: 인용 경로·ID·링크·절 번호 대조 스크립트를 다시 돌렸다(새 불일치 없음). 문서 대조 lane은 push 뒤 desktop에서 잠금 아래 다시 돌린다.
This commit is contained in:
@@ -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 <heavy.lock>`)로 줄 세웠다
|
||||
(`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`으로 감싸 한 번에 하나, 끝나면 원래 브랜치로.
|
||||
|
||||
@@ -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절 |
|
||||
|
||||
@@ -105,6 +105,9 @@ brief는 하위 단위가 받는 유일한 맥락이다. 빠뜨린 것은 하위
|
||||
|
||||
예전 멈춤 기준("새 Important 0이면 멈춤", "Minor는 기록만")은 소유자가 거뒀다(`1103` README 16절, 08장 1절).
|
||||
|
||||
이 종료 조건은 이 repo의 것이다. 짝 프론트 repo는 다른 종료 조건을 쓴다. 소유자가 두 repo의 조건을 "각자 유지"로 정했다
|
||||
(08장 1절 「두 repo의 종료 조건」). 장 구성은 같고 이 조건만 다르다.
|
||||
|
||||
**코드로 고칠 수 없는 것**: 소유자 결정이 필요한 것만 남을 수 있다. 그것은 근거와 권하는 안을 붙여 질문으로 보고한다. 질문이
|
||||
답을 받으면 다시 고치기로 돌아간다.
|
||||
|
||||
|
||||
@@ -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`다.
|
||||
|
||||
Reference in New Issue
Block a user