AXQ Holistic Marriage Index: System Design Document

 1.0 Introduction to the AXQ Framework

1.1. System Overview

The AXQ Holistic Marriage Index (HMI) is a sophisticated, governance-grade evaluative system engineered to serve the core tenets of Arreqqana society. Its strategic importance is rooted in its capacity to ensure social harmony, optimize marital alliances between families, and uphold the principles of diligent lineage stewardship. By translating a wide spectrum of individual attributes into a standardized, doctrinally-sound metric, the HMI provides a foundational tool for making decisions of generational consequence with clarity and confidence.

1.2. Document Purpose

The core purpose of this System Design Document is to provide a definitive technical and strategic overview of the AXQ HMI framework. It is intended to serve as a canonical reference for system architects responsible for its implementation, temple governance bodies overseeing its application, and family councils utilizing its outputs for strategic planning.

1.3. System Scope

The scope of the system is comprehensive, encompassing the entire matchmaking and alliance process. Its functionality ranges from the granular assessment of a single individual—based on a suite of objective micro-tests—to the large-scale, computational optimization of multi-family alliances. The system is designed to be scalable, auditable, and aligned at every level with established Arreqqana doctrine.

1.4. Transition

This document will now proceed to a high-level overview of the system's architecture and end-to-end process flow.

2.0 System Architecture & Process Flow

2.1. Architectural Strategy

The strategic value of the AXQ system lies in its multi-layered architecture. This design ensures that granular individual data is methodically processed through successive layers of doctrinal rules, gender-specific calibrations, and energetic validation protocols. The result is a holistic and highly reliable suitability assessment that moves far beyond simplistic, single-attribute evaluations.

2.2. End-to-End Process Flow

The system's end-to-end process flow follows a clear, logical sequence from initial data capture to final strategic output generation. This flow ensures consistency, transparency, and doctrinal integrity at every stage.

1. Individual Assessment: Granular, quantifiable data is captured for each candidate using a series of standardized Domain Micro-Tests and audits. This forms the objective foundation for the entire evaluation.

2. Domain Scoring: The raw data from the micro-tests is processed through domain-specific formulas and rubrics to calculate a standardized 1-10 score for each of the six core domains.

3. Base HMI Calculation: The six domain scores are entered into the canonical HMI formula, where they are weighted according to their doctrinal importance to compute an initial Holistic Marriage Index score.

4. Calibration & Adjustment: The Base HMI is refined through two subsequent layers. First, gender-specific calibration rules are applied to account for distinct socio-cultural expectations. Second, energetic compatibility modifiers (Flame Distance and Thread Compatibility) are integrated to adjust the score based on deeper energetic harmonies.

5. Risk Analysis: A predictive Conflict-Risk Forecast is generated using the final adjusted score and key variances between the candidates. This provides actionable insight into potential challenges within the proposed union.

6. Output Generation: The system generates a suite of tailored outputs, including formal Temple Marital Suitability Reports for individual pairings, intuitive user interface views for matchmaking, and comparative dashboards for council-level review.

7. Alliance Optimization: At the highest level, aggregate data from multiple candidates is fed into a House Alliance Optimizer tool, which uses graph-based modeling to identify optimal marital pairings across multiple families for maximum generational stability and gain.

2.3. Transition

Having outlined the overall architecture, the following section provides a detailed breakdown of the core scoring algorithm that sits at the heart of the system.

3.0 Core Scoring Framework: The Holistic Marriage Index (HMI)

3.1. Introduction

The Holistic Marriage Index (HMI) is the central algorithm of the AXQ system. It is meticulously designed to translate a wide array of multifaceted human attributes—spanning the physical, emotional, spiritual, and social spheres—into a single, standardized, and actionable metric. This metric serves as the foundational data point for all subsequent analysis, comparison, and decision-making within the framework.

3.2. Canonical Rating Dimensions

3.2.1. Domain & Attribute Table

The HMI is calculated from six distinct, weighted domains. Each domain is assessed through a specific Lens of Intelligence to ensure a balanced and comprehensive evaluation, preventing any single attribute from dominating the outcome.

Domain Name

Associated Lens(es) of Intelligence

