releases/CLAUDE.md

@AGENTS.md

Claude Code 전용 지침

위 계약(AGENTS.md)이 기본이다. 아래는 이 저장소에서 Claude Code 가 쓰는 하네스 설명이다. 전체 설계와 운영법은 docs/HARNESS.md 에 있다.

자동으로 도는 검증 (내가 끌 수 없는 층)

• Stop 훅 — 턴을 끝내려 할 때 소스가 바뀌었으면 dotnet test 를 돌린다. 실패하면 종료가 차단되고 실패 내용이 돌아온다. 테스트를 깨둔 채로 턴을 끝낼 수 없다. 차단되면 변명하지 말고 고친다. 고칠 수 없으면 왜 못 고치는지 사용자에게 보고한다.
• SessionStart 훅 — 세션 시작 시 브랜치·변경 파일·마지막 검증 상태를 컨텍스트에 넣는다. 이 브리핑을 먼저 읽고 지금 저장소가 어떤 상태인지 파악한 뒤 움직인다.

훅 때문에 작업이 막히면 훅을 우회하거나 무력화하지 않는다. 원인을 고친다.

스킬 — 절차는 여기 있다

스킬	언제
/tdd	기능 추가·버그 수정. RED→GREEN→증거 사이클을 끝까지 진행
/verify	"다 됐나?" 확인. 빌드+테스트+문서 동기화까지 완료 기준 전체 점검
/release	Windows 설치자 / 원격 크로스플랫폼 빌드

절차를 기억에 의존해 재구성하지 말고 해당 스킬을 부른다.

이 저장소에서의 작업 태도

• 한국어로 답한다. 코드 식별자와 기술 용어는 원문 유지.
• 계획이 필요한 크기면 플랜 모드를 먼저 쓴다. 기준: 파일 3개 이상 변경, 또는 공개 API· 스레딩·dispose 순서 변경, 또는 어디를 고쳐야 할지 아직 모를 때.
• 탐색은 서브에이전트에게 맡긴다. "이 기능 어디 있지" 류의 넓은 검색은 Explore 로 위임하고 결론만 받는다. 파일 위치를 이미 아는 단건 확인은 직접 한다.
• 거대 파일 주의: MainWindow.xaml.cs(86KB)·MainWindow.xaml(55KB)은 통째로 읽지 말고 Grep 으로 위치를 찾아 필요한 구간만 Read 한다.
• 테스트를 지우거나 Skip 으로 무력화해서 GREEN 을 만들지 않는다. 그건 회귀를 숨기는 것이다.
• 작업 결과를 보고할 때 테스트 수를 실제 출력에서 인용한다. 기억으로 쓰지 않는다.