System Design Document: Conflict Simulation Engine

 1.0 Introduction

1.1 Purpose, Scope, and Audience

This document defines the primary technical blueprint for designing and building a sophisticated conflict resolution simulation engine, codenamed "AXQ." The following specifications detail the system's core architecture, data models, logical protocols, and scoring mechanisms.

The Purpose of the AXQ system is to create a dynamic simulation environment for training, counseling, and gamification based on the AXQ marital and sisterhood conflict resolution framework. The engine provides a safe, repeatable space for users to practice and master complex interpersonal dynamics.

The Scope of the system is comprehensive. The engine must model conflict triggers, AI-driven personality archetypes, emotional temperature dynamics, resolution protocols, and quantitative scoring based on performance.

The Target Audience for this document is the development and engineering teams responsible for implementing the system. This document provides the necessary architectural and logical specifications for implementation. The subsequent section provides a high-level overview of the system architecture.

1.2 System Architecture Overview

A clear architectural model is essential for understanding the flow of information and interaction within the simulation. This section provides a high-level, conceptual overview of the simulation engine's core components and their interactions, establishing a foundational understanding for the detailed specifications that follow. The engine operates on the following defined simulation loop:

1. Initialization This step establishes the baseline parameters and context for the ensuing conflict simulation, including the Conflict Type, Wife Archetype(s), and initial Temperature Level.

2. Actor Response Generation The Wife AI Engine generates behavioral and dialogue responses based on the initialized parameters and the internal logic of the assigned personality archetype.

3. User/System Intervention The Husband actor selects a Stabilization Protocol (a "Route") from a predefined set of actions to de-escalate or resolve the conflict.

4. Outcome Processing The engine processes the interaction, generating branching outcomes based on the protocol chosen by the Husband and the reaction patterns of the Wife AI personality.

5. Scoring & State Update The Harmony Index and other relevant metrics are calculated and updated to provide direct feedback, and the system state is adjusted for the next interaction or the conclusion of the simulation.

The following sections will deconstruct each component of this architecture in granular detail, starting with the fundamental models and entities that define the simulation's universe.

2.0 Core System Models & Entities

2.1 Conflict Archetypes

The strategic foundation of all simulations is the set of conflict archetypes. These 12 categories define the contextual basis for every interaction within the engine, acting as the primary triggers that initiate a simulation scenario.

Archetype Name	Description
Soft Hurt	emotional misunderstanding
Hard Hurt	words spoken in sharp tone
Duty Imbalance	chore/role conflict
Rotation Anxiety	intimacy fairness concerns
Dominance Clash	leadership or tone
Jealous Bloom	affection imbalance
Mind–Mouth Split	miscommunication
Silent Flood	prolonged quiet resentment
Expectation Warp	mismatched values
Public Shame Risk	impropriety in front of others
Spiritual Misalignment	ritual or belief tension
Household Territoriality	feeling “displaced” by others

These archetypes are the primary input used to configure the behavior of the system's AI actor profiles during scenario initialization.

2.2 Actor Profiles (AI Personas)

The simulation's realism and effectiveness depend on well-defined actor profiles. The system's core design philosophy is based on the interplay between a dynamically disruptive force (the Wife AI personas) and a procedurally stabilizing agent (the Husband actor). The interaction between these two primary actor types forms the central engine of the simulation.

2.2.1 Wife AI Archetypes (The Five Flames)

The Wife AI is not a monolithic entity but is composed of five distinct personality archetypes, known as "Flame Types." Each Flame Type possesses a unique set of behavioral triggers, communication patterns, and emotional responses, ensuring a wide variety of simulation experiences.

Crown Wife AI Profile

• Baseline: structured, confident, firm

• Jealousy Response: irritation → control

• Tone: authoritative, steady

• Conflict Entry Pattern: sets boundaries immediately

• Conflict Exit Pattern: gives orders to restore order

• Preferred Resolution Route: Primarily Boundary Route, receptive to Logic Route

• Weakness Flag: Over-dominance

• Hidden Bonus Trait: +3 to group stabilization events

River Wife AI Profile

• Baseline: emotional, nurturing

• Jealousy Response: sadness → withdrawal

• Tone: soft, wavering

• Conflict Entry Pattern: expresses hurt

• Conflict Exit Pattern: melts once affirmed

• Preferred Resolution Route: Soft Talk Route

• Weakness Flag: easily triggered

• Hidden Bonus Trait: +4 to jealousy reduction events

Growth Wife AI Profile

• Baseline: enthusiastic, creative

• Jealousy Response: impulsive reactions

• Tone: lively, abrupt

• Conflict Entry Pattern: acts before thinking

• Conflict Exit Pattern: apologizes quickly

• Preferred Resolution Route: Primarily Service/Gesture Route

