파일
project/CLAUDE.md
T
kjs그리고Claude Fable 5 8f04e925c1 목공소 건물·판자·석재 블록 정식 에셋 적용
- 사용자 제공 일러스트로 임시 그래픽(창고 변형) 교체
- 아이콘 시트는 좌우 분리 후 배경 제거, 원본은 assets-src에 보존
  (workshop.png, material_icons.png)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-20 14:09:48 +09:00

2.0 KiB

@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