Core Attributes Assessed

Physical Attractiveness (PA)

Rru-Sen dominant

Health, symmetry, vitality, grooming, bodily presence.

Personality & Temperament (PT)

Rru-Sen + House-Strategy

Emotional regulation, kindness, discipline, humor, cooperation.

Spiritual Alignment (SA)

Doctrine-Panata

Ritual consistency, faith maturity, humility, devotion, ethical conduct.

Clan Lineage (CL)

Time-Nora

Ancestral reputation, Life Book integrity, generational stability.

Social Class & Contribution (SC)

House-Strategy

Education, vocation, leadership, service, economic responsibility.

Regional / Country Standing (RC)

Time-Nora + House-Strategy

Cultural compatibility, dialect, customs, regional prestige or hardship.

3.3. Base HMI Calculation Algorithm

3.3.1. Canonical Formula

The Base HMI is computed using a weighted average of the six domain scores. The weights are fixed within the canonical formula to reflect their established importance in fostering a stable and prosperous union.

HMI = (PA×0.15) + (PT×0.20) + (SA×0.20) + (CL×0.15) + (SC×0.15) + (RC×0.15)

3.3.2. Final Score Scaling

The resulting HMI score is then multiplied by 10 to produce the final score on a 0-100 scale.

3.3.3. HMI Interpretation Bands

The final score is interpreted according to the following classification bands.

Score Range (0-100)

Tier Classification

90–100

Prime Union

80–89

Noble Tier

70–79

High Match

60–69

Solid Match

50–59

Functional

<50

Not Recommended

3.4. Doctrinal Governance Gates

3.4.1. Gate Function

To enforce the core tenets of the framework and prevent high scores based on superficial attributes alone, the system incorporates non-negotiable Doctrinal Gates. These function as system overrides that constrain the final HMI score if foundational requirements are not met.

3.4.2. Gate Rules

• Spiritual Alignment Gate: If a candidate's Spiritual Alignment (SA) score is less than 7, their Final HMI is capped at 84.

• Clan Lineage Gate: If a candidate's Clan Lineage (CL) score is less than 6, their Final HMI is capped at 84.

3.5. Transition

The Base HMI provides a robust initial assessment, which is then passed through subsequent layers of calibration and adjustment for greater nuance.

4.0 Score Calibration & Energetic Adjustment Layers

4.1. Introduction

The Base HMI score serves as a foundational metric that is further refined through two critical layers of processing: calibration and adjustment. These layers are designed to account for the specific social roles individuals are expected to fulfill and the underlying energetic compatibilities that influence a union's harmony. This process ensures a more nuanced and accurate final assessment that reflects both societal expectations and deeper energetic realities.

4.2. Gender-Specific Calibration Rules

4.2.1. AXQ Male Calibration

• Higher Weight Expectation: A greater emphasis is placed on Social Contribution and Spiritual Alignment, reflected by a +5% weighting adjustment in each domain.

• Minimum Thresholds: A candidate must score SA ≥ 7 and SC ≥ 7 (demonstrating the capacity to support a household).

• Bonus: A bonus of +0.3 HMI is awarded for demonstrated leadership or significant service.

4.2.2. AXQ Female Calibration

• Higher Weight Expectation: A greater emphasis is placed on Personality & Temperament and Spiritual Alignment, reflected by a +5% weighting adjustment in each domain.

• Minimum Thresholds: A candidate must score SA ≥ 7 and PT ≥ 7 (demonstrating strong emotional regulation).

• Bonus: A bonus of +0.3 HMI is awarded for positive sisterhood harmony indicators.

4.2.3. Equality Clause

All bonuses and weight adjustments are applied within their respective domains. The total weighting for the HMI calculation always remains 100%, ensuring that the calibration process does not artificially inflate scores.

4.3. Energetic Compatibility Modifiers

4.3.1. Flame Distance (FD)

Flame Distance measures the energetic proximity between the candidates' Birth Flames. A score modifier is applied to the HMI based on this proximity.

• Optimal (0.8–1.5): +5 HMI

• Acceptable (1.6–2.4): +0 HMI

• High Friction (≥2.5): −5 HMI

