RelationshipScan

Methodology

How RelationshipScan reads a chat.

Every report is produced by five AI agents running in parallel, each grounded in a named clinical framework. An aggregator combines their readings into one structured report with a Communication Health Index, named patterns, and direct quotes from the conversation.

Gottman Method

Warning signs and repair

Detects the Four Horsemen (criticism, contempt, defensiveness, stonewalling), flooding, harsh start-ups, and repair attempts. Used by clinicians to predict relationship outcomes with reported accuracy of ~90% in research populations.

Source: Gottman Institute (John & Julie Gottman, 1980–present)

Attachment Theory

How you move under stress

Maps each side's responses under threat: avoidant withdrawal, anxious pursuit, secure base behavior, or disorganized mix. Reads pursuit-withdraw cycles in the chat.

Source: John Bowlby (1969), Mary Ainsworth (1978), Sue Johnson contemporary work

Nonviolent Communication

Hidden needs

Surfaces the unmet need underneath an accusation. Translates jackal language ('you always shut me out') into the underlying request ('I need to feel reached for').

Source: Marshall Rosenberg, Nonviolent Communication (1999)

Schema Therapy

Recurring scripts

Identifies maladaptive schemas activated in the conflict — abandonment, defectiveness, emotional deprivation, mistrust — and names the loop you keep getting stuck inside.

Source: Jeffrey Young, Schema Therapy: A Practitioner's Guide (2003)

Emotion Focused Therapy

Bids and missed bids

Identifies bids for connection and missed responses. The small moments that could have changed the conversation.

Source: Sue Johnson, Hold Me Tight (2008); Greenberg & Johnson, EFT (1988)

The workflow

  1. You upload a chat (.txt or WhatsApp export) or paste a conversation.
  2. The chat is sent over an encrypted connection to our backend on Railway and stored temporarily on Firebase Storage.
  3. Five agents (one per framework) read the chat in parallel via Gemini 2.5 Pro at temperature 0.1 — the same input, five clinical lenses, no opinion drift.
  4. An aggregator agent reconciles the five readings into a single structured report.
  5. The uploaded chat is deleted from storage. Only the structured report is retained, in Firestore, accessible only to you.

What the report is not

The report is a reflection tool, not therapy. It is not a verdict on the relationship and not a crisis intervention service. If you are in crisis, please contact local emergency services or a licensed mental health professional. The frameworks above are clinical tools used by therapists; running a chat through them yields information, not advice.

Last reviewed: 2026-05-23. See pricing.