One-paragraph product
Hold’em vs AI is a Flywheel.games pad game: heads-up no-limit hold’em against a house AI, practice-first, real play via FlywheelVault Game Wallet. Rules mirror Suited cash NLHE (5% pot rake, no flop / no drop, uncontested pots never raked). Directory holdem-vs-ai/; gameId = keccak256("HOLDEM_VS_AI"). Integration at dice-over-under / dice-sums parity via create-flywheel-game skill.
In scope for v1
- Pure TS HU NLHE engine + 5/7-card hand eval + unit tests.
- Practice UI (HU table; BJ / royaldeck-style cards & chips copied in-tree).
- Deterministic heuristic AI (same path practice / live).
- Settler hand session (multi-action → settle at hand end) + PF deck commit.
- Full pad embed: dual registry, Vite
@holdem, lobby/launch/play, WalletBar, rake knobs (custom, 500 bps), FairPanel-equivalent,DEPLOY.mdif needed. - Stake ladder from SBJ/Suited BB tiers; buy-in 10–500× BB.
Out of scope for v1
- Six-max / multiway, tournaments, Suited.club lobby sync
- Player rakeback (skill forbids on pad games)
- On-chain HMAC verification
- Rebuilding SBJ onto the pad in the same change
- ML / trained poker AI
Domain commitments
| Piece | Rule |
|---|---|
| Format | Heads-up NLHE only |
| Blinds | HU: button = SB; other = BB. SB acts first preflop; BB first postflop |
| Rake | 5% of pot (rakeBps: 500, basis: 'custom'); no flop no drop; uncontested never; cap 2× BB v1 |
| Contested | At least one call during the hand, or showdown |
| Practice | Local mock PF; never rake / never checkpoint |
| Custody | FlywheelVault GW deposit before real play; kit singleton |
| Settler | One process; hand-session branch (not dice one-shot /roll alone) |
| Naming | holdem-vs-ai; label Hold’em vs AI; alias @holdem |
| Art | Copy BJ CSS / royaldeck rasters into game tree — no shared art package |
Stake tiers (BB = min unit)
| Tier | BB |
|---|---|
| t002 | 0.02 |
| t010 | 0.10 |
| t050 | 0.50 |
| t2 | 2 |
| t5 | 5 |
| t10 | 10 |
SB = BB / 2. Buy-in stack: 10–500× BB (default 100× for practice).
Phased build
- This brief
- Engine + tests
- Practice UI
- AI
- Settler + PF
- Pad wire + playground reset
- Polish
Open follow-ups
- Exact Suited rake-cap table by stake (v1 uses 2× BB)
- AI difficulty tiers
- Photoreal royaldeck table as default vs CSS felt