4.3.2. Thread Compatibility (TC)

Thread Compatibility assesses the harmonic relationship between the candidates' core energetic signatures.

• Same Thread: Stable and reinforcing. +3 HMI

• Complementary (e.g., Flame–River): Dynamic and synergistic. +5 HMI

• Opposed (e.g., Stone–Wind): Challenging and requires conscious effort. −3 HMI

4.4. Final Adjusted Score & Doctrine Cap

4.4.1. Final Score Formula

The final score is calculated by integrating the energetic modifiers with the Base HMI. Final HMI = Base HMI + FD Modifier + TC Modifier

4.4.2. Doctrine Cap

A final governance rule, the Doctrine Cap, is applied to this score. This rule states that the Final HMI cannot exceed 95 without the performance and validation of a formal Temple Witness Rite, ensuring that claims of "perfect" compatibility are subject to the highest level of spiritual oversight.

4.5. Transition

This final score is derived from a robust set of underlying data inputs, which are detailed in the following section.

5.0 Data Inputs & Assessment Instruments

5.1. Introduction

The integrity of the entire AXQ framework rests upon the quality and standardization of its data inputs. To ensure objectivity and consistency in the initial assessment phase, each of the six domain scores is derived from a series of quantifiable micro-tests, audits, and ledgers. This structured approach provides a transparent and auditable foundation for the HMI calculation.

5.2. Domain Assessment Instruments

5.2.1. Physical Attractiveness (PA) Assessment

• Input Sources: A 10-item instrument (1-5 points each) covering Vitality check (sleep, hydration), Grooming consistency, Movement & posture, Health markers (non-medical), Presence confidence, Sensory harmony (voice, scent), Physical discipline routine, Stress recovery speed, Injury management, and Seasonal adaptation.

• Formula: PA = round((sum of 10 item scores / 50) × 10)

5.2.2. Personality & Temperament (PT) Assessment

• Input Sources: Five micro-scales measuring Emotional regulation, Conflict response, Empathy & listening, Reliability, and Humor without harm.

• Formula: PT = round((average of 5 scale scores / 5) × 10)

5.2.3. Spiritual Alignment (SA) Assessment

• Input Sources: The Ritual Adherence Index (RAI), which measures Consistency of practice, Ethical follow-through, Humility checks, Gratitude cycle use, and Temple/community presence.

• Domain-Specific Gate: If any single item on the RAI is scored ≤2, the final SA score is capped at 6.

• Formula: SA = round((RAI average score / 5) × 10)

5.2.4. Clan Lineage (CL) Assessment

• Input Sources: A formal Life Book Audit assessing Completeness, Accuracy, Dispute history, Inter-house relations, and Elder testimony.

• Formula: CL = round((audit average score / 5) × 10)

5.2.5. Social Class & Contribution (SC) Assessment

• Input Sources: The Contribution Ledger, which measures Economic stability, Skill contribution, Service record, Leadership instances, and Dependents supported.

• Formula: SC = round((ledger average score / 5) × 10)

5.2.6. Regional Compatibility (RC) Assessment

• Input Sources: Adaptability Tests covering Dialect comprehension, Custom observance, Food/lifestyle fit, Conflict norms, and Mobility tolerance.

• Formula: RC = round((adaptability average score / 5) × 10)

5.3. Transition

This granular, multi-instrument approach provides a robust and auditable foundation for the entire HMI calculation. The system then translates this complex data into a series of clear and actionable outputs.

6.0 System Outputs & User Interfaces

6.1. Introduction

The outputs of the AXQ HMI system are carefully tailored to meet the distinct needs of its different user groups, from individual candidates and temple officials to family councils engaged in high-level strategic planning. The system's interfaces are designed to render complex analytical data into intuitive, actionable formats, facilitating informed decision-making at every level.

6.2. Reporting for Individual Pairings

6.2.1. Temple Marital Suitability Report

This formal, scroll-style document serves as the official record of a proposed union's assessment. Its structure includes:

• Qhavvarella (Header): Contains identifying information for both candidates, the temple/region, and the date.

• Domain Scores: A table presenting the 1-10 scores for each of the six domains for both candidates, along with the calculated average.

