From d82a534d23bac1434d6818463dc7a0ea453def43 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 22:27:58 +0900 Subject: [PATCH] =?UTF-8?q?revert:=20operate.md=20=EC=A4=84=20=EC=A4=84?= =?UTF-8?q?=EC=9D=B4=EA=B8=B0=EB=A5=BC=20PR=20#15=EC=97=90=20=EB=A7=A1?= =?UTF-8?q?=EA=B8=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 이 브랜치의 c0d7ad8f("operate.md를 150줄 안으로 줄이고 묶음 ID를 뺀다")를 되돌린다. 백엔드 CI 세션이 같은 줄을 PR #15(caa71d32)에서 다르게 고쳤고(4.4절 두 줄을 합쳐 150줄, ID 삭제), check-work-docs.py를 prCheck에 넣었다(13ed3a1d). 두 PR이 같은 줄을 고치면 병합 충돌이 난다. 위험·한계: PR #15가 병합되기 전에는 main의 operate.md가 151줄이고 "(W4 BE-OBS-A)"가 남아, 이 브랜치가 더한 ID 꼴 검사와 줄 수 검사로 check-work-docs.py가 rc=1이다. 지금 prCheck는 그 검사를 돌리지 않으므로 PR 단계는 막히지 않는다. #15가 병합되면 둘 다 풀린다. 검증: git diff origin/main -- docs/work/operate.md가 57·87줄의 /src 절차만 남는다. scripts/tests 158건 통과. --- docs/work/operate.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/work/operate.md b/docs/work/operate.md index 83365b17..72312b7b 100644 --- a/docs/work/operate.md +++ b/docs/work/operate.md @@ -113,10 +113,11 @@ ssh desktop 'cd ~/workspace/<작업 이름> && git add -A && git write-tree' - 파생 서비스는 이 템플릿을 받아 도메인을 채운 repo다. 템플릿 변경을 두 방식으로 받는다: 기준 커밋을 적은 tracked snapshot에 3-way로 반영하거나(`template.lock.json`), `git merge upstream/main`을 한다. - 템플릿 쪽에서 할 일: 파생 서비스가 따라 고쳐야 하는 변경은 `docs/upgrade/`의 안내에 행을 더하고 커밋 제목에 `!`를 단다. 안내 문서 형식은 `docs/upgrade/2026-11-maturity-review.md`다. -- 파생 서비스가 유지할 게이트와 지워도 되는 템플릿 전용 게이트는 `docs/ci-cd/template-vs-consumer.md`다. 요청률 제한을 어디서 거는지(앱은 기본 off, 앞단 책임)는 파생 서비스가 배포 설계에 정한다: [docs/security/rate-limiting.md](../security/rate-limiting.md) 「파생 서비스가 정할 것」. +- 파생 서비스가 유지할 게이트와 지워도 되는 템플릿 전용 게이트는 `docs/ci-cd/template-vs-consumer.md`다. - 파생 서비스의 동기화는 루트 `CLAUDE.md`를 걸러낸다. 그래서 파생 서비스는 자기 `CLAUDE.md`에 `@AGENTS.md` 한 줄을 두고, 지도(`AGENTS.md`)에서 `docs/work/README.md`를 가리켜야 한다. `docs/work/`는 걸러지지 않는다. - `.claude/`의 추적 파일(`settings.json`의 권한과 훅, `rules/`, `skills/`, `agents/`)은 함께 넘어간다. 훅 본체는 `scripts/hooks/`다. 한 설정 단계에서 deny된 도구는 다른 단계(`settings.local.json`, 사용자 설정)의 allow로 풀리지 않는다(Claude Code 권한 문서 「Settings precedence」). 파생 서비스가 `.env` 읽기 차단 같은 권한을 바꾸려면 그 파일을 자기 repo에서 고친다. - 파생 서비스 쪽 병합과 그 게이트는 그 repo의 일이다. 템플릿 세션이 파생 서비스 repo를 고치지 않는다. +- 파생 서비스는 **요청률 제한을 어디서 거는지** 배포 설계에 정한다: 앱은 기본 off(요청 빈도는 ingress/gateway 책임), 앞단에서 안 걸면 앱 내 redis limiter를 켠다. 자세와 켜는 법은 [docs/security/rate-limiting.md](../security/rate-limiting.md)(W4 BE-OBS-A). ## 5. 완료 기준