docs(claude): verify-api가 verify.sh로 앱을 띄우게 한다

문제: verify-api 서브에이전트는 desktop worktree에서
`flock /tmp/claude-gates/heavy.lock scripts/bootstrap-local.sh`를 직접 돌린다.
bootstrap-local.sh의 ./gradlew에는 --no-daemon이 없어 desktop에 Gradle
daemon이 남는다(여러 worktree를 받은 daemon이 compiler worker를 쌓아
메모리를 채운 일이 있다). 5단계가 따르라는 "4.1절의 정리법"은 operate.md에
없다.

고른 방법: `scripts/verify.sh app --on here`로 부른다. verify.sh가 공유
잠금을 잡고 GRADLE_OPTS로 daemon을 끈 채 같은 스크립트를 부른다. 앱은
compose로 떠 있으니 4단계 호출은 그대로다. 정리는 compose down과
git worktree remove만 적고, 못 지우면 보고에 남기게 한다.
버린 대안: bootstrap-local.sh의 ./gradlew에 --no-daemon을 붙이기 — 사람이
노트북에서 처음 돌릴 때는 daemon이 이득이라 스크립트 기본값은 두고,
desktop 쪽 진입점(verify.sh)이 끈다.

검증: test_verify_api_runs_the_app_on_the_desktop_under_the_shared_lock을
새 절차로 바꿨다(verify.sh app --on here와 git worktree remove를 요구하고,
잠금만 두른 직접 호출과 "정리법"을 거절). 기준 verify-api.md에서 실패,
고친 파일에서 통과. test_claude_setup 16건 통과.
This commit is contained in:
DongHyeonka
2026-11-12 21:40:19 +09:00
parent a638698fc8
commit f75a455651
2 changed files with 8 additions and 4 deletions
+6 -2
View File
@@ -140,9 +140,13 @@ class SubagentTest(unittest.TestCase):
def test_verify_api_runs_the_app_on_the_desktop_under_the_shared_lock(self) -> None:
text = (AGENTS / "verify-api.md").read_text(encoding="utf-8")
for fragment in ("docs/work/operate.md", "flock /tmp/claude-gates/heavy.lock", "scripts/bootstrap-local.sh",
"stash@{0}", "down"):
# verify.sh takes the shared lock and turns the Gradle daemon off; a bare flock around the bootstrap script
# left a daemon behind on the desktop, and the cleanup it pointed at was in no manual.
for fragment in ("docs/work/operate.md", "scripts/verify.sh app --on here", "scripts/bootstrap-local.sh",
"stash@{0}", "down", "git worktree remove"):
self.assertIn(fragment, text)
self.assertNotIn("heavy.lock scripts/bootstrap-local.sh", text)
self.assertNotIn("정리법", text)
class SkillTest(unittest.TestCase):