Overview

The Yi Jing Oracle is a high-fidelity Python implementation of the traditional 50-stalk yarrow method (蓍草法). Unlike simple random number generators or three-coin coin tosses, this skill emulates the authentic stochastic process and line-probability asymmetries (老陰, 少陽, 少陰, 老陽) defined in the 繫辭上傳 (Xici Zhuan).

What it does

This skill provides a suite of tools for authentic Chinese divination and scholarship. It performs the 18-step stochastic division process to cast hexagrams, looks up King Wen sequence data, and retrieves grounded source texts from the canonical corpus.

• yijing_cast: Executes the full yarrow procedure using hardware entropy to generate primary and relating hexagrams.
• yijing_lookup: Provides instant access to any of the 64 hexagrams by their traditional index.
• Ground Truth: Returns the specific interpretive apparatus (卦辭, 彖, 大象, and 爻辭) relevant only to the current cast.
• Trigram Tables: Accesses the 八卦 (Bagua) meanings, virtues, and familial roles.

Why use this skill?

For developers and users seeking an oracle that respects traditional epistemic claims, this skill bridges the gap between ancient ritual and modern computation. It treats divination as a structural snapshot of a situation and is ideal for strategic reflection, philosophical inquiry, or any context where qualitative decision-making requires a non-linear perspective grounded in a coherent historically faithful symbolic system.