Skip to content
Yakiv Kovalskyi edited this page Jul 14, 2026 · 2 revisions

Poker Study wiki

Poker Study is a personalized NLHE MTT study app for iOS: import your own PokerStars hand histories, find your actual leaks, and drill the specific spots you misplay. It's off-table only — study/prep software, never a live table-state reader or overlay.

These pages mirror the repo's ai-docs/ folder — per-subsystem docs written to get an agent or a returning dev oriented fast. The repo copy is the source of truth; if these drift, trust ai-docs/ in the repo and re-sync.

Pages

  • Architecture — the PokerKit vs app split, data flow (import → analyze → drill), SwiftData persistence
  • Ranges — Chen-score hand strength, the push/fold shove table, PushFoldRange / PushFoldSpot
  • Hand History — the PokerStars .txt parser: what's parsed, defensive skipping, known limitations
  • Leak AnalysisLeakAnalysisEngine: VPIP/PFR/limp, push-fold adherence, small-sample confidence gating
  • Drills — how "Practice Your Leaks" derives a DrillFocus from a leak report and weights spots
  • Preflop Grid — the 13×13 grid enumeration and range viewer
  • Testing — running swift test (the Xcode/DEVELOPER_DIR requirement) and what CI does

Elsewhere

  • AGENTS.md — build/test/run commands, conventions, the working agreement
  • CLAUDE.md — this project's non-negotiable working principles (off-table-only, privacy-first)
  • README — what the project is, planned features, status

Clone this wiki locally