Formal Specification
Rwandan Royal Four-Row Mancala — Formal Specification
Rwanda · board-abstract · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: directGap-fills: 3
# Igisoro — AI-optimized specification
> **Reconstructed source.** The entry carries a provenance warning: its rules were written from
> general knowledge, not read from the two historical works it cites (Kagame 1954; Coupez & Kamanzi 1970).
## General idea
The noble four-row mancala board game of Rwanda, played on a 4x8 grid of 32 pits with 64 seeds. Each player
controls a 2-row territory (16 pits forming a private loop). What gives Igisoro its uniquely relentless character
and extraordinary game length is its capture mechanic: **captured seeds are not banked in a player store, but
are immediately re-sown into the captor's own territory**. Consequently, **seeds never leave play**. Because
no seeds are permanently removed, there is no monotone resource drain anywhere in the game — every piece remains
in circulation indefinitely, cycling between players. A player wins by depriving the opponent of any legal move
(leaving no opponent pit with >= 2 seeds) or capturing all opponent seeds.
## Formal model
- **Abstraction taken:** None. Discrete board geometry, deterministic relay mechanics, perfect information.
- **Player/agent count:** Exactly 2 players, each controlling their half (2 rows of 8 pits).
- **Turn model:** Alternating sequential turns; each turn triggers a multi-lap relay sowing sequence in the
player's private 16-pit loop.
## Formal rules
R1. Setup (entry §1): a board of **4 rows of 8 pits** (32 pits total). Each player controls **2 rows**
(an inner row and an outer row, 16 pits forming a closed private loop). Initialized with **2 seeds per
pit** (64 seeds total).
R2. Sowing (entry §2): the active player selects an occupied pit on their side containing **>= 2 seeds**,
lifts all seeds, and sows them 1 seed per pit around their private 16-pit loop. The sowing direction
(clockwise or counter-clockwise) is **chosen on the first move**
[gap-fill: the entry does not specify whether the direction chosen on the first move fixes the player's
sowing direction permanently for the entire match or if direction can be chosen anew on each turn].
R3. Relay sowing (entry §3): if the last sown seed lands in an already occupied pit, all seeds in that pit
are scooped up and sowing immediately continues in the same direction. Sowing ends when the last seed
lands in an empty pit (without triggering a capture).
R4. Capture (entry §4): if the last seed of a lap lands in an occupied pit in the player's **INNER row**,
AND the directly opposite pit in the opponent's **inner row is occupied**, the player captures all
seeds from that opponent inner pit (and also from the opponent's outer pit directly behind it, if
occupied).
R5. Immediate re-sowing of captured seeds (entry §4): captured seeds are **immediately re-sown into the
captor's territory**, continuing the active turn. They are not removed to a private bank.
R6. Win condition (entry §5): a player wins when they **clear all seeds from the opponent's territory**,
or leave the opponent with **no pits containing >= 2 seeds** (immobilization).
R7. Singletons:
[gap-fill: pits containing exactly 1 seed cannot be lifted to initiate sowing, per R2, and remain passive
until another seed lands in them].
R8. Capture loop continuation:
[gap-fill: the entry does not specify the exact starting pit from which captured seeds are re-sown;
standard practice continues sowing from the capture-triggering inner pit].
## Edge cases
- Tie at the end: not applicable; the entry defines only decisive win conditions (total clearance or
immobilization) and no draw or tie states.
- A player with no legal move: explicitly addressed as a loss condition (R6: opponent has no pit containing
>= 2 seeds). Because 1-seed pits cannot be lifted (R2), immobilization is a reachable tactical end.
- Repetition / cycles: unaddressed by the rules; since seeds never leave the board and are continuously
re-sown, cycles of identical board states can occur indefinitely without any formal repetition rule.
- Simultaneous claims on one position: not applicable; turns alternate strictly sequentially and each
player operates within their private 16-pit loop.
- Elimination mid-round and turn-order repair: seeds change territorial possession upon capture, but players
are not eliminated; strict two-player alternation is preserved.
- Resource exhaustion: **no resource is ever exhausted**. Because captured seeds are immediately re-sown (R5)
rather than banked, the total seed count remains exactly 64 across all turns. The game lacks any monotone
drain.
- Termination guarantee: **not guaranteed.** Because total seed count is strictly conserved at 64 and seeds
are constantly recycled between players through re-sowing (R5), and because no repetition rule, turn limit,
or forced progress mechanism exists, games can cycle infinitely. `termination_guaranteed: false` is the
honest mathematical reading.
## State representation
- Persistent state: `board[4][8]` ∈ {0..64} where sum equals 64, `player_direction[2]` ∈ {cw, ccw},
`active_player` ∈ {0, 1}.
- Per-turn ephemeral state: `current_pit`, `hand_seeds`, `sowing_dir`, `laps_in_turn`.
- Observable information: fully observable, perfect information. No hidden state or randomness.
## Action space
- `sow(pit_coord, [direction])`: active player picks an eligible pit on their side with `seeds >= 2`
and executes relay sowing (R2). All subsequent relay laps, captures (R4), and re-sowings (R5) resolve
deterministically.
## Playability notes
- Single-player-vs-AI: deep and demanding tactical search problem; the non-monotone nature of captures
makes evaluation functions non-trivial, as captured seeds immediately re-enter one's own loop.
- Reducing n > 4 to 2 agents: not applicable; strictly two-player.
- Physical-skill games: not applicable; pure combinatorial abstract.
- What is lost: the rapid tactile fluidity, wooden hollow resonance, and intense spectator excitement of
traditional Rwandan Igisoro matches.
## Implementation hints
Model the board as two 16-pit loops mapped to index arrays `[0..15]` for each player, where indices 0..7
represent the outer row and 8..15 represent the inner row (or vice versa). Opposite-pit lookups for R4
must pair `player0_inner[k]` with `player1_inner[7-k]` and `player0_inner[k]` with `player1_outer[7-k]`.
Implement the re-sowing of captured seeds as an immediate continuation of the relay loop rather than an
off-board storage event. Add explicit cycle-detection or a 200-ply limit for engine sanity, labelling it
as an engine safeguard. Suggested first milestone: 4x8 loop indexing and capture/re-sowing mechanics
verifying that total seed sum remains invariant at 64.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Rwandan Royal Four-Row Mancala (Rwanda). (n.d.). Games of Countries. https://gamesofcountries.com/games/rw-rwanda/igisoro
@misc{gamesofcountries-rw-rwanda-igisoro,
title = {Rwandan Royal Four-Row Mancala (Rwanda)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/rw-rwanda/igisoro}
}