• Marriage Index and Tier: Displays the final HMI score (0-100) and its corresponding tier classification (e.g., Noble Tier).

• Flame & Thread Analysis: Summarizes the key energetic compatibility metrics, including Flame Distance and Thread Harmony.

• Temple Verdict: A section for the final decision (Approved, Conditional, Deferred, or Denied), with space for conditions and placeholders for temple seals such as Qheta-Taliir and Qheta-Naarun.

6.2.2. Matchmaking UI Wireframe

A mobile application interface provides an at-a-glance comparison of two candidates, designed for rapid assessment. Key components include:

• Side-by-side display of each candidate's six domain scores.

• A prominent display of the combined Marriage Index (HMI) and its Tier.

• Clear indicators for Flame Distance (e.g., "1.2 (Optimal)") and Thread Harmony, with selectable states for ☐ High ☐ Moderate ☐ Low.

• Interactive elements such as a button to View Temple Report and a Simulate Conflicts button. Key interactions include the ability to Tap domain → breakdown rubric and Tap Flame Distance → mandala view.

6.3. Interfaces for Governance & Alliance Planning

6.3.1. Batch Family-Council Comparison Screen

This dashboard interface is designed for family councils to efficiently compare multiple candidates simultaneously. The screen is structured as a filterable table to facilitate strategic decision-making.

Candidate

HMI

Tier

FD

TC

Risk

Notes

A (Saara)

86

NT

1.2

+5

Low

Strong SA/PT

B (Jarru)

87

NT

1.1

+5

Low

Balanced lead

C (X)

79

HM

1.9

+0

Med

RC friction

D (Y)

72

SM

2.6

-5

High

SA weak

The interface includes powerful council filters, allowing users to screen candidates based on criteria such as Doctrinal Gate failures, regional match, Flame complementarity, and risk band.

6.3.2. House Alliance Optimizer

This is a high-level strategic tool designed to optimize marital alliances across multiple houses for maximum generational stability and benefit.

• Graph Model: The optimizer represents individuals as Nodes and potential unions as Edges. Each edge is weighted by the Final HMI score, augmented by Alliance Bonus Factors.

• Alliance Bonus Factors: These include external strategic considerations like trade complementarity, the ratification of peace treaties, skill diversity, and geographic balance.

• Constraints: The model operates under hard constraints, including SA/CL gates, regional caps, and Flame conflicts.

• Key Outputs: The tool generates a list of top-ranked pairings, a risk heatmap visualizing potential friction points between houses, and a generational projection of the proposed alliances' likely outcomes.

6.4. Automated Document Generation

6.4.1. Temple Scroll PDF Module

The system includes a module for the automated generation of formal Temple Scroll PDFs to ensure efficiency and doctrinal integrity.

• Required Inputs: Candidate profiles, all domain micro-test outputs, Flame & Thread data, and the final Risk Index score.

• Primary PDF Outputs:

    1. Marital Suitability Scroll

    2. Flame Distance Mandala Page

    3. Risk Forecast & Mitigation Page

    4. Council Verdict Page

• Doctrine Lock: Once the required temple signatures are applied, the PDF documents are hash-sealed, rendering them tamper-proof and creating a permanent, auditable record.

6.5. Transition

These outputs are directly informed by the system's predictive risk management capabilities, which are detailed next.

7.0 Predictive Analytics & Risk Management

7.1. Introduction

The strategic function of the AXQ system moves beyond simple compatibility scoring by incorporating a predictive risk forecast engine. This capability transforms the HMI from a static metric into a dynamic governance tool, enabling family councils and temple authorities to proactively identify potential areas of conflict and implement mitigation protocols to support the long-term success of proposed unions.

7.2. Conflict-Risk Forecast Algorithm

7.2.1. Risk Index Formula

The system calculates a comprehensive Risk Index (0-100) for each potential pairing. This index is derived from the final HMI score and key variances in foundational domains.

Risk = (100 − HMI) + (FD Risk × 10) + (Thread Opposition × 5) + (PT Variance × 8) + (SA Gap × 6)

7.2.2. Variable Definitions

