BeyondCX_Insights/docs/GAP_ANALYSIS.md

GAP ANALYSIS: CXInsights vs BeyondCX Blueprints

Generated: 2026-01-19 Blueprints Analyzed: 4 documents in docs/blueprints/

---

Executive Summary

CXInsights currently implements a subset of the BeyondCX blueprint requirements. The project has strong foundations for RCA (Root Cause Analysis) but is missing several key frameworks defined in the blueprints.

Framework	Coverage	Status
Ventas (Sales Analysis)	~40%	Partial - conversion tracking, some agent failures
Close The Loop (CX)	~30%	Partial - CX drivers only
FCR (First Call Resolution)	~5%	Missing - no FCR detection

---

Blueprint 1: Contexto BeyondCX (General Framework)

What it defines:

• Role: Expert auditor for call analysis (energy sector - Endesa B2C)
• Three strategic frameworks: Ventas, Close the Loop, FCR
• Rules: Evidence-based, no invented info, professional analysis

CXInsights Alignment:

Requirement	CXInsights Status	Notes
Evidence-based analysis	✅ Implemented	evidence_spans[] required for all RCA labels
No invented info	✅ Implemented	LLM must quote transcript
Professional output	✅ Implemented	Structured JSON with traceability
Three frameworks	⚠️ Partial	Only partial coverage of each

---

Blueprint 2: Análisis de Llamadas de Venta (Sales Framework)

What it defines (5 KPIs):

KPI 1: Tasa de Conversión de Venta

Blueprint Requirement	CXInsights Implementation	Gap
Determine Venta/No Venta	✅ CallOutcome.SALE_COMPLETED/SALE_LOST	Covered
Max 5 key factors for success	⚠️ lost_sales_drivers[]	Different structure
Max 5 factors for failure	⚠️ lost_sales_drivers[] with RCALabel	Missing detailed actions
Origin attribution (agent/client/company)	❌ Missing	No origin field
Specific corrective actions	❌ Missing	Only reasoning field

Gap Details:

• CXInsights captures WHAT caused lost sale (driver_code)
• Blueprint requires: WHO is responsible + HOW to fix it + EXAMPLE from call

KPI 2: Efectividad de Campañas

Blueprint Requirement	CXInsights Implementation	Gap
Campaign effectiveness analysis	❌ Not implemented	MAJOR GAP
Product-message fit detection	❌ Not implemented
Customer feedback capture	❌ Not implemented
Segmentation analysis	❌ Not implemented

Gap Details:

• CXInsights has no concept of "campaign"
• No way to track which campaign a call belongs to
• No analysis of product-customer fit

KPI 3: Habilidades del Equipo de Ventas

Blueprint Requirement	CXInsights Implementation	Gap
"Buen Comercial" / "Necesita Mejora" classification	❌ Not implemented	MAJOR GAP
Agent strengths identification	⚠️ Partial via drivers	Implicit only
Agent weaknesses documentation	⚠️ OBJECTION_NOT_HANDLED, POOR_PITCH	Limited
Coaching recommendations	❌ Not implemented

Gap Details:

• No agent skill scoring or classification
• No explicit "good practices to replicate" output
• No coaching action recommendations

KPI 4: Argumentarios y Objeciones

Blueprint Requirement	CXInsights Implementation	Gap
Script quality evaluation	❌ Not implemented	GAP
Objection handling quality	⚠️ OBJECTION_NOT_HANDLED driver	Binary only
Improvement recommendations	❌ Not implemented

Gap Details:

• CXInsights only detects IF objection was handled poorly
• Blueprint requires HOW to improve + specific examples

KPI 5: Ciclo de Venta

Blueprint Requirement	CXInsights Implementation	Gap
Actions that lengthen sales cycle	❌ Not implemented	GAP
Friction points in call	⚠️ Events (HOLD, SILENCE)	Partial
Optimization recommendations	❌ Not implemented

---

Blueprint 3: Close The Loop (CX Framework)

What it defines (5 Pillars):

