diff --git a/CLAUDE.md b/CLAUDE.md index ea92487b..892e0558 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -13,10 +13,17 @@ exists in Flutter: opened the Flutter file in this session, you have not earned the right to write the Android version. -2. **Replicate it exactly.** Match the behavior, the layout structure, the - section order, the empty/loading/error states, the copy strings, the data - sources, and the edge cases. Same number of rows, same fields per row, same - tap targets. +2. **Replicate the user-visible behavior exactly; implement it idiomatically.** + Match what the user sees and feels: layout structure, section order, empty/ + loading/error states, copy strings, edge cases, and — critically — the + **responsiveness** (the app caches to make the UI feel instant; preserve + that). But you do NOT have to copy Flutter's *implementation*. Flutter uses + drift `watch()` + Riverpod `invalidate`; the well-supported Android idioms + are Room + Flow, Compose state, WorkManager, Media3. **Prefer the native + mechanism that delivers the same or better UX** over a literal transliteration + of the Dart. Exact on behavior + feel; idiomatic on structure. If a more + native approach genuinely improves the experience, do that (and note it in + the parity map as an intentional, better-supported divergence). 3. **Never silently substitute a different design.** If the faithful port seems hard, blocked, or impossible, STOP and verify by reading more of the Flutter