Files
claude-harness/template/CLAUDE.md
T
DongHyeonka bd6cbf0b2a feat(template): 새 프로젝트에 분야 전문가 명단 양식을 둔다
문제: new-project.sh로 만든 프로젝트에는 분야 전문가를 어디에 적고,
리드가 바뀐 경로로 무엇을 고르고, 넘김과 충돌을 어떻게 남기는지 정한
자리가 없다. lead 스킬은 그 repo의 docs/work/experts.md를 읽는다.

고른 방법: template/docs/work/experts.md(큰 그림 읽는 순서, 명단,
경로 → 렌즈, 넘김 지도, 정해 둔 충돌, 비용 재는 법)를 빈 양식으로 두고,
루트 AGENTS.md 「일하는 방식」에 한 줄, CLAUDE.md에 플러그인 새 스킬과
전문가 모양 한 줄을 더한다. 루트 40줄 상한은 그대로 지킨다.
버린 대안: 빈 .claude/skills·agents 예시 파일. 예시가 그대로 남으면
모든 세션 목록에 들어가는 빈 전문가가 된다.

위험: 양식만이라 채우기 전에는 lead가 경로표 없이 고른다(스킬이
그때는 바뀐 경로와 위험 신호로만 고르게 되어 있다).

검증: python3 -m unittest discover -s tests → 11건 통과
(새 시험: 양식의 여섯 절, AGENTS.md·CLAUDE.md가 가리키는지).
2026-11-11 22:05:18 +09:00

900 B

@AGENTS.md

Claude Code에서만

  • 권한은 .claude/settings.json이다: 실제 .env 읽기·쓰기를 막는다(.env.example 같은 예시는 막지 않는다).
  • 공통 훅과 스킬은 하네스 플러그인 harness@claude-harness가 준다: 되돌릴 수 없는 명령 차단, 비밀 값 알림, 예측·실측 장부 기록, estimate·retro·techdebt·lead(전문가 고르기·합치기)·new-expert(전문가 더하기)·harness-eval(하네스 판 비교, 시킬 때만). 플러그인 설명은 claude-harness repo의 README다.
  • 이 프로젝트만의 훅은 scripts/hooks/, 경로별 규칙은 .claude/rules/, 스킬은 .claude/skills/, 서브에이전트는 .claude/agents/에 둔다. 분야 전문가는 paths를 건 지식 스킬이고, 서브에이전트는 분야가 아니라 일(새 눈 리뷰·실행 검증)마다 둔다(docs/work/experts.md).