@AGENTS.md

# 고양이 마을 — 게임개발 팀 규칙

이 프로젝트는 3인 에이전트 팀으로 운영한다 (`.claude/agents/` 참조):

| 에이전트 | 담당 | 엔진 |
|---|---|---|
| `pm` | 기획서 작성, 작업 분배, 결과 취합 | Claude |
| `dev` | 코드 구현, 빌드/린트 통과 | Claude |
| `tester` | Playwright 브라우저 테스트, 세이브 데이터 검증 | Claude |

**이미지·스프라이트·목업은 사용자가 직접 제공한다.** 에이전트는 이미지를 생성하지 않는다.

## 위임 기준

- **직접 처리 OK**: 1개 파일 단순 수정(오타·라벨·상수), 조회/탐색, 일반 대화
- **pm 경유 필수**: 2개 이상 파일 수정, 신규 기능/시스템, 밸런스 수치 변경, 세이브 스키마 변경

## 작업 흐름

1. pm 호출 → 기획서 `~/.claude/tasks/cat-village/{번호}-{제목}.md` (Task ID: `TASK:CATV-{번호}`)
2. `[확인필요]` 항목 있으면 사용자에게 먼저 질문 (dev 호출 금지)
3. (에셋 필요 시) 기획서의 "아트 요구사항" 섹션을 사용자에게 전달하고 이미지 수령 대기
   - 받은 원본은 `assets-src/`에 보존, 게임에서 로드할 최종본은 `public/assets/`에 배치
   - 이미지 없이도 진행 가능한 부분은 dev가 placeholder로 먼저 구현 가능
4. dev 호출 — 기획서 경로 + 수정 파일 경로 전달
5. tester 호출 — 기획서의 **테스트 계획 전문을 직접 전달** (경로만 주지 말 것). `400_FAIL`이면 dev에 재현 방법과 함께 재전달 → 수정 후 재테스트
6. 완료 = 코드 수정 + `npm run build`/`npm run lint` 통과 + tester `200_OK`. **배포는 별개의 명시적 요청.**

상태 코드·기획서 필수 항목 등 공통 규약은 `~/CLAUDE.md`(글로벌)를 따른다.
교훈 파일: `~/.claude/lessons-learned/cat-village.md`

## 게임 원칙 (모든 기획·구현에 적용)

**개체 애착 / 슬롯 압박 / 병목은 항상 하나 / 자동화는 보상 / 초기화 없음** — 상세는 `docs/GAME_DESIGN.md`