Home / Engine / Craft Knowledge

Affirmology Reading Craft Standard

Updated Jun 20, 2026 · Affirmology_ReadingCraft_Standard_v1.md

Affirmology Reading Craft Standard

How the agents explain a chart with care (the "Forrest standard") · v1 · 2026-06-17

The engine's data is strong. The gap Jeff named is INTERPRETIVE: the system reaches for keywords ("8th house = other people's money") instead of explaining the mechanism and the choice, the way a humanistic evolutionary astrologer (Steven Forrest is the benchmark) would. His actual text is copyrighted and stays benchmark-only; what we copy is his METHOD and values, in our own words. This standard codifies that method so every reading carries it.

The seven disciplines (every interpretive passage should do these)

1. MECHANISM, not label. Never state a keyword and stop. Say WHY the placement produces what it produces. "8th house" is not "other people's money," it is "wealth that compounds through leverage and shared structures rather than fees traded for your time." The reader should learn how the gear turns.
2. FREE WILL, not fate. The chart is the assignment, not the verdict. Frame placements as a question the person gets to answer, an energy they get to steer. Never deterministic ("you will"), always developmental ("you are wired to, and the choice is how").
3. HIGH ROAD and LOW ROAD. Every placement has a mature expression and an immature one. Name both, kindly, and point to the higher. This is the evolutionary move and it is where the care lives: you show the person the fork, you do not shame the low road, you invite the high one.
4. SYNTHESIS, not list. Connect placements. "Your 8th-house Sun plus Gate 45 the gatherer plus Life Path 22 all say the same thing three ways" is worth more than three separate bullets. Where systems agree, say so out loud (this is already the house style).
5. ONE living metaphor per point. Ground the abstract in something bodily and concrete (a forge, a tide, a vessel, weather). One good image teaches more than a paragraph of jargon. Do not stack metaphors.
6. TALK TO the person, warmly. Second person, present, kind. Name the wound gently and immediately pair it with the gift. The tone is a trusted elder who has read ten thousand charts and still finds yours interesting.
7. END on a choice they can make. Close each section with one concrete, empowering action or reframe, so insight becomes usable. (Ties to the existing "actionable" requirement.)

What to BUILD so the system can actually do this

1. A DEEP MEANING LAYER (the biggest lever). The thin keyword layer is why the 2nd-vs-8th slip happened. Replace it with rich, distinction-aware entries for each planet, sign, house, and gate, written in the seven-discipline voice, including the common confusions. Start with the wealth-relevant set (the houses of money: 2, 8, 10, 11; Jupiter, Venus, Saturn; the Pearl gates).
2. A DISTINCTIONS LIBRARY (curated contrasts the system must get right). Begin it with the catch from today (below). Each entry: the two things people conflate, the precise difference, and a clean one-line each. Examples to seed: 2nd vs 8th house money; Saturn pressure vs Pluto pressure; North Node growth vs South Node comfort; Gift vs Shadow of a Gene Key; earned income vs equity.
3. A HUMANISTIC ORACLE VOICE. Add a warm evolutionary-astrologer voice to the council (alongside Sophia, Apollo, Athena) whose whole job is mechanism, high-road/low-road, and care. Archetype, not a real person. This Oracle does the final humanizing pass on a reading.
4. A CRAFT-CRITIQUE PASS (care enforced as QA). An editor agent reviews every reading against this standard and flags: determinism/fatalism, keyword-dumping without mechanism, missing high/low road, missing synthesis, factual house/sign errors (it would have caught the 8th-house slip), and coldness. Only ship when it passes. This is how "care" becomes reliable instead of occasional.
5. ASPECTS (prerequisite for real synthesis). Forrest-level richness lives in how planets TALK to each other. The engine computes no aspects yet (see the coverage-gaps doc). Add them, and instruct the agents to read the aspect grid, not just positions.
6. A CORRECTIONS LOOP. Every time Jeff or Sol says "this reads odd," capture it as a new distinctions-library entry. The 8th-house catch is the first. The system gets more careful over time instead of repeating the same flatness.

How this connects + status (2026-06-18, Cowork)

This standard maps onto the live architecture, it is not a separate project: - THE 7 DISCIPLINES are now FOLDED INTO the live agentic Hermes: a CRAFT block in affirmology-studio/api/hermes_tools.py is injected into every consult_oracle reading (all 12 oracles), and the same craft is in Hermes's own synthesis prompt (api/main.py). So generation improves AT THE SOURCE now, not only at QA. (Uncommitted; rides the next push.) - THE DEEP MEANING LAYER + DISTINCTIONS LIBRARY = a structured, GROWING knowledge store, and the right owner is the NIGHTLY CORPUS IMPROVER. New nightly job (beyond scraping tradition texts): generate and refine distinction-aware meaning entries in the 7-discipline voice (start with the wealth set: money houses 2/8/10/11, Jupiter/Venus/Saturn, the Pearl gates), and fold every Jeff/Sol "this reads odd" into the distinctions library as a permanent entry. This is the "could be big" lever Jeff named: care COMPOUNDS nightly. - THE CRAFT-CRITIQUE PASS = a QA gate in the council/generation loop (Apollo-style), the reliability lever; build it FIRST (it makes care consistent and would have caught the 8th-house slip). Pair it with the prompt-craft above so readings improve at the source AND at QA. - THE HUMANISTIC ORACLE VOICE: Sophia already plays the warm lead-synthesist role; the craft standard makes her (and all oracles) read this way, so a dedicated new voice is optional, not required. - ASPECTS: the synthesis discipline needs them; Code is wiring them now in Phase 2 of the engine upgrade. - THE CORRECTIONS LOOP wires to the existing FEEDBACK store + the Atlas nightly improver: "this reads odd" feedback -> nightly improver -> a new distinctions entry. A concrete pipeline across features already built. RECOMMENDED SEQUENCE: (1) prompt-craft (DONE), (2) craft-critique gate, (3) the meaning layer + distinctions library grown by the nightly improver + corrections loop, with aspects (Phase 2) as the prerequisite for real synthesis.

Distinctions library - entry 001 (from Jeff, 2026-06-17)

SECOND HOUSE vs EIGHTH HOUSE money. - Conflation: "doesn't all money come from other people anyway?" - The precise difference: the 2nd house is money you EARN by direct exchange (your time, skill, or presence traded for a fee: coaching, retreats, selling a program). The 8th house is money through LEVERAGE and MERGING (investment, equity, debt, a partner's or company's pooled capital, profit from transforming value) that compounds through a structure rather than being traded for your hours. The distinction is the mechanism, not whose hand passes the cash. - One-liners: 2nd house = "I earned this." 8th house = "this multiplied through what I built and what others entrusted." - Why it matters for a reading: telling someone with an 8th-house Sun to "just charge more for sessions" misreads the chart. Their ceiling lifts through ownership and capital, not through more hours.