문제: 하네스에 분야 지식이 없다. 영속성·메시징·보안·관측·성능·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.
11 lines
1.5 KiB
Markdown
11 lines
1.5 KiB
Markdown
@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절, 보고 형식은 소유자 전역 설정이다.
|