[
  {
    "id": "symbolic",
    "title": "Symbolic reading",
    "description": "Read chart factors as a vocabulary of images rather than literal verdicts. This guide proposes a transparent study workflow: identify the symbol’s source, connect it to a question, and let the reader assess whether it is useful. The same geometry can support several incompatible stories, so interpretation should remain distinguishable from calculation.",
    "steps": [
      "Choose one system and one interpretive source.",
      "Separate the measured position from the meaning assigned by that source.",
      "Generate two possible readings instead of one fixed claim.",
      "Ask which concrete experiences fit, which do not, and what remains unknown."
    ],
    "useCases": [
      "Journaling",
      "Learning a symbolic vocabulary"
    ],
    "inputs": [
      "A chart or clearly chosen symbol",
      "A question or theme",
      "An attributed interpretive text"
    ],
    "limits": "Resonance is a personal response, not evidence that a symbol objectively describes someone. Avoid making a single placement into a total identity.",
    "systems": [
      0,
      4,
      7,
      41,
      43,
      51
    ],
    "references": [
      {
        "title": "Liz Greene: Psychological Horoscope Analysis",
        "url": "https://www.astro.com/prod/pr_ph_e.htm",
        "kind": "original practitioner framework"
      },
      {
        "title": "Chinese Philosophy of Change (Yijing)",
        "url": "https://plato.stanford.edu/entries/chinese-change/",
        "kind": "scholarly encyclopedia"
      }
    ]
  },
  {
    "id": "traditional-rules",
    "title": "Traditional rules and planetary condition",
    "description": "Study the internal logic of a named historical or traditional method. Essential dignity concerns zodiacal position, while accidental condition includes other chart circumstances. Terms such as strong and weak describe a planet’s role within that rule system; they need not judge a person’s worth or morality.",
    "steps": [
      "Name the author, era, zodiac, house system and dignity table.",
      "Identify the relevant planet and house topic before adding secondary factors.",
      "Assess sect, dignity, motion, visibility, angularity and relationships only where the chosen source uses them.",
      "Show the chain of rules and any conflicting testimonies."
    ],
    "useCases": [
      "Reading historical manuals",
      "Comparing traditional schools"
    ],
    "inputs": [
      "Accurate chart and location",
      "Named source and tables",
      "A defined topic"
    ],
    "limits": "The engine supplies only part of this foundation. It does not provide a comprehensive dignity or judgement engine, and different traditional systems must not be blended without disclosure.",
    "systems": [
      2,
      3,
      14,
      15,
      21,
      27
    ],
    "references": [
      {
        "title": "Deborah Houlding: Introducing Planetary Dignity",
        "url": "https://www.skyscript.co.uk/dignities.html",
        "kind": "original practitioner teaching"
      },
      {
        "title": "William Lilly: Christian Astrology (1647)",
        "url": "https://www.skyscript.co.uk/CA/CA_DH.pdf",
        "kind": "historical primary text"
      }
    ]
  },
  {
    "id": "psychological-archetypal",
    "title": "Psychological and archetypal reflection",
    "description": "Explore a chart as a narrative about tensions, needs and possible ways of responding. Liz Greene’s published approach illustrates one influential practitioner framework combining astrology and psychological language. Here archetypal images are offered as questions, with space for the reader’s own account, rather than as a diagnosis.",
    "steps": [
      "Ask the person what they want to explore and obtain consent.",
      "Choose a small number of chart patterns rather than explaining everything.",
      "Offer tentative contrasting expressions of each pattern.",
      "Let the person correct the account and identify practical, self-chosen next steps."
    ],
    "useCases": [
      "Reflective conversation",
      "Creative character exploration"
    ],
    "inputs": [
      "Natal chart",
      "The person’s stated experience",
      "Named psychological-astrology framework"
    ],
    "limits": "Astrological symbolism is not a clinical assessment. Do not infer a disorder, childhood trauma or another person’s unconscious motives from chart geometry.",
    "systems": [
      0,
      4,
      11,
      17
    ],
    "references": [
      {
        "title": "Liz Greene: Psychological Horoscope Analysis",
        "url": "https://www.astro.com/prod/pr_ph_e.htm",
        "kind": "original practitioner framework"
      }
    ]
  },
  {
    "id": "timing",
    "title": "Timing and cycle comparison",
    "description": "Distinguish astronomical timing from symbolic timing. A transit compares actual positions at two dates; returns search for a repeated coordinate; progressions and time-lord methods introduce additional conventions. A useful study records the rule before examining events, which reduces the temptation to select only striking matches afterward.",
    "steps": [
      "Choose one technique and write down its time rule, coordinate target and tolerance.",
      "Calculate the interval, including uncertainty from birth time.",
      "Describe the proposed theme as a possibility, not a guaranteed event.",
      "Keep a dated record of matches, non-matches and alternative explanations."
    ],
    "useCases": [
      "Studying cycles",
      "Retrospective method comparison with transparent rules"
    ],
    "inputs": [
      "Birth or event chart",
      "Target date range",
      "Timing technique and parameters"
    ],
    "limits": "Most dedicated timing techniques remain outside this engine. Astronomical precision does not establish the accuracy of life predictions; no deterministic health or financial forecasts are supplied.",
    "systems": [
      18,
      19,
      20,
      24,
      25,
      27
    ],
    "references": [
      {
        "title": "Swiss Ephemeris Programmer’s Manual",
        "url": "https://www.astro.com/swisseph/swephprg.htm",
        "kind": "technical specification"
      },
      {
        "title": "William Lilly: Christian Astrology (1647)",
        "url": "https://www.skyscript.co.uk/CA/CA_DH.pdf",
        "kind": "historical primary text"
      }
    ]
  },
  {
    "id": "relational",
    "title": "Relational comparison",
    "description": "Relational astrology compares two or more charts. Cross-chart aspects, midpoint composites and charts based on a midpoint in time and place are different constructions and should stay separately labeled. This proposed workflow uses comparisons to invite discussion, not to score compatibility or declare what another person feels.",
    "steps": [
      "Obtain consent and verify each person’s input data.",
      "Choose synastry, composite or another explicitly defined construction.",
      "Identify a few interactions and describe more than one possible expression.",
      "Compare with both people’s accounts and preserve disagreements."
    ],
    "useCases": [
      "Voluntary relationship reflection",
      "Learning the difference between relational chart methods"
    ],
    "inputs": [
      "At least two sets of birth data",
      "Consent",
      "A named comparison rule"
    ],
    "limits": "A second person’s birth data are required. The current birth report contains no relationship chart; geometry cannot establish consent, attraction, fidelity or a relationship’s future.",
    "systems": [
      17,
      42,
      45
    ],
    "references": [
      {
        "title": "Human Design Dictionary",
        "url": "https://jovianarchive.com/pages/human-design-dictionary",
        "kind": "official practitioner glossary"
      },
      {
        "title": "Swiss Ephemeris Programmer’s Manual",
        "url": "https://www.astro.com/swisseph/swephprg.htm",
        "kind": "technical specification"
      }
    ]
  },
  {
    "id": "locational",
    "title": "Locational and relocation study",
    "description": "Examine how the same birth instant projects onto different places. Relocation changes local angles and houses; geometric astrocartography follows places where an object is on a meridian or horizon. These are coordinate relationships. Turning them into narratives about travel or belonging is a separate interpretive choice.",
    "steps": [
      "Keep the birth instant fixed and specify candidate locations.",
      "Choose relocation, meridian/horizon lines or local-space azimuths.",
      "Record refraction, parallax and line-distance conventions.",
      "Use any symbolic discussion alongside real information about the places."
    ],
    "useCases": [
      "Understanding chart geometry",
      "Reflecting on experiences of place"
    ],
    "inputs": [
      "Birth instant",
      "Geographic coordinates",
      "The chosen angular or azimuthal model"
    ],
    "limits": "The engine provides sampled geometric line coordinates, not a complete relocation recommendation. A line does not establish safety, opportunity, belonging or a reason to make a costly move.",
    "systems": [
      13,
      10,
      46
    ],
    "references": [
      {
        "title": "Swiss Ephemeris Programmer’s Manual",
        "url": "https://www.astro.com/swisseph/swephprg.htm",
        "kind": "technical specification"
      },
      {
        "title": "Skyfield: Coordinates",
        "url": "https://rhodesmill.org/skyfield/coordinates.html",
        "kind": "technical documentation"
      }
    ]
  },
  {
    "id": "electional",
    "title": "Electional selection",
    "description": "Electional astrology compares possible start times for a specified activity using a chosen rule set. Frawley’s practitioner account emphasizes matching planetary conditions to the undertaking. A transparent comparison states priorities and practical constraints first, because no single moment can satisfy every possible symbolic preference.",
    "steps": [
      "Define the activity, location and realistic time window.",
      "Choose the tradition and rank its criteria before searching.",
      "Reject times that fail real-world constraints before comparing symbolic scores.",
      "Explain tradeoffs and preserve more than one feasible option."
    ],
    "useCases": [
      "Studying how electional rules operate",
      "Comparing optional ceremonial or creative start times"
    ],
    "inputs": [
      "Purpose",
      "Location",
      "Permitted date range",
      "Ranked rule set"
    ],
    "limits": "No electional optimizer is implemented. Symbolic preferences should not override deadlines, accessibility, consent, professional advice or practical evidence, and cannot guarantee success.",
    "systems": [
      15,
      3,
      21,
      22
    ],
    "references": [
      {
        "title": "John Frawley: Electional Astrology",
        "url": "https://direct.skyscript.co.uk/electional.html",
        "kind": "original practitioner teaching"
      }
    ]
  },
  {
    "id": "horary",
    "title": "Horary or question-chart reading",
    "description": "Horary asks a defined question through the chart of an agreed question moment. Its significators and judgement rules belong to a particular tradition. A birth chart is not automatically a horary chart, and changing the question or timestamp can change the entire construction.",
    "steps": [
      "Write the exact question and the convention for its effective time and place.",
      "Identify the relevant houses and significators using the chosen text.",
      "Trace aspects, reception and other testimonies in that same system.",
      "State uncertainty and separate symbolic judgement from independently obtainable facts."
    ],
    "useCases": [
      "Historical study of interrogational astrology",
      "Low-stakes exploration of a clearly posed question"
    ],
    "inputs": [
      "Question",
      "Question time and place",
      "Named judgement tradition"
    ],
    "limits": "The engine has no complete horary judgement module. Do not use it to diagnose illness, accuse another person, establish hidden facts or replace available evidence.",
    "systems": [
      14,
      3,
      21
    ],
    "references": [
      {
        "title": "John Frawley: Horary Astrology",
        "url": "https://direct.skyscript.co.uk/frawley.html",
        "kind": "original practitioner teaching"
      },
      {
        "title": "William Lilly: Christian Astrology (1647)",
        "url": "https://www.skyscript.co.uk/CA/CA_DH.pdf",
        "kind": "historical primary text"
      }
    ]
  },
  {
    "id": "mundane",
    "title": "Mundane and collective-cycle study",
    "description": "Mundane astrology concerns collective settings such as kingdoms, institutions and public events. Historical sources contain several approaches, including conjunctions and ingress charts. A responsible modern study distinguishes the origin of each method from its later use and avoids selecting event dates only because they fit a desired story.",
    "steps": [
      "Define the institution or event and document the disputed date if necessary.",
      "Select the cycle or ingress rule before comparing outcomes.",
      "Use a consistent event dataset and include unsuccessful matches.",
      "Keep historical interpretation separate from causal or predictive claims."
    ],
    "useCases": [
      "History of political astrology",
      "Comparative study of public-event narratives"
    ],
    "inputs": [
      "A documented event or institution",
      "A consistent dataset",
      "A named timing and location convention"
    ],
    "limits": "Raw cycles do not establish causes of disasters or public behavior. This guide supplies neither trading signals nor medical, electoral or geopolitical forecasts.",
    "systems": [
      16,
      18,
      49,
      3
    ],
    "references": [
      {
        "title": "David Pingree and Christopher Brunner: Astrology and Astronomy in Iran",
        "url": "https://www.iranicaonline.org/articles/astrology-and-astronomy-in-iran/",
        "kind": "scholarly encyclopedia"
      },
      {
        "title": "Francesca Rochberg: Babylonian Horoscopes",
        "url": "https://mc.dlib.nyu.edu/files/books/isaw_aphs000011/isaw_aphs000011_lo.pdf",
        "kind": "scholarly edition of primary texts"
      }
    ]
  },
  {
    "id": "contemplative",
    "title": "Contemplative study",
    "description": "Contemplative approaches use a symbol or text as something to revisit over time. Gene Keys is one modern example; Yijing traditions offer distinct forms of reflection that should retain their own provenance. The purpose of this guide is attentive reading and self-observation, not extracting a verdict from every coincidence.",
    "steps": [
      "Choose one text or sphere and verify how it was selected.",
      "Read a short passage in its original context.",
      "Reflect quietly or journal about a specific experience.",
      "Return later and note changes in understanding without forcing agreement."
    ],
    "useCases": [
      "Slow reading",
      "Personal values reflection"
    ],
    "inputs": [
      "A selected text",
      "Its translation or teaching source",
      "Optional chart-derived prompt"
    ],
    "limits": "Different traditions have different aims. This practice should not promise enlightenment, genetic change, healing or certainty, and the reader may stop when it is unhelpful.",
    "systems": [
      43,
      42,
      51,
      41
    ],
    "references": [
      {
        "title": "Richard Rudd: Hologenesis and the Sacred Wound",
        "url": "https://genekeys.com/articles/hologenesis-and-the-sacred-wound-the-story-behind-your-profile/",
        "kind": "originator account"
      },
      {
        "title": "Chinese Philosophy of Change (Yijing)",
        "url": "https://plato.stanford.edu/entries/chinese-change/",
        "kind": "scholarly encyclopedia"
      }
    ]
  },
  {
    "id": "energetic-esoteric",
    "title": "Energetic and esoteric interpretation",
    "description": "Esoteric systems may interpret charts through rays, subtle centers, soul-development narratives or spiritual correspondences. These terms belong to named teachings; identical words across traditions need not mean the same thing. This guide approaches them as attributed religious or philosophical frameworks while keeping measured astronomy separate.",
    "steps": [
      "Identify the teacher, text and meaning of each energetic term.",
      "State which astronomical factors are actually calculated.",
      "Label the additional correspondence as a teaching or belief.",
      "Explore its personal meaning without converting it into a biological claim."
    ],
    "useCases": [
      "Comparative study of modern esotericism",
      "Optional symbolic reflection"
    ],
    "inputs": [
      "Named lineage",
      "Its correspondence tables",
      "A chart if the system requires one"
    ],
    "limits": "No measured energy field, cosmic ancestry or medical state follows from these overlays. Spiritual language should not support superiority claims or pressure someone to accept a reading.",
    "systems": [
      5,
      42,
      43,
      44,
      45,
      47
    ],
    "references": [
      {
        "title": "Sarah McKechnie: The Science of the Seven Rays",
        "url": "https://www.lucistrust.org/arcane_school/talks_and_articles/the_science_the_seven_rays",
        "kind": "lineage practitioner teaching"
      },
      {
        "title": "About Human Design",
        "url": "https://jovianarchive.com/pages/about-human-design",
        "kind": "originator archive"
      },
      {
        "title": "The Nobel Prize in Physics 2015",
        "url": "https://www.nobelprize.org/prizes/physics/2015/summary/",
        "kind": "scientific institution"
      }
    ]
  },
  {
    "id": "historical",
    "title": "Historical and textual reconstruction",
    "description": "Ask what a practice meant to its original users before applying modern chart categories. Tablets, monuments, manuscripts and later translations provide different kinds of evidence. Reconstruction compares these materials and marks gaps; it does not presume that present-day terminology captures every earlier tradition.",
    "steps": [
      "Identify the object or text, date, place and transmission history.",
      "Distinguish original evidence from later commentary and modern reconstruction.",
      "Translate technical terms cautiously and record alternatives.",
      "Use astronomy to investigate possible conditions without treating it as proof of the associated omen."
    ],
    "useCases": [
      "Cultural history",
      "Evaluating claims of ancient origins"
    ],
    "inputs": [
      "Primary objects or texts",
      "Scholarly editions",
      "Historical calendar assumptions"
    ],
    "limits": "Damaged sources, uncertain dating and changing star identifications can prevent a unique reconstruction. A modern birthday chart does not substitute for that evidence.",
    "systems": [
      49,
      50,
      2,
      3,
      35,
      38,
      51
    ],
    "references": [
      {
        "title": "British Museum: Enuma Anu Enlil tablet Sp.II.197",
        "url": "https://www.britishmuseum.org/collection/object/W_Sp-II-197",
        "kind": "museum object record"
      },
      {
        "title": "Astronomical Ceiling from the Tomb of Senenmut",
        "url": "https://www.metmuseum.org/art/collection/search/544566",
        "kind": "museum object and reconstruction record"
      },
      {
        "title": "Tim Husband: Before Fortune-Telling, the History and Structure of Tarot Cards",
        "url": "https://www.metmuseum.org/pt/perspectives/tarot-2",
        "kind": "museum scholarship"
      },
      {
        "title": "David Pingree and Christopher Brunner: Astrology and Astronomy in Iran",
        "url": "https://www.iranicaonline.org/articles/astrology-and-astronomy-in-iran/",
        "kind": "scholarly encyclopedia"
      }
    ]
  },
  {
    "id": "astronomical",
    "title": "Astronomical and computational reading",
    "description": "Read a result first as a coordinate calculation: when, from where, in what frame and using which ephemeris? This lens explains why different programs can disagree without either containing an arithmetic error. It also identifies the boundary where observed or modeled sky positions end and symbolic interpretation begins.",
    "steps": [
      "Verify civil time, time zone, location and time scale.",
      "Record geocentric or topocentric viewpoint, zodiac and coordinate epoch.",
      "Inspect returned ephemeris flags and any missing-data messages.",
      "Compare like-for-like positions with an independent implementation and separate numerical accuracy from interpretive validity."
    ],
    "useCases": [
      "Reproducibility checks",
      "Understanding why charts differ"
    ],
    "inputs": [
      "UTC or resolvable local time",
      "Coordinates",
      "Ephemeris and calculation settings"
    ],
    "limits": "Machine precision is not birth-data precision. Agreement on positions validates a calculation under its assumptions, not a personality, spiritual or predictive theory.",
    "systems": [
      0,
      1,
      10,
      11,
      12,
      13,
      22,
      46,
      48
    ],
    "references": [
      {
        "title": "Swiss Ephemeris Programmer’s Manual",
        "url": "https://www.astro.com/swisseph/swephprg.htm",
        "kind": "technical specification"
      },
      {
        "title": "Skyfield: Coordinates",
        "url": "https://rhodesmill.org/skyfield/coordinates.html",
        "kind": "technical documentation"
      },
      {
        "title": "IAU: The Constellations",
        "url": "https://iauarchive.eso.org/public/themes/constellations/",
        "kind": "astronomical institution"
      }
    ]
  },
  {
    "id": "comparative",
    "title": "Comparison across systems",
    "description": "Compare systems through their actual inputs, rules and purposes rather than forcing them to deliver one combined identity. A tropical Sun, a sidereal Moon mansion, a sexagenary pillar and a Human Design gate answer different formal questions. A shared label or number may be coincidence, historical borrowing or a chosen correspondence.",
    "steps": [
      "Choose a small set of systems and state what each output represents.",
      "Align the birth instant while preserving each calendar and zodiac convention.",
      "Trace any claimed correspondence to a named source.",
      "Present agreements and contradictions without declaring a winner from personal resonance alone."
    ],
    "useCases": [
      "Learning system boundaries",
      "Evaluating claims of universal equivalence"
    ],
    "inputs": [
      "Documented calculation outputs",
      "Source traditions",
      "A comparison question"
    ],
    "limits": "A synthesized reading requires additional authored choices. Do not call matching numbers independent confirmation, especially when one system derives its inputs from another.",
    "systems": [
      0,
      1,
      21,
      29,
      38,
      41,
      42,
      43,
      48,
      51
    ],
    "references": [
      {
        "title": "What planets does each Sphere correlate to?",
        "url": "https://genekeys.com/docs/what-planets-does-each-sphere-of-the-golden-path-profile-correlate-to/",
        "kind": "official practitioner specification"
      },
      {
        "title": "Joseph A. Adler: What Is the Yijing?",
        "url": "https://academic.oup.com/book/41418/chapter-abstract/352738571",
        "kind": "academic author / publisher"
      },
      {
        "title": "IAU: The Constellations",
        "url": "https://iauarchive.eso.org/public/themes/constellations/",
        "kind": "astronomical institution"
      }
    ]
  }
]