AI Formal Specifications Hub
Documented games in this catalog are paired with a companion formal specification (.ai.md) defining its state space, action grammar, stochastic transitions, and termination guarantees.
Engine Suitability Classifications
Engine-Ready (1108)
Discrete boards, tokens, and deterministic state transitions suitable for immediate zero-adaptation coding in Python, Rust, TypeScript, or C++.
Adaptation Required (888)
Physical dexterity, spatial throwing, or tactile deception games that require physics simulations, grid discretization, or probabilistic proxies.
Not Recommended (32)
Intrinsically physical somatic rituals, pain endurance trials, or living community ceremonies that cannot be discretized without losing their cultural essence.
Formal Modeling Methodology & Conventions
4 Mathematical Fidelity Classes
- direct: 1:1 mathematical isomorphism where rules map directly to finite state automata.
- discretized: Continuous physical pitches or bounds mapped to 2D coordinate lattices.
- probabilistic-proxy: Motor skills (throwing accuracy, physical agility) modeled via stochastic Bernoulli/Gaussian distributions.
- abstracted: Complex social roleplay or oral catechisms abstracted to qualitative signaling models.
The [gap-fill] Marker
Traditional folk games were transmitted orally across generations and often have uncodified tie-breakers, boundaries, or turn order conventions.
When mathematical simulation requires an unambiguous transition that primary folklore sources omitted, we supply the minimum necessary closure and strictly mark it as [gap-fill]. Implementers always know exactly which lines come from the corpus and which are engineering closures.
Open JSON Datasets
Every game in the corpus is available as structured JSON for AI researchers, game simulators, and developers. All datasets are free to use — see licence for terms. The corpus currently holds 2,028 games with 20% high-confidence sourcing — inspect the full breakdown on the coverage dashboard.
API Reference
Minimal dataset — fastest download:
curl https://gamesofcountries.com/api/dataset?format=minimal
Filter by country (ISO 2-letter code):
curl https://gamesofcountries.com/api/dataset?country=gh
Per-country shorthand endpoint:
curl https://gamesofcountries.com/api/dataset/gh
Aggregate statistics:
curl https://gamesofcountries.com/api/dataset/stats