Formal Specification
Competitive Karuta / Poem-Snatching Game — Formal Specification
Japan · card · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: directGap-fills: 3
# Kyogi Karuta — AI-optimized specification
## General idea
A competitive two-player card sport based on the 100 classical poems of the *Ogura Hyakunin Isshu*. Players arrange 25 grabbing cards in their home territories (*jijin*); as a reciter chants poems in random sequence, players race to identify and sweep the matching lower-phrase card from the tatami. Snatching cards from the opponent's territory or forcing opponent faults enables sending cards across the line until one player's territory is completely cleared.
## Formal model
- **Abstraction taken:** Auditory phoneme processing (distinguishing the decisive syllable / *kimari-ji*), spatial memory recall, and high-velocity physical sweeping strokes are discretized into an event-driven reaction-time model. Each agent's response latency is modeled as `t_reaction = t_kimariji + t_memory_retrieval + motor_speed + epsilon`.
- **Player/agent count:** 2 competing players (Player 0 and Player 1) plus 1 automated poem recitation engine.
- **Turn model:** Sequential poem recitations; simultaneous latency comparison and territory card-sending per poem.
## Formal rules
R1. Setup and Card Allocation:
- From the 100-card *Hyakunin Isshu* deck, 50 cards are chosen at random. The remaining 50 cards become unplayed "dead cards" (*kara-fuda*).
- 25 cards are placed in Player 0's territory (*jijin_0*), and 25 cards are placed in Player 1's territory (*jijin_1*).
R2. Recitation flow:
- The reciter draws cards uniformly at random from the 100-poem pool without replacement.
- Each poem recitation exposes phonetic syllables over time until its unique *kimari-ji* is reached.
R3. Action submission:
- Both agents simultaneously submit `strike(target_card_id, timestamp)`.
R4. Successful Take Resolution:
- The player with the lowest valid timestamp on the active matching card takes the card.
- Own Territory Take: If taken from own *jijin*, the card is removed; that player's card count decreases by 1.
- Opponent Territory Take: If taken from opponent's territory, the card is removed, and the taking player selects 1 card from their own *jijin* and sends it to the opponent (*okuri-fuda*), decreasing own count by 1 and increasing opponent count by 1.
R5. Faults (*Otetsuki*):
- An *otetsuki* occurs if a player touches any card in the territory where the target card is NOT located, or touches any card on a dead-card recitation.
- Penalty: The non-faulting opponent sends 1 card from their *jijin* to the faulted player's territory.
- Double Penalty: If Player A takes a card in Player B's territory and Player B commits an *otetsuki* in Player A's territory, Player A sends 2 cards to Player B.
R6. Win condition: The match terminates the instant either player's *jijin* card count reaches exactly 0. That player is declared the winner.
R7. [gap-fill] Exact latency tie resolution: If both players touch the target card with `|t_0 - t_1| < 1ms`, priority is awarded to the player defending their own home territory (*jijin priority*).
R8. [gap-fill] Dead-card fault cooldown: When a dead card is read and both players fault simultaneously, neither player sends a card.
R9. [gap-fill] Deck exhaustion termination: If all 100 poems are read without a territory reaching 0 cards, the player with fewer remaining cards in *jijin* wins the match.
## Edge cases
- **Tie at the end condition:** Prevented by single-card clearance at match end; if resolved by R9, broken by lowest card count.
- **A player with no legal move:** Players may always choose to pass/remain stationary during a poem recitation.
- **Repetition / cycles:** Impossible; the 100-poem recitation deck strictly decreases without replacement.
- **Simultaneous claims on the same resource or position:** Resolved by timestamp latency comparison (R4) or home-territory priority (R7).
- **Player elimination mid-round:** Not applicable; strictly a 2-player match.
- **Resource exhaustion:** 50 cards on board are strictly reduced towards 0.
- **Termination guarantee:** Guaranteed by finite 100-poem recitation queue and strict net-card reduction upon successful takes.
## State representation
- **Persistent state:** `jijin[2]` (sets of active card IDs in each player's territory), `recitation_deck` (queue of 100 poem IDs), `cards_in_play` (set of 50 active card IDs), `dead_cards` (set of 50 card IDs).
- **Per-poem state:** `current_poem_id` (int), `is_dead_card` (bool), `kimariji_length` (int), `submitted_strikes[2]` (tuples of card ID and timestamp).
- **Observable information:** Perfect spatial information of cards in both territories; hidden information: unread poem sequence in recitation deck.
## Action space
- `strike_card(card_id: int, timestamp: float)`: Submit touch attempt on a specific card.
- `send_card(card_id: int)`: Select card from own *jijin* to transfer to opponent after a winning take or opponent fault.
- `hold()`: Refrain from striking during the current recitation.
## Playability notes
- **Single-player-vs-AI:** Highly competitive; AI models human phonetic recognition latencies, spatial memory decay, and strategic card sending (e.g. sending 1-syllable cards to maintain home advantages).
- **Group games (n>4):** Reduces to team match format (*Genpei-gassen*) where two teams manage shared territories.
- **Physical-skill games:** Physical sweeping arm motion and tatami sliding are abstracted into response latency distributions.
- **What is lost in the adaptation:** Physical finger sweeping collisions, tactical layout card rearrangement during pauses, and the resonant melodic voice of an authentic master reciter.
## Implementation hints
Discrete card state system with event timestamps. Model the 100 poems with their exact *kimari-ji* syllable lengths (from 1 to 6 syllables). First milestone: implement 50-card allocation, recitation loop, take/send territory arithmetic, and Otetsuki penalty logic.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Competitive Karuta / Poem-Snatching Game (Japan). (n.d.). Games of Countries. https://gamesofcountries.com/games/jp-japan/kyogi-karuta
@misc{gamesofcountries-jp-japan-kyogi-karuta,
title = {Competitive Karuta / Poem-Snatching Game (Japan)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/jp-japan/kyogi-karuta}
}