- 사용자 제공 일러스트로 임시 그래픽(창고 변형) 교체 - 아이콘 시트는 좌우 분리 후 배경 제거, 원본은 assets-src에 보존 (workshop.png, material_icons.png) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
@AGENTS.md
고양이 마을 — 게임개발 팀 규칙
이 프로젝트는 3인 에이전트 팀으로 운영한다 (.claude/agents/ 참조):
| 에이전트 | 담당 | 엔진 |
|---|---|---|
pm |
기획서 작성, 작업 분배, 결과 취합 | Claude |
dev |
코드 구현, 빌드/린트 통과 | Claude |
tester |
Playwright 브라우저 테스트, 세이브 데이터 검증 | Claude |
이미지·스프라이트·목업은 사용자가 직접 제공한다. 에이전트는 이미지를 생성하지 않는다.
위임 기준
- 직접 처리 OK: 1개 파일 단순 수정(오타·라벨·상수), 조회/탐색, 일반 대화
- pm 경유 필수: 2개 이상 파일 수정, 신규 기능/시스템, 밸런스 수치 변경, 세이브 스키마 변경
작업 흐름
- pm 호출 → 기획서
~/.claude/tasks/cat-village/{번호}-{제목}.md(Task ID:TASK:CATV-{번호}) [확인필요]항목 있으면 사용자에게 먼저 질문 (dev 호출 금지)- (에셋 필요 시) 기획서의 "아트 요구사항" 섹션을 사용자에게 전달하고 이미지 수령 대기
- 받은 원본은
assets-src/에 보존, 게임에서 로드할 최종본은public/assets/에 배치 - 이미지 없이도 진행 가능한 부분은 dev가 placeholder로 먼저 구현 가능
- 받은 원본은
- dev 호출 — 기획서 경로 + 수정 파일 경로 전달
- tester 호출 — 기획서의 테스트 계획 전문을 직접 전달 (경로만 주지 말 것).
400_FAIL이면 dev에 재현 방법과 함께 재전달 → 수정 후 재테스트 - 완료 = 코드 수정 +
npm run build/npm run lint통과 + tester200_OK. 배포는 별개의 명시적 요청.
상태 코드·기획서 필수 항목 등 공통 규약은 ~/CLAUDE.md(글로벌)를 따른다.
교훈 파일: ~/.claude/lessons-learned/cat-village.md
게임 원칙 (모든 기획·구현에 적용)
개체 애착 / 슬롯 압박 / 병목은 항상 하나 / 자동화는 보상 / 초기화 없음 — 상세는 docs/GAME_DESIGN.md