>The Decompiler and the Render

What most readers think is "the original text" is actually four programs running at once, written by four different hands.
>OPEN hexagram_5
Open any I-Ching site, turn to Hexagram 5 — Xu (需, Waiting) — and read three things in a row without noticing the seams. First: "Waiting. Sincerity. Brilliant success. Correctness brings good fortune. It is beneficial to cross the great river." Then: "Waiting means to bide one's time; danger lies ahead. Being firm and strong without falling in." Then: "Clouds rising above heaven — this is Waiting. The noble person accordingly engages in eating, drinking, and festive enjoyment."
Three texts. Three authors. Three different jobs. The first is the Judgment (卦辭, guaci) — the original hexagram statement attributed to King Wen. The second is the Tuanzhuan (彖傳, the Judgment Commentary), a separate Wing written centuries later. The third is the Xiangzhuan (象傳, the Image Commentary), a third Wing with its own logic. The Tuanzhuan and Xiangzhuan together account for four of the Ten Wings — each splits into an upper and lower section across the thirty hexagrams of the upper classic and the thirty-four of the lower. Most readers parse all of it as one undifferentiated block of ancient wisdom.
>RUN tuanzhuan --reverse
The Tuanzhuan does not restate the Judgment in nicer words. It decompiles it. It takes the verdict and traces back through the hexagram structure to show why the verdict reads the way it does — which trigram sits where, which line holds the ruling position.
Watch it work on Xu. The Judgment says "brilliant success, correctness brings good fortune." Why? The Tuanzhuan answers: Qian (Heaven, pure yang, firmness) sits below, Kan (Water, danger) sits above. Danger lies ahead — but the lower trigram is strong enough not to be swallowed by it. Then it zooms to one specific register: Nine in the Fifth, occupying "the heavenly position," the ruler's seat, both central (middle of the upper trigram) and correct (a yang line in a yang slot). That single configuration is the source of "brilliant success." Kong Yingda's seventh-century sub-commentary makes the method explicit — a hexagram's virtue can derive from the trigram images, from the line positions, or from both combined, and Xu uses all three at once. The verdict was never a vague pronouncement. It was a structural readout, and the Tuanzhuan hands you the trace.
>LIST tuanzhuan.tools
The decompiler runs the same three instructions across all sixty-four hexagrams. Learn the toolkit once and every Tuanzhuan passage becomes legible.
Trigram relationship. Hexagram 11, Tai (泰, Peace): Kun (Earth) above, Qian (Heaven) below — which looks inverted until you read it as motion. Heaven's energy rises, Earth's descends, so they meet in the middle. The Tuanzhuan: "Heaven and Earth interact and the myriad things communicate; above and below interact and their wills align." A dynamic exchange, not a static stack. Line position. Hexagram 20, Guan (觀, Contemplation): the two yang lines at the top are "the great contemplation" that everything below looks up to, and Nine in the Fifth is again central and correct. Trigram quality. The same Guan passage adds "compliant and gentle" (順而巽) — Kun (Earth, compliance) below, Xun (Wind, gentleness) above, read as character traits. Three tools, sixty-four targets, one consistent engine.
>RUN xiangzhuan --render
The Xiangzhuan asks a different question and runs in two modes. The Da Xiang (大象, Great Image) operates at the hexagram level: for each of the sixty-four, it composes a natural image from the two trigrams, then emits an instruction for how a junzi (君子) or sage king should act on it. The Xiao Xiang (小象, Small Image) operates at the line level — 384 terse, almost telegraphic notes, one per line, that annotate position.
The Da Xiang always follows one formula: picture, then prescription. Xu: "Clouds rising above heaven — the noble person accordingly engages in eating, drinking, and festive enjoyment." Clouds have gathered but no rain has fallen; while you wait, you nourish and prepare rather than force action. Tai: "Heaven and Earth interact — the ruler accordingly manages and completes the Way of Heaven and Earth." Peace is active maintenance, not rest. Guan: "Wind moves over the earth — the former kings accordingly inspected the regions, observed the people, and established teachings." Contemplation is the kind of seeing that leads to governance. The render never just describes. It always prints a command.
>QUERY which_voice
The Xiao Xiang is the most technical layer of all. Hexagram 5, Initial Nine — "Waiting in the outskirts" — gets the note "one does not venture into difficulty." Read positionally: Initial Nine is the bottom line, farthest from the danger of upper Kan, safe in the outskirts but unable to accomplish much, so the correct move is constancy, not grand action. Across all 384 lines the Xiao Xiang recycles the same handful of flags — central (中), correct (正), corresponding (應), appropriate (當) — the Tuanzhuan's instruction set, applied at line scale.
So the four layers are not redundant; they are independent instruments. The Judgment returns the verdict. The Tuanzhuan tells you why — always structural. The Da Xiang tells you what it looks like and what to do — always imagistic. The Xiao Xiang tells you what each line means — always positional. Collapse them into one voice and you are reading a Shakespeare play without separating stage directions from dialogue: you can follow the plot, but you lose track of who is speaking and why. Keep them separate and the system becomes navigable — ask "which trigram is where, which line is central and correct," and you have a replicable method that works for any hexagram in the set.
Two Wings, two questions: one decompiles the verdict, one renders the picture and prints the command.