From caa71d3228d452704374efbe69a400dccaf969dc Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 21:08:17 +0900 Subject: [PATCH] =?UTF-8?q?docs(work):=20operate.md=EB=A5=BC=20=EC=A4=84?= =?UTF-8?q?=20=EC=83=81=ED=95=9C=20=EC=95=88=EC=9C=BC=EB=A1=9C=20=EB=90=98?= =?UTF-8?q?=EB=8F=8C=EB=A6=B0=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit main(a7e38c10)에 들어온 요청률 제한 한 줄로 docs/work/operate.md가 151줄이 됐다. check-work-docs.py의 상한은 150줄이라 scripts/verify.sh docs가 main에서 실패한다. 같은 줄 끝의 「(W4 BE-OBS-A)」는 새 세션이 따라갈 수 없는 작업 이력 ID다. 같은 절에서 템플릿 전용 게이트 문서를 가리키는 줄과 파생 서비스 쪽 병합·게이트는 그 repo의 일이라는 줄을 한 항목으로 합쳤다. 둘 다 「파생 서비스의 게이트는 누구 몫인가」를 말한다. 요청률 제한 줄은 내용을 그대로 두고 이력 ID만 뺐다. 검증: scripts/verify.sh docs(노트북) rc=0, operate.md 150/150. --- docs/work/operate.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/work/operate.md b/docs/work/operate.md index 2096342b..ad36a4d3 100644 --- a/docs/work/operate.md +++ b/docs/work/operate.md @@ -113,11 +113,10 @@ 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`다. +- 파생 서비스가 유지할 게이트와 지워도 되는 템플릿 전용 게이트는 `docs/ci-cd/template-vs-consumer.md`다. 파생 서비스 쪽 병합과 그 게이트는 그 repo의 일이고, 템플릿 세션은 파생 서비스 repo를 고치지 않는다. - 파생 서비스의 동기화는 루트 `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). +- 파생 서비스는 **요청률 제한을 어디서 거는지** 배포 설계에 정한다: 앱은 기본 off(요청 빈도는 ingress/gateway 책임), 앞단에서 안 걸면 앱 내 redis limiter를 켠다. 자세와 켜는 법은 [docs/security/rate-limiting.md](../security/rate-limiting.md)다. ## 5. 완료 기준