• Weakness Flag: poor impulse control

• Hidden Bonus Trait: +2 to practical solutions

Star Wife AI Profile

• Baseline: calm, rational, detached

• Jealousy Response: internalized, quiet coldness

• Tone: analytical

• Conflict Entry Pattern: asks clarifying questions

• Conflict Exit Pattern: logic-based resolution

• Preferred Resolution Route: Primarily Logic Route, receptive to Ritual Route

• Weakness Flag: seems uncaring

• Hidden Bonus Trait: +4 to truth-revealing events

Alliance Wife AI Profile

• Baseline: foreign, observant, diplomatic

• Jealousy Response: insecurity → overcompensation

• Tone: polite, neutral

• Conflict Entry Pattern: attempts mediation

• Conflict Exit Pattern: yields for peace

• Preferred Resolution Route: Diplomatic Route

• Weakness Flag: identity insecurity

• Hidden Bonus Trait: +3 to multi-wife harmony actions

The following table, the Wife Reaction Engine, maps the specific reaction of each archetype to the 12 conflict types and serves as a direct input for the simulation logic.

Conflict Type	Crown Wife	River Wife	Growth Wife	Star Wife	Alliance Wife
Soft Hurt	Corrects tone	Cries softly	Gets defensive	Asks questions	Tries to mediate
Hard Hurt	Pushes control	Retreats inward	Argues impulsively	Goes silent	Over-explains
Duty Imbalance	Reassigns duties	Feels unappreciated	Tries to overhelp	Creates system	Asks for fairness
Rotation Anxiety	States facts	Asks “Do you still love me?”	Gets jealous	Calculates time	Over-accommodates
Dominance Clash	Stands her ground	Melts into tears	Escalates	Goes cold	Yields
Jealous Bloom	Asserts territory	Breaks emotionally	Impulsive action	Observes quietly	Insecurity spike
Mind–Mouth Split	Clarifies sharply	Misunderstands tone	Speaks too quickly	Analyzes	Apologizes unnecessarily
Silent Flood	Calls out silence	Silently spirals	Distracts herself	Waits	Checks on others
Expectation Warp	Rationalizes	Feels betrayed	Panics	Reconstructs	Negotiates
Public Shame Risk	Protects image	Becomes anxious	Feels humiliated	Notices details	Overcompensates
Spiritual Misalignment	Defends doctrine	Fears losing harmony	Rebels	Questions logic	Adapts
Territoriality	Enforces boundaries	Feels displaced	Acts out	Withdraws	Reassures others

2.2.2 Husband Stabilizer Profile

The Husband's role is not that of a passive observer but is the central stabilizing agent in the simulation. This actor's state and available actions are governed by a specific set of variables that influence their effectiveness in resolving conflicts.

Husband Actor Variables

• Tone Mastery: The ability to control vocal tone to influence emotional outcomes.

• Emotional Perception: The capacity to correctly interpret the emotional state of the wives.

• Bias Risk: The potential to show unintentional favoritism.

• Fairness Score: A metric tracking equitable treatment and resource distribution.

• Patience Meter: A resource that depletes during prolonged or intense conflicts.

• Leadership Authority: The recognized level of influence within the household structure.

• Spiritual Alignment: The degree of adherence to shared ritual and belief systems.

Husband Actor Actions

• recalibrate rotation: Adjust intimacy or attention schedules to ensure fairness.

• enforce boundaries: Clearly state and uphold household rules and protocols.

• perform Harmony Reset Gesture: A specific ritual action to de-escalate a boiling conflict; for example, offering water after a moment of structured silence.

• soothe emotional wife: Provide comfort and reassurance to a distressed actor.

• call for Crown Wife authority: Defer to the Crown Wife's leadership in specific situations.

• signal priestess for intervention: Escalate an unresolvable conflict to a higher authority.

• give equalized praise: Distribute compliments and validation evenly to prevent jealousy.

• perform “The Seven Soft Words”: A scripted verbal protocol for de-escalating emotional distress through patterned, reassuring language.

3.0 Simulation Engine Logic & Protocols

3.1 Husband Stabilization Protocols (The Seven Routes)

The Husband actor's primary mechanism for interaction is a set of seven defined stabilization protocols. These "Routes" represent the core set of solutions available to resolve conflicts within the simulation. Each Route is designed to be effective against specific conflict archetypes and emotional states.

1. Boundary Route This protocol uses firm but gentle statements to establish or reinforce rules and expectations.

• Conflict Types: Duty Imbalance, Dominance Clash, Territoriality

"Beloved, here is the boundary. It protects you, not restrains you."

2. Soft-Tone Route This protocol focuses on lowering the emotional temperature through a slow, warm, and steady vocal tone.

• Conflict Types: Soft Hurt, Jealous Bloom

