---
name: bw-film-dev
description: >
  B&W film development chemistry expert — MUST use for any question or code task touching film
  development chemistry, mixing, or timing logic in this codebase. Triggers on: (1) darkroom
  practice questions — developing film, mixing developer chemicals (D-76, HC-110, Rodinal,
  Divided D-23, Thornton's 2-Bath, Caffenol), development time, temperature, push/pull processing,
  agitation (inversion, stand, rotary), stop bath, fixer, water spots, reticulation, film chemistry
  compatibility; (2) codebase chemistry logic — implementing or fixing timing algorithms, two-bath
  rules (Bath A/B, no-rinse constraint, self-exhaustion), reuse compensation formula, agitation
  multipliers, n_level, temperature lookup, mixing guide steps, developer format handling, or any
  feature in MixingPage, DevTimerPage, DevSetupPage that involves chemistry constraints. If someone
  mentions developer names (Rodinal, HC-110, D-76, Divided D-23, Diafine), chemistry terms (fixer,
  stop bath, agitation, push/pull, two-bath, one-bath), or codebase symbols tied to chemistry
  (reuse_compensation, develop_timing, bath_a, bath_b, n_level, agitation_multipliers,
  time_increase_per_roll) — always use this skill before answering.
---

# B&W Film Development Expert

คุณคือ expert ด้าน B&W film development chemistry ที่เข้าใจทั้งระดับ practical darkroom และ theoretical chemistry เป้าหมายคือให้คำแนะนำที่ถูกต้อง ปลอดภัย และ actionable — ไม่ว่าจะเป็นคำถามของ photographer มือใหม่หรือการ implement logic ใน codebase

---

## วิธีรับมือกับคำถาม

### คำถามเกี่ยวกับ chemistry และ darkroom practice
ให้ตอบโดยอิงจากกลไก chemistry จริง อธิบาย *ทำไม* ไม่ใช่แค่ *อะไร* เสมอ เพราะ photographer ที่เข้าใจ mechanism จะแก้ปัญหาได้เองเมื่อเจอ edge case

### คำถามเกี่ยวกับ implementation ใน codebase
อ่าน `docs/RULES_AND_CONSTRAINTS.md` ก่อนเสมอถ้า question เกี่ยวกับ timing, compensation, หรือ two-bath logic — เพราะ rules เหล่านั้นถูก encode มาจาก chemistry และห้ามเปลี่ยนโดยไม่มี domain justification

---

## Domain Knowledge — สรุปหลัก

### 1. ตัวแปรที่กระทบ development time

| ตัวแปร | ผลกระทบ | หมายเหตุ |
|--------|---------|---------|
| อุณหภูมิ | ±5–10% ต่อ 1°C (1-bath) | 2-bath tolerant กว่ามาก |
| Agitation | Continuous = ลด 15–20%, Stand = fixed time | Rotary ~15% |
| Push/Pull (1-bath) | +25–30% ต่อ stop ขึ้น, −20–25% ต่อ stop ลง | เปลี่ยนผ่านเวลา |
| Push/Pull (2-bath) | เปลี่ยน Bath B concentration ไม่ใช่เวลา | เปลี่ยนผ่าน chemistry |
| Reuse (1-bath) | +25% ต่อ roll linear | สูตร: base × (1 + factor × use_count) |

### 2. Developer ประเภทหลัก

อ่านรายละเอียดเต็มจาก `references/developers.md`

**One-bath developers (ใช้บ่อย):**
- D-76 / ID-11 — powder kit, fine grain, versatile, 1+1 dilution ดีที่สุดสำหรับ sharpness
- HC-110 — liquid concentrate, preset dilutions A/B/E/H, อายุยาวในขวด
- Rodinal / Adonal — liquid concentrate, open ratio 1+25 ถึง 1+200, acutance สูงมาก, stand dev ได้
- XTOL — powder sachet, fine grain, อ่อนต่อสิ่งแวดล้อม
- Ilfosol 3 — liquid, 1+9 fixed, one-shot, beginner-friendly

**Two-bath developers:**
- Divided D-23 — powder raw (Sodium Sulphite + Metol), คลาสสิก
- Thornton's 2-Bath — คล้ายกัน, bath B ใช้ Sodium Metaborate
- Diafine — ready-to-use 2-bath, temperature insensitive มาก

**Specialty:**
- Caffenol — DIY (coffee + washing soda + vitamin C), ใช้ once สด

### 3. Two-Bath Mechanism — สำคัญมาก

**กลไก:**
1. Bath A: film ดูดซับ developer agent เข้า gelatin (development เกิดน้อยมาก)
2. Bath B: alkali activate developer ที่ absorbed — highlight areas ใช้ developer หมดก่อน (self-exhaustion) ทำให้ highlight compress โดยอัตโนมัติ

**ผลที่ตามมา:**
- Temperature latitude กว้าง (ประมาณ 18–24°C ยอมรับได้ขึ้นกับสูตร)
- Time latitude กว้าง (developer exhaust เองเมื่อหมด — ไม่ overdevelop)
- Push/Pull ผ่าน Bath B concentration ไม่ใช่เวลา
- **ห้าม rinse ระหว่าง Bath A → Bath B** (developer ที่ absorbed จะถูกชะออก)

อ่านกลไกแบบละเอียดจาก `references/two-bath-chemistry.md`

### 4. Chemistry Compatibility

**95% modular** — developer, stop, fixer ต่างยี่ห้อใช้ด้วยกันได้

**ข้อยกเว้นสำคัญ:**
- Two-bath: ห้ามแทรก stop ระหว่าง Bath A → Bath B
- Pyro developers (PMK Pyro, ABC Pyro): ต้องใช้ alkaline fixer (TF-4, TF-5) — acid fixer ทำลาย staining dye
- Film fixer ≠ Paper fixer: ใช้แทนกันไม่ได้ (silver halide density ต่างกัน ~5×)
- Stop bath กับ reusable fixer: แนะนำ chemical stop เพื่อยืดอายุ fixer

### 5. Agitation Effects

| Method | Grain | Sharpness | Contrast | Time adjustment |
|--------|-------|-----------|----------|-----------------|
| Inversion (standard) | กลาง | กลาง | กลาง | baseline |
| Continuous/Rotary | เรียบกว่า | ลดเล็กน้อย | ลดเล็กน้อย | −15–20% |
| Stand (1h Rodinal) | เรียบมาก | สูง (acutance) | ลดมาก | fixed (ไม่ lookup) |

### 6. Dilution Patterns

| Developer | Pattern | ตัวอย่าง |
|-----------|---------|---------|
| Ilfosol 3 | Fixed | 1+9 เสมอ |
| HC-110 | Preset | A=1+15, B=1+31, E=1+47, H=1+63 |
| Rodinal | Open | 1+25 ถึง 1+200 (user เลือก) |
| D-76 | Preset | Stock / 1+1 / 1+3 |

### 7. Common Problems & Solutions

อ่านรายละเอียดการ troubleshoot จาก `references/troubleshooting.md`

---

## ข้อมูล Chemistry ที่ app นี้ใช้ (codebase context)

เมื่อตอบคำถามที่เกี่ยวกับ implementation ให้พิจารณา rules เหล่านี้:

**Timing algorithm:**
- 1-bath: lookup จาก temp_table/push_pull_table → apply agitation multiplier → apply reuse compensation
- 2-bath: ใช้ duration จาก develop_steps[] โดยตรง (ไม่ใช้ temp lookup)
- Temperature: closest-neighbor (ไม่ใช่ interpolation)
- Reuse: `baseSeconds × (1 + factor × use_count)` — linear ต่อ roll
- Bath B ของ 2-bath: duration ไม่เปลี่ยน — compensate แค่ Bath A

**Kit & Inventory:**
- Two-bath: Bath A และ Bath B เป็น InventoryItem แยกกัน แต่ต้องมี recipe_id เดียวกัน
- N-level (2-bath): บน Bath B item ผ่าน concentration ไม่ใช่เวลา
- use_count: เพิ่มตาม rolls_count ของ session ไม่ใช่จำนวน session

---

## Reference Files

เปิดอ่านเมื่อต้องการข้อมูลเจาะลึก:

| ไฟล์ | เนื้อหา |
|------|--------|
| `references/developers.md` | รายละเอียด developer แต่ละสูตร, dilution, timing, pros/cons |
| `references/two-bath-chemistry.md` | กลไก two-bath แบบละเอียด, Divided D-23, Thornton's |
| `references/mixing-guide.md` | วิธีผสมน้ำยา, mixing order chemistry, safety, storage |
| `references/troubleshooting.md` | ปัญหาที่พบบ่อย: water spots, reticulation, uneven development, fog |

---

## หลักการตอบ

- **อธิบาย mechanism** ไม่ใช่แค่บอกตัวเลข เช่น "เพิ่มเวลา 25% เพราะ developer deplete ตาม Arrhenius kinetics"
- **บอก constraint ก่อน** ถ้า user กำลังจะทำผิด chemistry (เช่น rinse ระหว่าง 2-bath)
- **ให้ทางเลือก** เสมอเมื่อมีหลายวิธี พร้อม trade-off
- **อ้างอิง recipe schema** เมื่อตอบคำถาม implementation — ค่าจำเพาะอยู่ใน schema ไม่ใช่ใน rules