Pilar 1: Mejorar Experiencia de Cliente (CX)

Blueprint Requirement	CXInsights Implementation	Gap
"Buen CX" / "CX Mejorable" classification	❌ Not implemented	No binary CX outcome
Positive CX factors	❌ Not implemented	Only negative drivers
Friction points	✅ poor_cx_drivers[]	Covered
Customer feedback (explicit/implicit)	❌ Not implemented

Gap Details:

• CXInsights only captures PROBLEMS (poor CX drivers)
• No capture of positive CX factors
• No explicit CX quality rating

Pilar 2: Reducir Fuga de Clientes (Churn)

Blueprint Requirement	CXInsights Implementation	Gap
"Sin riesgo de fuga" / "En riesgo de fuga"	❌ Not implemented	MAJOR GAP
Churn risk factors	❌ Not implemented
Origin attribution (company/agent/client)	❌ Not implemented
Prevention factors	❌ Not implemented

Gap Details:

• CXInsights has no churn risk classification
• CallOutcome.CANCELLATION_* exists but no risk prediction
• No churn drivers taxonomy

Pilar 3: Eficiencia Operativa

Blueprint Requirement	CXInsights Implementation	Gap
Process inefficiencies	⚠️ COMPLEX_PROCESS, SYSTEM_ERROR	Very partial
Agent efficiency analysis	❌ Not implemented
Optimal efficiency factors	❌ Not implemented
Process improvement proposals	❌ Not implemented

Pilar 4: Valor del Cliente (Customer Value)

Blueprint Requirement	CXInsights Implementation	Gap
Explicit customer needs	❌ Not implemented	MAJOR GAP
Latent/implicit needs	❌ Not implemented
Upsell/cross-sell opportunities	❌ Not implemented
Customer value maximization	❌ Not implemented

Pilar 5: Talento Interno

Blueprint Requirement	CXInsights Implementation	Gap
Positive agent behaviors	❌ Not implemented
Agent skills to replicate	❌ Not implemented
Improvement areas	⚠️ Agent-related drivers	Limited
Coaching recommendations	❌ Not implemented

---

Blueprint 4: FCR (First Call Resolution)

What it defines:

Blueprint Requirement	CXInsights Implementation	Gap
First call vs repeat call detection	❌ Not implemented	CRITICAL GAP
Factors causing repeat calls	❌ Not implemented
Churn risk combined with FCR	❌ Not implemented
4 categories: Primera Llamada (sin/con riesgo) + Rellamada (sin/con riesgo)	❌ Not implemented

Gap Details:

• CXInsights has CALLBACK_REQUIRED driver but no FCR detection
• No mechanism to identify if call is first contact or repeat
• No churn-FCR cross-analysis

---

Output Format Comparison

Blueprint Required Output Structure:

Factor Clave 1: [etiqueta breve]
  - Descripción objetiva basada en transcripción
  - Por qué ayuda/impide [objetivo]
  - Qué tiene que hacer el agente para [corregir/replicar]
  - Ejemplo/fragmento de la transcripción

Separados por: "··· "

CXInsights Current Output Structure:

RCALabel(
    driver_code="PRICE_TOO_HIGH",
    confidence=0.85,
    evidence_spans=[
        EvidenceSpan(
            text="Es muy caro para mí",
            start_time=45.2,
            end_time=47.8
        )
    ],
    reasoning="Customer objected to price"
)

Gap:

Blueprint Field	CXInsights Field	Gap
Etiqueta breve	driver_code	✅ Equivalent
Descripción detallada	reasoning	⚠️ Too brief
Acciones correctivas	❌ Missing	GAP
Ejemplo con fragmento	evidence_spans[].text	✅ Covered
Origin (agent/client/company)	❌ Missing	GAP
Max 5 factors	No limit	⚠️ Different

---

Summary: Required Changes

HIGH PRIORITY (Core Functionality Gaps)

1. Add FCR Detection Module

   • Detect first call vs repeat call
   • Track call reason/topic
   • Link to churn risk

