From 2921f596a5e14b93bcbeb7dab61221ae71ca5c3d Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 8 Nov 2026 11:29:55 +0900 Subject: [PATCH] =?UTF-8?q?feat(harness):=20=ED=95=98=EB=84=A4=EC=8A=A4=20?= =?UTF-8?q?=ED=94=8C=EB=9F=AC=EA=B7=B8=EC=9D=B8=20harness@claude-harness?= =?UTF-8?q?=EB=A5=BC=20=EC=BC=A0=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 공통 훅·스킬(되돌릴 수 없는 명령 차단 H12, 비밀 값 알림, 예측·실측 장부 기록, estimate·retro·techdebt)은 claude-harness repo의 플러그인이 준다. 이 repo는 그 플러그인을 켜지 않아 새 세션이 그것들을 받지 못했다. .claude/settings.json에 extraKnownMarketplaces(claude-harness, git URL)와 enabledPlugins를 더했다. 기존 deny와 repo 훅은 그대로다. 사용자 전역에 같은 H12가 등록돼 있으면 플러그인 H12는 스스로 아무것도 하지 않는다 (소유자 기계가 그렇다). 비대화형(claude -p)은 플러그인을 자동 설치하지 않으므로 CLAUDE.md와 docs/upgrade/2026-11-harness.md 9번에 수동 설치 두 명령을 적었다. 위험: 이 세션은 ~/.claude를 바꾸지 않으므로 플러그인 설치 자체는 하지 않았다. 대화형 앱이 처음 열 때 설치를 묻는지는 확인하지 않았다(claude- harness README도 같은 미확인). 검증: settings.json JSON 파싱, check-work-docs.py rc=0(CLAUDE.md 10/10줄). --- .claude/settings.json | 11 +++++++++++ CLAUDE.md | 1 + docs/upgrade/2026-11-harness.md | 1 + 3 files changed, 13 insertions(+) diff --git a/.claude/settings.json b/.claude/settings.json index 4be5930d..24efbd66 100644 --- a/.claude/settings.json +++ b/.claude/settings.json @@ -39,5 +39,16 @@ ] } ] + }, + "extraKnownMarketplaces": { + "claude-harness": { + "source": { + "source": "git", + "url": "https://git.learn.hyeonworks.com/donghyeon.kang/claude-harness.git" + } + } + }, + "enabledPlugins": { + "harness@claude-harness": true } } diff --git a/CLAUDE.md b/CLAUDE.md index f30f0dfc..dcecaf6b 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -3,6 +3,7 @@ ## Claude Code에서만 - 권한과 훅은 `.claude/settings.json`이다: 편집 직후 Java 한 파일 포맷·레이어 의존 알림·문서 검사, 턴 끝 desktop 검증 알림, 적용된 migration 편집 차단, 실제 `.env` 읽기 차단. 훅마다 하는 일과 시험은 `scripts/hooks/README.md`다. +- 공통 훅·스킬(되돌릴 수 없는 명령 차단, 비밀 값 알림, 장부, `estimate`·`retro`·`techdebt`)은 하네스 플러그인 `harness@claude-harness`다(같은 settings가 켠다). 비대화형(`claude -p`)은 설치하지 않으니 claude-harness README의 `--scope project` 두 명령을 한 번 돌린다. - 경로별 규칙(테스트·설정·Docker·문서)은 `.claude/rules/`에 있다. 그 경로의 파일을 열 때 읽힌다. - 스킬은 `.claude/skills/`다: `new-feature`(새 기능), `desktop-gates`(Gradle·Docker를 desktop에서). 발동 조건이 설명에 있어 모델이 부른다. - 서브에이전트는 `.claude/agents/`다: `arch-reviewer`(구조 리뷰), `verify-api`(desktop에서 앱 띄워 확인), `code-simplifier`(단순화 제안). 모두 결과만 돌려주고 파일을 고치지 않는다. diff --git a/docs/upgrade/2026-11-harness.md b/docs/upgrade/2026-11-harness.md index 7a3e871e..2850bde2 100644 --- a/docs/upgrade/2026-11-harness.md +++ b/docs/upgrade/2026-11-harness.md @@ -19,3 +19,4 @@ | 6 | repo 스킬 둘을 더했다: `.claude/skills/new-feature`(새 기능 실행 순서), `.claude/skills/desktop-gates`(Gradle·Docker를 desktop에서 돌리는 순서). 모델이 설명의 발동 조건을 보고 부른다. 설치된 스킬이 없던 `skills-lock.json`을 지웠다. `.gitignore`에 `!.claude/skills/`를 더했다 | `desktop-gates`는 소유자 환경을 가정하므로 서비스 환경에 맞게 고치거나 지운다. 서비스가 `skills-lock.json`을 썼다면 merge에서 삭제 충돌이 난다. 쓰면 남긴다 | | 7 | 예측·실측 장부 `docs/ledger/estimates.jsonl`(형식 `docs/ledger/README.md`)을 두었다. `.gitattributes`가 이 파일에 `merge=union`을 준다 | 서비스는 템플릿의 줄을 지우고 자기 작업의 줄부터 쌓는다. 템플릿 줄은 템플릿 작업의 기록이다 | | 8 | 지역 규칙이 200줄을 넘던 셋(`src/application-core`, `src/adapter/outbound/persistence-jpa`, `src/adapter/inbound/graphql`)의 표와 계약을 같은 폴더 `README.md` 끝 「지역 규칙에서 옮긴 표와 계약」 절로 옮겼다. 템플릿 패키지 목록(「패키지 소유」 표)의 정본도 `src/application-core/README.md`다 | 서비스가 그 절을 고쳤다면 README의 같은 절로 옮긴다. 서비스 문서·테스트가 `src/application-core/AGENTS.md`의 「Package ownership」 표를 읽으면 `README.md`로 바꾼다 | +| 9 | `.claude/settings.json`에 하네스 플러그인 마켓(`extraKnownMarketplaces`의 `claude-harness`, git URL `https://git.learn.hyeonworks.com/donghyeon.kang/claude-harness.git`)과 `enabledPlugins: {"harness@claude-harness": true}`를 더했다(2026-11-08). 플러그인이 되돌릴 수 없는 명령 차단(H12), 비밀 값 알림, 장부 기록 훅과 `estimate`·`retro`·`techdebt` 스킬을 준다. 사용자 전역에 같은 H12 훅이 있으면 플러그인 H12는 아무것도 하지 않는다. 기존 deny와 repo 훅은 그대로다 | 서비스가 `.claude/settings.json`을 고쳤다면 두 키를 합친다. 대화형 Claude Code는 폴더를 처음 믿을 때 설치를 묻는다. 비대화형(`claude -p`)이면 그 폴더에서 `claude plugin marketplace add <위 URL> --scope project`와 `claude plugin install harness@claude-harness --scope project`를 한 번 돌린다. 플러그인을 쓰지 않으려면 두 키를 지운다 |