# 종합 기획서·개발 현황

I Hate Jelly의 플레이 경험, 콘텐츠와 현재 개발 상태를 함께 확인합니다.


상태: **구현 현황 정리·기획 기준** · 설명 확인일: **2026-10-28**

모바일에서 젤리를 자르고, 얇게 썰고, 틀로 찍고, 날아가는 젤리를 베거나 곰 젤리를 눌러 즐기는 3D 촉감 게임이다. 짧은 판에서 명확한 조작과 결과를 경험하고, 별을 모아 장비 외관을 교체한다.

이 문서는 **현재 저장소를 이해하는 팀원**과 **다음 개발을 함께하는 AI**가 같은 용어·스테이지·완료 기준을 사용하기 위한 공통 문서다. 현재 구현 목록은 코드에서 생성하며, 구현과 실기기 검증·출시는 별개로 기록한다.

## 먼저 볼 문서

| 알아볼 내용 | 문서 |
|---|---|
| 조작·목표·채점과 모드별 차이 | [플레이 모드·규칙](https://jelly-docs.steadyloop.dev/modes/) |
| 구현된 종류와 실제 배치 여부 | [젤리 도감](https://jelly-docs.steadyloop.dev/catalog/jellies/) |
| 장비 3분류·가격·실제 모델 | [장비·별 상점](https://jelly-docs.steadyloop.dev/catalog/equipment/) |
| 현재 표시 번호·고정 ID·판별 목표 | [전체 스테이지](https://jelly-docs.steadyloop.dev/catalog/stages/) |
| 구현·검증 기록·출시 전 확인 | [개발 현황·남은 과제](https://jelly-docs.steadyloop.dev/status/) |
| AI에게 전달할 문서와 갱신 방법 | [AI 협업·문서 갱신](https://jelly-docs.steadyloop.dev/collaboration/) |

## 제품과 개발 방향

- **핵심 경험:** 입력에 반응하는 젤리 변형·절단면·출렁임, 장비 움직임, 소리와 진동으로 손맛을 전달한다.
- **판 단위 목표:** 정확도·균등 분할·타이밍·리듬·적은 휘두르기·압착 위치·다른 모양 찾기를 각각 다르게 제시한다.
- **진행:** 판별 별 기록과 진행을 저장하고 History에서 재도전한다. 도감과 장비 상점은 플레이 결과를 모으는 동기다.
- **제작 방식:** TypeScript + Three.js(WebGL2) + GLSL + Vite. 3D 젤리·장비는 절차 생성한다. 홈 로고와 Play에는 승인된 PNG, 절단음에는 승인된 WAV를 사용한다.
- **플랫폼:** 같은 웹 코드를 Capacitor 8로 iOS·Android에 포함한다. 앱은 번들 콘텐츠를 사용하며 `server.url`이 없다. 폰은 세로, 태블릿은 회전·크기 변경을 지원한다.

## 이름·상태를 읽는 기준

홈 제목은 **I Hate Jelly**다. 저장소·기존 스펙에는 **Jelly Slice / Jelly Cutting**, 앱 식별에는 `game.steadyloop.jelly`가 남아 있다. 이번 문서 작성이 앱 이름 변경이나 스토어 출시를 의미하지 않는다.

**확정/구현**은 코드나 승인된 규칙이 있다는 뜻이다. **시제품**은 동작이 있지만 체감·최종 규칙 확인이 남은 단계다. **검증 대기**는 실기기·시각·권리 등 확인이 남았다는 뜻이며, **계획**은 구현 완료와 구분한다.

문서 최초 작성은 로컬 검증까지 진행했고, 이후 별도 배포 요청으로 **[jelly-docs.steadyloop.dev](https://jelly-docs.steadyloop.dev)**에 공개했다. 운영 게임과 문서 사이트는 서로 다른 Worker다. 자동 배포의 반영·검증 상태는 [개발 현황](https://jelly-docs.steadyloop.dev/status/)을 따른다.

## 근거

[저장소 작업 규칙](https://jelly-docs.steadyloop.dev/sources/AGENTS.md.txt), [개발 이력 원문](https://jelly-docs.steadyloop.dev/sources/PROGRESS.md.txt), [플랫폼 설정](https://jelly-docs.steadyloop.dev/sources/capacitor.config.ts.txt), [문서 생성 근거·확인 시점](https://jelly-docs.steadyloop.dev/catalog/stages/).