Files
clean-architecture-backend-…/CLAUDE.md
T
DongHyeonka 2921f596a5 feat(harness): 하네스 플러그인 harness@claude-harness를 켠다
공통 훅·스킬(되돌릴 수 없는 명령 차단 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줄).
2026-11-08 11:29:55 +09:00

1.3 KiB

@AGENTS.md

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(단순화 제안). 모두 결과만 돌려주고 파일을 고치지 않는다.
  • 소유자 환경: Gradle·Docker·테스트는 desktop에서만 돈다(docs/work/operate.md 4.1절). 세션 규칙은 docs/work/delegate.md 4.3절, 보고 형식은 소유자 전역 설정이다.