2. Add Churn Risk Classification

   • Binary: "Sin riesgo" / "En riesgo de fuga"
   • Churn drivers taxonomy
   • Prevention factors

3. Add Agent Skill Assessment

   • Binary: "Buen Comercial" / "Necesita Mejora"
   • Skill dimensions scoring
   • Coaching recommendations

4. Enhance RCALabel Structure

   class RCALabel:
       driver_code: str
       confidence: float
       evidence_spans: list[EvidenceSpan]
       reasoning: str
       # NEW FIELDS:
       origin: Literal["agent", "customer", "company", "process"]
       corrective_action: str | None  # What to do to fix
       replicable_practice: str | None  # What to replicate
   

MEDIUM PRIORITY (Enhanced Analysis)

5. Add Customer Value Analysis

   • Explicit needs detection
   • Implicit/latent needs
   • Upsell opportunities

6. Add Campaign Tracking

   • Campaign ID field
   • Campaign effectiveness metrics
   • Product-customer fit analysis

7. Add Positive Factors Output

   • Not just problems (drivers) but also successes
   • "Buen CX" factors
   • "Effective sales" factors

LOW PRIORITY (Refinements)

8. Enhance Output Format

   • Limit to max 5 factors per category
   • Add structured corrective actions
   • Match blueprint output structure

9. Add Script Quality Analysis

   • Argumentario quality scoring
   • Objection handling quality
   • Improvement suggestions

---

Taxonomy Extension Required

New Driver Categories Needed:

# CHURN RISK DRIVERS (New)
churn_risk:
  PRICE_DISSATISFACTION:
    description: "Customer unhappy with pricing"
  SERVICE_DISSATISFACTION:
    description: "Customer unhappy with service"
  COMPETITOR_INTEREST:
    description: "Customer considering competitors"
  CONTRACT_ENDING:
    description: "Contract ending soon"
  REPEATED_ISSUES:
    description: "Customer has called multiple times for same issue"

# FCR DRIVERS (New)
fcr_failure:
  INCOMPLETE_RESOLUTION:
    description: "Issue not fully resolved"
  MISSING_INFORMATION:
    description: "Agent didn't provide all needed info"
  PENDING_ACTION:
    description: "Action pending from company side"
  UNCLEAR_NEXT_STEPS:
    description: "Customer unclear on what happens next"

# POSITIVE CX FACTORS (New - inverse of poor_cx)
good_cx:
  QUICK_RESOLUTION:
    description: "Issue resolved quickly"
  EMPATHETIC_SERVICE:
    description: "Agent showed empathy"
  PROACTIVE_HELP:
    description: "Agent anticipated needs"
  CLEAR_COMMUNICATION:
    description: "Agent communicated clearly"

# AGENT SKILLS (New)
agent_skills:
  EFFECTIVE_CLOSING:
    description: "Agent closed sale effectively"
  GOOD_RAPPORT:
    description: "Agent built good rapport"
  OBJECTION_MASTERY:
    description: "Agent handled objections well"
  PRODUCT_KNOWLEDGE:
    description: "Agent demonstrated product knowledge"

---

Recommended Implementation Phases

Phase 1: Core Gaps (Essential)

1. Add churn_risk field to CallAnalysis
2. Add fcr_status field (first_call / repeat_call)
3. Add origin field to RCALabel
4. Add corrective_action field to RCALabel

Phase 2: Enhanced Analysis

5. Add positive factors capture (good_cx, effective_sales)
6. Add agent skill classification
7. Add customer value analysis

Phase 3: Campaign & Optimization

8. Add campaign tracking
9. Add sales cycle analysis
10. Match exact blueprint output format

---

Files Requiring Modification

File	Changes Required
config/rca_taxonomy.yaml	Add churn, FCR, positive factors
src/models/call_analysis.py	Add churn_risk, fcr_status, origin fields
src/inference/prompts.py	Update prompt for new fields
src/inference/analyzer.py	Parse new output structure
src/aggregation/	Aggregate new metrics
src/exports/	Include new fields in exports

---

Última actualización: 2026-01-19