A computational system that reveals the invisible geometry of the celestial field — the terrain of possibility underlying every life trajectory.
This document is the canonical reference for all public communication about Abu Oracle. It establishes the unified conceptual framework, official terminology, authorised analogies, and system boundaries.
It is built from three integrated sources:
All communication materials — Twitter/X threads, Instagram posts, articles, explainer videos — must be consistent with the framework established here.
Abu Oracle is a computational astrology engine that calculates, for any natal chart, a geographic scalar field called the Harmony Field (HF). This field assigns a numerical value to every coordinate on Earth and answers the question: where are the structural conditions most favourable for a specific life domain of this person?
The system does not predict. It does not divine. It maps terrain — the geometry of the natal potential projected onto the surface of the planet.
Abu Oracle is named after Abu Mashar al-Balkhi (787–886 CE), the Persian medieval astronomer and mathematician who systematised Arab astrology and established its astronomical foundations. The choice signals the intellectual tradition the system inhabits: mathematical rigour applied to the interpretation of the sky.
"The system does not say: you will succeed here. It says: here the principles governing your domain find greater resonance."
— Axiomatics of Heavens v0.4, Axiom 9.2
Abu Oracle's conceptual framework is built on an analogy with the differential geometry of illumination. This analogy is not decorative — it is structurally precise.
For every surface there exists a field of normals: the vector perpendicular to the surface at each point. This field is invisible to the eye, yet it is the fundamental quantity on which all illumination depends. Light does not interact with shape directly — it interacts with the local orientation of the surface.
The normals field is recovered computationally as the gradient of the depth field in two orthogonal directions:
A natal chart is a computable projection of the state of the solar system at the moment and place of birth. Formally, it is a function π : ℋ → ℝⁿ parametrised by the observer's spatiotemporal coordinates. But the chart computed at its natal location is only the depth map — it records the scalar value at a single point. It does not yet reveal the field — only one measurement of it.
Relocation is differentiation. When the observer moves across the Earth's surface, the Ascendant rotates, the Midheaven shifts, the houses reorganise. The natal planets, fixed in position, begin to speak differently at every new horizon.
The field does not predict where good things will happen. It reveals where the surface of a life turns toward the light.
| Optics / Shader | Abu Oracle | |
|---|---|---|
| Depth field d(u,v) | ≡ | Natal chart — fixed potential |
| Normals field n(u,v) | ≡ | Harmony Field HF(φ,λ) |
| Horizontal gradient dL − dR | ≡ | Geographic displacement (relocation) |
| Vertical gradient dD − dU | ≡ | Temporal displacement (dasha / transit) |
| Light source direction | ≡ | Domain of inquiry (career, health, love) |
| Surface illumination | ≡ | Biographical outcome at location × time |
The most important empirical finding of the system is not that the field exists — it is that its signal depends critically on the specificity of the question.
A field computed over all planets simultaneously is a field of total astrological activity, not of specific harmony for any particular life domain. It illuminates the surface from all directions at once: it shows everything and therefore reveals nothing clearly.
Empirical validation over 527 biographical events confirms this:
| Field | Correlation with biographical valence | Cohen's d |
|---|---|---|
| HF global (all planets) | r = 0.155 | 0.441 |
| HF health domain (H6/H8 significators) | r = 0.615 | +0.93 vs global |
The global field is not wrong — it is deaf to the specific question. The signal exists but is dispersed across all frequencies simultaneously.
For the field to be interpretable, it must be filtered by the domain of the query. Each life domain is governed by a specific subset of planets: the significators of the corresponding house.
"The system cannot answer 'where does my career thrive?' if the question asked is 'where is everything better?'. A well-formed question activates a subset."
— Axiomatics of Heavens v0.4, Axiom 8.3
The geographic field is one dimension of a wider space. For a life domain to fully activate, three concurrent conditions are required:
| Condition | Description | Status |
|---|---|---|
| 1. Natal potential | Significators are well-disposed in the natal chart. | Implemented |
| 2. Geographic resonance | The domain HF is favourable at the location. | Implemented |
| 3. Temporal activation | The planetary period activates the same significators. | Next horizon |
In the Jyotish tradition, temporal activation is measured through dashas — planetary periods determining which planet speaks at each life moment. The domain HF is the spatial dimension of the same problem. They are distinct coordinates of the same space of manifestation.
| Principle | Compatibility | Path / Note |
|---|---|---|
| Birth date as activation code | High ✓ | Axioms 2.1, 3.1 — the natal chart is precisely this, with astronomical grounding. |
| Behavioural programs (karma) | Partial ~ | Only as a separate Jyotish agent (Axiom 4.3). Never as a cross-cutting layer. |
| Real-time planetary influence | High ✓ | Axiom 9.3 — already implemented (transits, firdariyyat, Solar Return). |
| Free will vs determinism | High ✓ | Axioms 7.2, 9.2 — explicit philosophical position of the system. |
| Tarot arcana (22 major arcana) | Low ✗ | Distinct corpus. Integration would violate Axiom 6.4. |
"Destiny is not fixed — but the terrain has shape. Abu Oracle shows you where the shape of the terrain favours what you want to build."
The Axiomatics establishes with precision what cannot be integrated without loss of coherence. Axiom 6.4 is unequivocal:
"Semantic contamination between traditions is a design flaw, not an enriching synthesis."
— Axiomatics of Heavens v0.4, Axiom 6.4
The numerological system of Matriz del Destino (date as number mapped to arcana) and the astronomical engine of Abu Engine (topocentric computation with Swiss Ephemeris) have incompatible epistemologies. Synthesising them without layer separation produces exactly what the Axiomatics calls semantic contamination. Abu Oracle does not do this. This clarity is a strength, not a limitation.
| Term | Canonical definition | What it is not |
|---|---|---|
| Harmony Field (HF) | Geographic scalar field quantifying the resonance of natal potential at each Earth coordinate for a given domain. | Not an 'energy map'. Does not measure vibrations. |
| Resonance | Mathematical measure of the degree to which the angular configuration of significator planets approximates specific aspect patterns. | Not a metaphor. It is a calculated numerical value. |
| Life domain | Area of human experience governed by a specific astrological house and its planetary significators. | Not an 'energy category'. It is a classical doctrinal structure. |
| Significators | Planets that rule and/or occupy a given house in the natal chart. | Not generic 'influential planets'. |
| Relocation | Evaluation of HF at locations other than the natal place to identify geographies with greater resonance for a domain. | Not 'moving so the stars help you'. It is mapping potential. |
| Latent potential | Capacity of a domain to manifest, conditioned by the disposition of its significators in the natal chart. | Not a guarantee of outcome. It is a structural condition. |
| Lilly | The system's LLM agent, inspired by William Lilly (1647). Operates on the user's specific cartographic context. | Not a generic chatbot. |
Astrology does not tell you what will happen. It tells you the shape of the terrain. Abu Oracle computes that shape.
"The field does not predict where good things will happen. It reveals where the surface of a life turns toward the light."
"The system does not say: you will succeed professionally here. It says: here the principles governing your career find greater resonance."
"The field does not create potential where none exists — it facilitates the expression of potential that already exists in latent form."
"Destiny is not fixed, but the terrain has shape."
| Audience | Entry point | Core argument |
|---|---|---|
| Astrocartography users | Already know geography matters. | Abu Oracle quantifies it with precision and filters by domain. |
| Matriz del Destino users | Believe in free will within a structural pattern. | Abu Oracle computes exactly that. Your map has shape. |
| Sceptics / data-oriented | Distrust astrology as pseudoscience. | The system is falsifiable. Empirical correlation over 527 events: r=0.155 global → r=0.615 by domain. |
| General spiritual audience | Seeks meaning and personal guidance. | The field does not tell you what to do. It shows you the terrain. The decision is yours. |
Abu Oracle is the only astrological relocation system with published empirical validation. The results below correspond to March 2026.
| Field configuration | Correlation HF ↔ valence | Improvement |
|---|---|---|
| HF global (no domain filter) | r = 0.155, Cohen's d = 0.441 | — |
| HF health domain (H6/H8) | r = 0.615 | +0.93 in Cohen's d |
The finding confirms Axiom 8.1: the global field is not wrong — it captures total astrological activity. It is deaf to the specific question because it mixes all frequencies simultaneously. Domain filtering produces a +0.93 improvement in Cohen's d over health events.
This is the founding empirical finding of the system. It validates the core architectural decision: the domain selector is not a UX convenience — it is the implementation of an epistemic requirement.
Methodological note: for H10 (Career) Pearson correlation is unreliable due to class imbalance in the corpus (celebrity-heavy dataset). The operative metric for that domain is Cohen's d.