"I hear you. Come closer, let us breathe."

3. Ritual Route This protocol involves the use of symbolic AXQ actions to create connection and de-escalate tension.

• Conflict Types: Silent Flood, Spiritual Misalignment

He offers hands, forehead touch, light circle.

4. Logic Route This protocol applies clarity and facts to resolve misunderstandings or reduce anxiety.

• Conflict Types: Expectation Warp, Public Shame Risk

"Here are the events, step by step. Nothing was against you."

5. Praise-Redistribution Route This protocol is used to reaffirm the value and uniqueness of each wife, particularly in response to fairness concerns.

• Conflict Types: Rotation Anxiety

"Your flame is unique. I see you, and I honor you."

6. Alliance Route This protocol aims to unite the husband and wives, bringing multiple parties into a state of shared warmth and understanding.

• Conflict Types: Territorial conflicts, scenarios requiring group cohesion

He brings both parties into shared warmth.

7. Reset Route This is an emergency protocol for de-escalating boiling conflicts through a moment of structured silence and a simple gesture.

• Conflict Types: Boiling Conflicts

"Let us start again, without fire on the tongue."

These protocols are the primary inputs selected by the user, which in turn drive the simulation's branching narrative structure.

3.2 Dialogue and Outcome Branching

The simulation does not follow a linear path. It utilizes dialogue trees and branching outcomes to create a responsive and realistic experience where user choices have a direct and measurable impact. The path taken depends on the chosen protocol, the Wife AI's personality, and the current emotional temperature.

Example 1: Soft Hurt Dialogue Tree

• Wife (hurt): "Why did you speak like that? It felt sharp."

• Husband (Soft-Tone Route): "I am here. My voice is calm for you. Tell me what you felt."

    ◦ Path A: She explains → +20 Harmony

    ◦ Path B: She retreats → Husband switches to Ritual Route → +10 Harmony

    ◦ Path C: She escalates → Reset Route → Neutral Outcome

Example 2: Dominance Clash Dialogue Tree

• Wife (Crown): "That tone will not stand in this house."

• Husband: "I respect your flame. The boundary stands for us both."

    ◦ Path A: She calms → +15 Harmony

    ◦ Path B: She asserts more → Husband clarifies facts → +10 Harmony

    ◦ Path C: She challenges → Ritual reset → –5 Harmony

Example 3: Jealousy Tree (River Wife)

• Wife: "Do you admire her more than me?"

• Husband: "Your flame is singular. Come, sit with me."

    ◦ Path A: She melts → +25 Harmony

    ◦ Path B: She cries → +20 Harmony

    ◦ Path C: She accuses → Reset Route → –5 Harmony

The quantitative impact of these outcomes is governed by the scoring models detailed in the next section.

4.0 Data Models and Scoring Logic

4.1 Wife AI Data Structure

A standardized data model is critical for the programmatic implementation of AI actors. The following data structure for the Wife AI defines the parameters that will be used to instantiate and manage each AI persona within the simulation environment.

• wife_ai

    ◦ archetype: "Crown | River | Growth | Star | Alliance"

    ◦ emotional_baseline: 0-100

    ◦ jealousy_threshold: 0-100

    ◦ tone_profile: "soft | sharp | neutral | logical | warm"

    ◦ conflict_entry_type: "assert | withdraw | mediate | accuse | solve"

    ◦ conflict_exit_type: "apologize | explain | surrender | justify | reset"

    ◦ preferred_resolution: "talk | boundary | gesture | ritual | diplomacy"

    ◦ bonus_trait: {type, magnitude}

    ◦ cooldown_time: 0-100

Within this structure, key parameters govern AI behavior. The emotional_baseline determines the starting emotional state, while the jealousy_threshold dictates the trigger point at which a jealousy reaction is initiated. This standardized data model ensures that all AI personas are interoperable with the scoring and logic engines, allowing for predictable behavior and modular extension.

4.2 Primary Scoring: The Harmony Index

The Harmony Index is the principal metric for evaluating relationship health and simulation success. This score provides direct, quantitative feedback on the outcome of a conflict resolution attempt, with scores ranging from 0–100.

The Harmony Index Formula is calculated as follows:

Harmony Change = (Resolution Quality × Tone Match × Wife Variant Modifier) – (Conflict Severity × Jealousy Spike)

The variables in this formula are defined as:

• Resolution Quality: A score from 1 to 5 indicating the effectiveness of the chosen protocol.

• Tone Match: A multiplier ranging from 0.5x to 1.5x, reflecting how well the Husband's tone matched the needs of the situation.

• Wife Variant Modifier: A bonus applied when the resolution aligns with an AI archetype's preferred style:

    ◦ Crown: +2 if clarity-based

    ◦ River: +3 if warm-based

    ◦ Growth: +2 if action-based

    ◦ Star: +3 if logic-based

    ◦ Alliance: +3 if diplomacy-based

