Skip to main content
Formal Specification

Akan Two-Row Mancala — Formal Specification

Ghana · board-abstract · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: directGap-fills: 3
# Oware — AI-optimized specification ## General idea The Akan two-row mancala, and the most fully specified member of its family in this corpus. Two rules distinguish it from its regional relatives here: the **twelve-seed skip**, under which a sowing lap long enough to return to its origin pit passes over that pit rather than refilling it, and an explicit **Grand Slam prohibition** forbidding a move that would capture every seed on the opponent's side. Both exist to prevent degenerate play, and together they make the endgame a constrained problem rather than a race. ## Formal model - **Abstraction taken:** None. Discrete, deterministic, perfect information. - **Player/agent count:** Exactly 2, each owning one row of 6 pits. - **Turn model:** Strictly sequential, one sowing move per turn, capture chain resolved within the turn. ## Formal rules R1. Setup (entry §1): 2 rows of 6 pits, **4 seeds per pit**, 48 seeds total. R2. Sowing (entry §2): the mover lifts all seeds from one of their own pits and sows one per pit counter-clockwise around **both** rows. R3. Twelve-seed skip (entry §2): if a lifted pit holds **12 or more** seeds — enough for the sowing lap to return to it — the **starting pit is skipped** during sowing and is not refilled. This keeps a large pit from immediately reloading itself. R4. Capture (entry §3): if the last seed lands in an **opponent** pit bringing it to exactly **2 or 3** seeds, those seeds are captured. Capture chains backwards through contiguous preceding opponent pits also holding exactly 2 or 3, stopping at the first pit that fails the condition or at the row boundary. R5. Grand Slam prohibition (entry §4): a player **cannot** make a move that captures all remaining seeds on the opponent's side, unless no alternative move exists [gap-fill: the entry says such a move is forbidden "unless forced" but does not say what happens when it *is* forced — whether the capture stands in full or is played without capturing. Allowing the move with its capture is assumed, as the entry frames the restriction as conditional rather than absolute]. R6. Feeding obligation (entry §4): if the opponent has no seeds, the mover **must** play a move that feeds seeds into the opponent's row. This restricts the legal move set [gap-fill: the entry does not state the outcome when no feeding move exists; the convention is that the mover banks the remaining seeds and the game ends, but the entry supplies no rule]. R7. Victory (entry §5): the first player to capture **25 or more** of the 48 seeds wins. As 25 is a strict majority, exactly one player can satisfy this. ## Edge cases - Tie at the end: impossible at the stated win condition, since 25 of 48 is a majority. A 24-24 finish with no seeds remaining is reachable and the entry defines no outcome for it [gap-fill: treated as a draw, no player being able to satisfy R7 and no move remaining]. - A player with no legal move: constrained by R6, which exists precisely to prevent a player being starved of seeds. When it arises despite R6 (no feeding move available), the entry is silent — see R6's marked gap. - Repetition / cycles: **unresolved by the entry.** Capture-free sowing cycles are a well-documented feature of this game family, and the entry supplies no repetition rule, no move limit, and no cycle draw. R3's skip rule mitigates one specific degenerate pattern but does not prevent cycling in general. - Simultaneous claims on one position: not applicable — strictly sequential turns, each resolved completely including its capture chain before the turn passes. - Elimination mid-round and turn-order repair: seeds leave the board (R4); players are never eliminated. Strict two-player alternation is invariant and needs no repair. - Resource exhaustion: seeds on the board are strictly non-increasing — captures bank them permanently. Exhaustion of the opponent's side is exactly what R5 and R6 exist to regulate, making it a governed condition rather than an accident. - Termination guarantee: **not guaranteed, and this is a genuine gap in the source rather than in the game.** Captures are monotone: at most 48 seeds can ever be banked, so any line with infinitely many captures terminates. But nothing compels a capture — R4 fires only on the exact 2-or-3 condition — and capture-free cycles are possible. Competitive Oware rules as played internationally do include a cycle rule; **this entry does not state one**, so `termination_guaranteed: false` reflects the entry rather than the tournament game. No move limit is invented here; an implementation must add a cycle-detection draw and label it as its own addition. ## State representation - Persistent (game) state: `pits[12]`, `captured[p]` (monotone non-decreasing, target 25), `current_player`. - Per-turn ephemeral state: `hand`, `cursor`, `skip_pit` (the origin pit when R3 applies), `capture_chain`. - Observable information: fully observable, perfect information. No hidden state, no randomness. ## Action space - `sow(pit)`: the active player; precondition: `pit` is one of their 6, non-empty, and the move satisfies both R5 (no Grand Slam unless forced) and R6 (must feed a starving opponent). Sowing, skipping, and capture chaining all resolve automatically — the only decision each turn is which pit to lift. ## Playability notes - Single-player-vs-AI: natural and strong. Perfect information, no randomness, branching factor at most 6, and a well-studied strategy literature — Oware is among the most engine-ready games in the entire corpus, and is in fact a solved game at this board size. - Reducing n > 4 to 2 agents: not applicable; inherently two-player. - Physical-skill games: not applicable — nothing physical is modelled. - What is lost: little mechanically. What does not survive is the carved board and *Caesalpinia bonduc* seeds the entry names, and the game's standing as a communal fixture rather than an object of search. ## Implementation hints Flat 12-array with modular sowing; the capture chain is a short backward walk bounded by the row edge. **Both R5 and R6 must be legal-move filters, not post-hoc validations** — they change which moves exist, and a search that generates illegal moves and prunes them later will mis-evaluate exactly the endgame positions where they bind. R3's skip is the subtlest rule: it applies only when the lifted pit holds 12 or more, and forgetting it makes large pits self-refill, which materially changes long-game dynamics. Suggested first milestone: sowing with seed conservation verified (pits + both banks always sum to 48), then the skip, then chained capture, then the two move filters.

Download as JSON

Download the full game corpus entry for this game as structured JSON.

Download JSON
Cite this page

Oware (Ghana). (n.d.). Games of Countries. https://gamesofcountries.com/games/gh-ghana/oware

@misc{gamesofcountries-gh-ghana-oware,
  title = {Oware (Ghana)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/gh-ghana/oware}
}