10–15 phiên trước freeze
Ghi build SHA, level, duration, vortex preview, chain length, remainingStarfish, turnsUsed, optimal/max, rating, hint usage, fail reason và một câu feedback mở. Solver proof không thay thế playtest cảm xúc.
Level Health Metrics
| Metric | Target | Quyết định tune |
|---|---|---|
| Pass rate L1 | ≥95% | Giảm tutorial hoặc làm Điểm Xoáy đầu rõ hơn. |
| Pass rate L2–L3 | ≥90% | Kiểm tra hiểu “ô trống trước cụm” và Chuỗi Xoáy. |
| First vortex chain time | <45 giây | Setup Chuỗi Xoáy x2 sớm hơn. |
| Preview usage | >80% | Tăng clarity/giá trị của preview. |
| Dead move rate | <15% | Giảm board bế tắc, tăng lựa chọn có nghĩa. |
| Retry after vortex near-miss | ≥60% | Tune replay, STOP copy và lời nhắc đồng hành. |
| Voluntary Next Level Rate | Đo theo level | Đo “one more level” thật, không suy từ pass rate. |
| Quit after fail | <10% | Giảm spike hoặc thêm relief. |
Xoáy Cứu Hộ Experience Metrics
Đo xem cách diễn giải mới có giúp người chơi hiểu capture, cảm nhận payoff và vẫn tự quyết định hay không.
| Metric / event | Câu hỏi | Decision |
|---|---|---|
vortex_preview_seen | Người chơi có thấy vòng nước tại Điểm Xoáy hợp lệ? | Nếu thấp, tăng contrast nhưng không đánh dấu hướng best. |
| Valid-empty comprehension | Người chơi có hiểu không phải mọi ô trống đều là xoáy? | Tune L2, tooltip và candidate fidelity. |
vortex_created | Preview có chuyển thành capture thật? | Tune STOP clarity và board setup. |
vortex_chain_length | Chuỗi Xoáy có tạo mastery và combo satisfaction? | Tune sow timing, VFX và level L3/L6/L7. |
vortex_near_miss | Người chơi có hiểu vì sao lệch một ô nên xoáy không hình thành? | Tune recap, ghost trail và vùng highlight. |
full_rescue_complete | Board đã đạt remainingStarfish === 0? | Ghi turnsUsed, optimalTurns, maxTurns và rating band. |
| Xoáy Hoàn Hảo Replay | Mastery badge có tạo replay hậu jam? | Tune badge condition, không khóa chapter. |
FLOW Experience Metrics
FLOW vẫn đo việc so sánh route và đọc Current; Xoáy đo hiểu capture và payoff.
| Metric / event | Câu hỏi | Decision |
|---|---|---|
flow_preview_compare | Người chơi có xem cả hai Dòng Chảy trước commit? | Nếu thấp, tăng animation và contrast hai route. |
| STOP Comprehension | Người chơi có mô tả đúng Điểm Dừng? | Tune STOP marker và L2 onboarding. |
flow_direction_changed | Người chơi có nhận ra Current Arrow ở L8? | Nếu fail do misread, sửa preview chứ không tăng hint. |
| Flow → Meaningful Move | Preview giúp tiến triển nhưng có đang chọn hộ? | Bỏ outcome count/best label khỏi Base Preview. |
final_tide_sweep | Sweep có chỉ chạy từ L4, sau rescue hợp lệ và khi còn một cụm? | Sửa rule/event trước khi tune VFX. |
wet_pit_rescue | Wet pit từ L5 có cứu trực tiếp đúng số sao? | Đối chiếu simulation và solver fingerprint. |
Bạn Đồng Hành Experience Metrics
Player-facing dùng “Bạn Đồng Hành”; event nội bộ giữ tiền tố coach_ để tương thích dữ liệu cũ.
| Metric | Target | Ý nghĩa |
|---|---|---|
| Auto interruption | ≤1 message/level | Nhân vật không phá FLOW. |
| Scripted message skip | <25% | Copy hoặc timing có thể sai. |
| Hint → meaningful move | Tăng so với move trước hint | Hint giúp nhìn Điểm Xoáy, không chỉ trang trí. |
| Retry after companion recap | ≥ baseline +10 điểm % | Đo giá trị recap near-miss lệch một ô. |
| Hint dependency trend | Giảm L1 → L7 | Bạn Đồng Hành phải rút dần khi mastery tăng. |
Full Rescue và Rating Metrics
| Metric | Câu hỏi | Decision |
|---|---|---|
| Remaining at finish | Win luôn có 0 sao còn lại và fail thường chỉ còn một target rõ? | Sửa win gate hoặc board clarity. |
| Turns efficiency | turnsUsed phân bố thế nào so với optimal và max? | Tune board/recovery slack, không cộng lượt cảm tính. |
| Rating distribution | 3★/2★/1★ có đủ đường chơi hợp lệ? | Đối chiếu solver proof trước playtest. |
| Near-miss quality | Fail phổ biến còn 10–30% sao và một rescue target rõ? | Sửa board/preview trước khi tăng maxTurns. |
Deployment & Completion Gates
| Gate | Pass khi |
|---|---|
| Public root | Hiển thị FLOW, Full Rescue, Xoáy Cứu Hộ, Bạn Đồng Hành, 10 level và solver proof. |
| Playable route | /shell-tide-playable.html tải FLOW + vortex runtime/CSS và không 404 dependency. |
| Rule fidelity | Chỉ valid capture-empty nhận class/marker xoáy. |
| Build | npm run build:pages exit 0 và artifact chứa vortex files. |
| Browser | Load <3s target, restart <1s, không lỗi console nghiêm trọng. |
| Offline AI | Tắt API vẫn chơi đủ 10 level. |
Playtest protocol
Target không phải measured
Không đưa pass/retry/retention target lên pitch như kết quả thật khi chưa có sample.