• Conflict Severity: A base penalty tied to the conflict archetype. The specific values are defined in the engine's configuration data and are outside the scope of this top-level formula definition.

• Jealousy Spike: A penalty multiplier triggered by specific in-simulation events. The specific values are defined in the engine's configuration data and are outside the scope of this top-level formula definition.

4.3 Secondary Scoring: Sisterhood Metrics

In addition to the primary Harmony Index, the system employs secondary metrics to track overall household stability and the performance of individual wives, which is particularly crucial in multi-wife scenarios.

4.3.1 Sisterhood Discipline Score (Saji-Rru Index)

The Saji-Rru Index is a metric for evaluating a wife's emotional mastery, cooperation, and positive contribution to household harmony. The total score ranges from 0 to 500, aggregated from five categories.

Scoring Category	Point Value
Emotional Containment	0–100
Cooperation Index	0–100
Ritual Reliability	0–100
Tone Discipline	0–100
Conflict Handling	0–100

Behavioral Point Modifiers (Examples)

Triggering Behavior	Points
No outbursts in a week	+15
Calmly communicating issues	+10
Jealousy turned into gratitude	+20
Emotional spike	–10
Flameburst moment	–20

Triggering Behavior	Points
Helping another wife without being asked	+10
Praise given to another wife	+5
Refusing cooperation	–10
Passive-aggressive actions	–15

Wife Discipline Tiers

• 450–500: Golden Sister (Highest refinement, model wife)

• 380–449: Silver Sister (Highly reliable, minimal conflict)

• 310–379: Bronze Sister (Stable but needs occasional discipline)

• 200–309: Fragile Sister (Produces or attracts conflict)

• <200: Flameburst Sister (Requires urgent temple intervention)

4.3.2 Sisterhood Emotional Temperature

The Emotional Temperature Dashboard is a real-time tool for measuring overall household stability. It provides an aggregate score indicating the current level of harmony or tension among all members.

The Temperature Formula aggregates several key metrics: Emotional Temperature = (0.35 × JealousyPressure) + (0.20 × TerritoryStress) + (0.25 × ToneDisruptions) + (0.10 × RitualMisalignment) + (0.10 × (100 - SisterhoodTrust))

Temperature Levels

Score	Label	Meaning
0–20	Cold Peace	Detached but calm
21–40	Warm Sisterhood	Cooperative & stable
41–60	Hot Zone	Tension rising—monitor
61–80	Boiling	Jealousy & rivalry forming
81–100	Flameburst	Immediate ritual intervention needed

5.0 Simulation Scenarios & Use Cases

This final section presents validation scenarios and integration test cases designed to verify that the engine's components synthesize correctly to model canonical lore outcomes.

5.1 Husband-Wife Scenario (Example: Jarru × Saara)

This scenario demonstrates a typical one-on-one conflict resolution simulation between the Husband (Jarru) and a single Wife AI (Saara).

• Conflict Type: Territoriality

• Actors: Jarru (Husband), Saara (Wife, Crown Archetype)

• Trigger: At a noble event, another girl greets Jarru too warmly.

• Wife Reaction (Programmatic): Boundary-oriented, immediate, and protective, consistent with the Crown archetype's response to territorial threats.

• Husband Action (Selected Protocol): The user selects the Alliance Route + Public Reassurance Gesture to simultaneously reinforce the spousal bond and manage public perception.

• Outcome: The conflict is resolved successfully. Saara's protective instincts are validated and soothed.

• Harmony Index Change: +30 (excellent), reflecting a highly effective resolution that aligned with the AI's personality needs.

5.2 Sisterhood Scenario (Example: The Festival Clothing Clash)

This scenario models a more complex multi-actor conflict involving two or more Wife AIs, requiring a different strategic approach from the Husband or other AI actors.

• Scenario: The Festival Clothing Clash

• Difficulty: 4 Flames (out of 5, indicating high complexity and emotional volatility)

• Initial Temperature: Hot Zone

• Trigger: Two wives choose the same festival outfit color, creating a direct rivalry and potential for public shame.

• Potential Outcome Path (Best): An Alliance Wife AI acts on her core programming and successfully mediates the dispute, finding a diplomatic solution that allows both parties to feel honored.

• Resolution: The conflict is resolved peacefully before escalating.

• Harmony Index Change: +20

• Potential Outcome Path (Worst): Both wives refuse to yield, escalating their positions. The conflict temperature rises to Boiling.

• Resolution: The conflict escalates, requiring direct intervention from the Husband or a higher authority (e.g., Crown Wife).

• Harmony Index Change: –20

These specifications provide a complete blueprint for the development of the AXQ Conflict Simulation Engine.