• FD Risk: A scaled value based on Flame Distance: 0 for Optimal (≤1.5), 1 for Acceptable (1.6–2.4), and 2 for High Friction (≥2.5).

• Thread Opposition: A scaled value based on compatibility: 0 for Same Thread, 1 for Complementary, and 2 for Opposed.

• PT Variance: The absolute difference between the two candidates' Personality & Temperament scores, divided by two: |PT_A − PT_B| / 2.

• SA Gap: A penalty applied if either candidate's Spiritual Alignment score falls below the doctrinal minimum of 7: max(0, 7 − min(SA_A, SA_B)).

7.3. Risk Tiers & Mitigation Protocols

7.3.1. Risk Band Table

The calculated Risk Index places a union into one of five tiers, each with a corresponding level of required oversight and a set of prescribed mitigation protocols.

Risk Band (0-100)

Required Action/Oversight Level

Low (0–20)

Routine check-ins

Moderate (21–40)

Guided communication

Elevated (41–60)

Scheduled mediation

High (61–80)

Temple oversight

Critical (81–100)

Defer union

7.3.2. Live Scenario Suggestions

The system includes a "Live Scenario Suggestions" engine that uses the Risk Index and its component variables to identify likely sources of conflict and provide actionable mitigation strategies.

• Low Risk (0–20): Suggests preventative rituals like "Praise Redistribution" or a "Gratitude Exchange."

• Moderate Risk (21–40): Recommends structured exercises such as a "Duty Charter Workshop" or a guided dialogue script.

• Elevated Risk (41–60): Prescribes protocols such as a "Jealousy Index reset" or a period of "Mediated silence (48 hours)."

• High Risk (61–80): Requires direct intervention, such as a formal "Temple arbitration session" or an "Emotional containment rite."

• Critical Risk (81–100): Mandates union deferral and the assignment of individual refinement paths.

7.3.3. Forecast Output Structure

The risk engine generates a standardized forecast output to guide council review and action.

• Top Risks: Identifies the two most probable conflict points (e.g., "Jealous Bloom, Duty Imbalance").

• Mitigations: Suggests one immediate and one long-term action (e.g., "Praise redistribution; task charter").

• Watch Window: Defines the period of highest anticipated risk (e.g., "First 90 days").

7.4. Transition

By integrating predictive risk analytics, the AXQ framework provides a comprehensive tool not just for selection, but for the ongoing governance and support of marital unions.

8.0 Architectural Principles & Summary

8.1. Design Philosophy

The core design philosophy of the AXQ Holistic Marriage Index system is built upon a foundation of doctrinal integrity, operational scalability, and the principle of quantifying complex human attributes without sacrificing individual dignity. The architecture is engineered to be transparent, auditable, and actionable, providing a reliable instrument for decisions of profound social and generational importance.

8.2. Guiding Principles

The system is guided by the following key architectural principles:

• Objective, Multi-Factor Evaluation: The system is explicitly designed to avoid single-attribute bias by integrating six distinct, doctrinally-weighted domains, ensuring a holistic and balanced assessment of each candidate.

• Doctrinal & Auditable Governance: All calculations, from the base HMI to the final risk index, are subject to temple-audited rules, non-negotiable gates, and doctrinal caps. This ensures every output remains in strict alignment with core Arreqqana tenets.

• Scalable Architecture: The framework is designed for flexible deployment. It can be utilized by a matchmaker for a single pair via a mobile interface or scaled to a powerful governance tool for managing complex, multi-house alliance optimizations at the regional level.

• Energetic Validation: The system moves beyond purely socio-cultural factors by integrating energetic compatibility metrics. The inclusion of Flame Distance and Thread Compatibility provides a deeper, more holistic assessment of a union's potential for harmony.

• Actionable & Predictive Insight: The design philosophy extends beyond static scoring. By incorporating a predictive risk analytics engine and a library of mitigation strategies, the system provides councils with the foresight needed to proactively support and govern new unions.

8.3. Conclusion

In summary, the AXQ Holistic Marriage Index provides a robust, transparent, and doctrinally-sound framework for navigating the complexities of marital selection and alliance formation, thereby reinforcing the long-term stability and harmony of Arreqqana society.