@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 을 만들지 않는다.** 그건 회귀를 숨기는 것이다.
- 작업 결과를 보고할 때 테스트 수를 실제 출력에서 인용한다. 기억으로 쓰지 않는다.