update

- consumable items

prompt/00_project_context_restore.md

@@ -125,10 +125,11 @@
 - **[UI] Top-Aligned Toast:** SnackBar를 상단 토스트 알림으로 교체하여 하단 네비게이션 가림 현상 해결 및 애니메이션 버그 수정.
 - **[Fix] Asset 404 Error:** 적 이미지 누락 문제 해결(Placeholder 적용) 및 `pubspec.yaml` 경로 업데이트.
 - **[Refactor] ShopUI:** 상점 UI의 문법 및 로직 오류 수정.
+- **[Feature] Consumable Items:** 체력/방어/공격버프 물약 구현. 전투 중 사용 가능하며, 사용 시 턴을 소모하지 않음(Free Action). 상점에서 판매.
 - **[Feature] Enhanced Enemy Display:** 적 이미지 동적 로딩 및 크기 확대, 스테이지 헤더에 Boss/Tier 정보 상세 표시.
 
 ## 5. 다음 단계 (Next Steps)
 
 1.  **밸런싱:** 현재 몬스터 및 아이템 스탯 미세 조정.
 2.  **콘텐츠 확장:** 더 많은 아이템, 적, 스킬 패턴 추가.
-3.  **튜토리얼:** 신규 유저를 위한 가이드 추가.
+3.  **튜토리얼:** 신규 유저를 위한 가이드 추가.

prompt/66_consumable_items.md

@@ -0,0 +1,42 @@
+# Consumable Items (Potions) Implementation
+
+## Objective
+
+Implement a consumable item system to provide immediate effects or short-term buffs during battle.
+
+## Features
+
+### 1. New Item Type: Consumables
+
+- Category: `EquipmentSlot.consumable`
+- Items:
+  1.  **Healing Potion**: Restores HP immediately.
+  2.  **Ironskin Potion (Armor)**: Grants Armor immediately.
+  3.  **Strength Potion**: Grants "Attack Up" buff for 1 turn.
+
+### 2. Battle Mechanics
+
+- **Usage**: Consumables can be used from the inventory during the player's turn.
+- **Action Cost**: Usage is a **Free Action** (does not consume the turn). Players can use a potion and then Attack/Defend in the same turn.
+- **Effects**:
+  - **Heal**: `hp += value` (capped at maxHp)
+  - **Armor**: `armor += value`
+  - **Buff**: Apply `StatusEffectType.attackUp` (increases damage by 20% or flat amount).
+
+### 3. Shop Update
+
+- Shop now stocks **6 items** total:
+  - 4 Equipment (Weapons/Shields/Armor/Accessories)
+  - 2 Consumables (Potions)
+
+### 4. UI Updates
+
+- **Battle Controls**: Added an "Items" button (Bag icon) to open the battle inventory.
+- **Shop UI**: Updated to display and sell consumable items.
+- **Battle Inventory**: A dialog to view and use owned consumable items.
+
+## Technical Details
+
+- `Item` model updated to handle `hpBonus` (Heal), `armorBonus` (Armor), and `effects` (Buffs) for consumables.
+- `BattleProvider.useItem(Item)` implements the application logic.
+- `CombatCalculator` logic handles the `Attack Up` status effect multiplier.