00. 프로젝트 컨텍스트 및 복구 (Project Context & Restore Point)

이 파일은 다른 개발 환경이나 새로운 AI 세션에서 프로젝트의 현재 상태를 빠르게 파악하고 작업을 이어가기 위해 작성되었습니다.

1. 프로젝트 개요

턴제 전투: 플레이어 턴 -> 적 턴.
행동 선택: 공격(Attack) / 방어(Defend).
리스크 시스템: 행동 시 Safe(100% 성공, 50% 효율), Normal(80% 성공, 100% 효율), Risky(40% 성공, 200% 효율) 중 선택 가능.
상태이상 (Status Effects):
- Stun: 행동 불가.
- Bleed: 턴 시작 시 지속 피해.
- Vulnerable: 받는 피해 1.5배 증가.
- DefenseForbidden: 방어 행동 불가.
- 특이사항: 적에게 건 디버프는 플레이어 턴 시작 시 감소함 (직관성).

장비: 무기, 방어구, 방패, 장신구 슬롯.
아이템 효과 (ItemEffect): 아이템 공격 시 확률적으로 상태이상 부여 (예: 20% 확률로 기절).
경제:
- Gold 시스템 구현됨.
- 아이템마다 스탯 기반 price 자동 산출.
- 상점 스테이지에서 판매(Sell) 기능 구현됨.
- 인벤토리에서 장착(Equip), 버리기(Discard), 판매(Sell) 가능.

스테이지 진행: currentStage 객체로 관리.
타입 분기:
- Battle: 일반 몬스터 전투.
- Shop: (5, 15... 스테이지) 상점 화면. (현재 판매만 가능, 구매 UI 미구현)
- Rest: (8, 18... 스테이지) 휴식 화면. (HP 회복)
- Elite: (10, 20... 스테이지) 강력한 적 등장.

lib/providers/battle_provider.dart: 게임의 Core Logic을 담당하는 거대 Provider. 상태 관리, 전투 계산, 스테이지 생성 등을 모두 처리.
lib/game/model/:
- entity.dart: Character 클래스 (Player/Enemy 공용).
- item.dart: Item, ItemEffect.
- stage.dart: StageModel, StageType.
- status_effect.dart: 상태이상 정의.
lib/game/data/item_table.dart: 아이템 템플릿 데이터.
lib/screens/:
- battle_screen.dart: 전투 및 스테이지 상황(상점/휴식) UI.
- inventory_screen.dart: 인벤토리 및 장비 관리 UI.

Prompt Driven Development: 새로운 기능을 구현할 때마다 prompt/XX_description.md 파일을 생성하여 작업 목표와 내용을 기록한다.
State Management: Provider 패키지를 사용하며, 로직은 주로 BattleProvider에 집중시킨다.
Data Preservation: 하드코딩된 데이터(ItemTable)를 사용 중이며, DB는 연동되지 않음.

이 프롬프트를 읽은 AI 에이전트는 위 내용을 바탕으로 즉시 개발을 이어가십시오.