Files
clean-architecture-backend-…/CLAUDE.md
T
DongHyeonka c611b06f03
pr / vulnerabilities (pull_request) Canceled after 0s
pr / done (pull_request) Canceled after 0s
pr / gradle (pull_request) Canceled after 8m18s
feat(claude): 분야 전문가를 지식 스킬 열 개와 렌즈 리뷰어로 두고 협업 명단을 붙인다
문제: 하네스에 분야 지식이 없다. 영속성·메시징·보안·관측·성능·API 계약·
빌드·시험·문서·도메인의 이 repo 규칙(적용된 마이그레이션 금지, 잠금 상한,
동시 인덱스 빌드, env 키 레지스트리 등)은 문서에 흩어져 있어, 세션이 그
문서를 찾아 읽어야만 지킨다. 여러 분야에 걸친 일을 누가 보고 어떻게
합치는지도 정한 곳이 없다.

고른 방법(소유자 결정 2026-11-11 「W3 설계대로」):
- 지식 스킬 be-* 10개(.claude/skills/). 각자 paths를 걸어 그 분야 파일을
  만질 때만 목록에 뜬다. 본문은 언제 쓰나 → 함정 → 실패는 이렇게 보인다 →
  검증 → 이 repo에서 정한 것 순서이고, 정본 문서를 가리킨다. 초안은 이
  repo 문서만 본 서브에이전트가 썼고, 경로는 relayout 배치에 맞췄다.
- 서브에이전트 reviewer(렌즈 = brief의 스킬 경로). arch-reviewer는
  be-domain을 미리 싣고 lead 공통 양식으로 돌려준다.
- .claude/rules/expert-skills.md: 분야 파일을 고치기 전에 그 스킬의
  「함정」·「검증」을 보게 하는 두 줄(평가에서 스킬 호출이 5번 중 2번이었다).
- docs/work/experts.md: 명단·경로 → 렌즈·넘김 지도·충돌·비용. 루트
  AGENTS.md 한 줄, CLAUDE.md 두 줄 고침(10줄 상한 유지), README 3절 4단계와
  delegate.md 4.3절에 가리키는 말.
- 시험: 에이전트 넷, Agent 도구 금지, 설명 합 1,200자, 지식 스킬의 paths·
  설명 300자·금지어·절 순서·150줄, 모든 paths glob이 추적 파일에 걸림,
  명단이 모든 전문가를 담음.
버린 대안: 분야마다 서브에이전트. Anthropic 2026-10-22·2026-01-23·2026-04-07
글이 반대하고, 설명이 모든 세션에 든다.

위험: 플러그인 lead·new-expert·harness-eval은 claude-harness PR #3(0.3.0)이
병합돼야 받는다. 그전에는 lead를 가리키는 문장이 설명만 남는다.

검증: python3 -m unittest discover -s scripts/tests → 154건 통과. 새 시험 6개는
조건을 깰 때마다 실패했다. scripts/verify.sh docs → rc=0.
2026-11-11 23:19:44 +09:00

1.5 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에서), 분야 지식 be-* 10개(paths가 걸려 그 분야 파일을 만질 때 목록에 뜬다). 여러 분야면 플러그인 lead. 발동 조건이 설명에 있어 모델이 부른다.
  • 서브에이전트는 .claude/agents/다: reviewer(렌즈로 받은 be-* 스킬로 새 창에서 diff 판정), arch-reviewer(구조 리뷰), verify-api(desktop에서 앱 띄워 확인), code-simplifier(단순화 제안). 모두 결과만 돌려주고 파일을 고치지 않는다.
  • 소유자 환경: Gradle·Docker·테스트는 desktop에서만 돈다(docs/work/operate.md 4.1절). 세션 규칙은 docs/work/delegate.md 4.3절, 보고 형식은 소유자 전역 설정이다.