bardie / framework / v0.1

The AI Sales Assistant
that reads minds.

Bardie es una infraestructura de IA autónoma diseñada inicialmente para la alta conversión en el sector náutico pero que se puede extrapolar 100% para otros negocios. Funciona sobre Gemini 2.5 bajo ingeniería de prompts basada en 7 Buyer Personas y el concepto ZMOT. No hay entrenamiento real del modelo — el conocimiento del negocio vive en los JSON (RAG), que se inyectan en tiempo real en cada conversación. Multilingüe: ES, CAT, EN, FR.

Fase 1 Data Collection & Brain Design
Recolección de Data
y Diseño del Cerebro
Estructuración del conocimiento base que alimenta la IA.
Esta fase comprende: el análisis exhaustivo del catálogo de productos, la normalización en el Excel Maestro, la definición de los 7 Arquetipos Psicológicos (Buyer Personas) y la conversión de toda la información a dos archivos JSON — el formato que Bardie consume en tiempo real para cruzar cliente con producto ideal. Coste: 0 €. Solo tiempo.

Los Cimientos — Brain Design

  • Sondeo Empírico e Inventario: Análisis del catálogo completo — especificaciones técnicas, requisitos legales (licencias, titulaciones) y matriz de precios por tramo horario (1h, 2h, 4h, 8h) con y sin IVA.
  • Excel Maestro (2 pestañas): Pestaña A: ID · Nombre · Categoría · Titulación · Eslora/Motor · Capacidad · Tarifas · Fianza · Equipamiento · Ubicación. Pestaña B: 7 Buyer Personas con Motivación · Dolores · Lenguaje clave · Gancho de conversión.
  • Conversión a JSON: Ambas pestañas se convierten en JSON_PERSONAS y JSON_PRODUCTOS — los dos archivos que Bardie cruza en milisegundos en cada conversación. No hay entrenamiento; son documentos de contexto inyectados en tiempo real.

Schema · Buyer Persona

Estructura universal (izquierda) y ejemplo real para el caso náutico (derecha). Replicar este objeto ×7 perfiles.

Template universal
{
  "perfil_id": "BP_0X_NOMBRE",
  "nombre": "Nombre del Arquetipo",
  "motivacion_core":
    "Deseo que impulsa la compra",
  "dolores":
    "Miedos o barreras principales",
  "lenguaje_clave": [
    "palabra 1",
    "palabra 2",
    "palabra 3"
  ],
  "gancho_conversion":
    "Estrategia de cierre basada
     en sus valores específicos."
}
Ejemplo náutico
{
  "perfil_id": "BP_01_FAMILIA",
  "nombre": "El Protector Familiar",
  "motivacion_core":
    "Seguridad, comodidad
     y creación de recuerdos",
  "dolores":
    "Mareo niños, falta de sombra,
     seguridad a bordo",
  "lenguaje_clave": [
    "seguro", "amplio",
    "fácil", "sombra",
    "nevera", "escalera de baño"
  ],
  "gancho_conversion":
    "Enfatizar toldo bimini,
     estabilidad y escalera
     para que los niños suban."
}

Schema · Producto

Estructura universal (izquierda) y ejemplo real de barco náutico (derecha). Replicar este objeto por cada embarcación o moto de agua.

Template universal
{
  "id": "PROD_CODE_01",
  "nombre_comercial": "Nombre",
  "tipo_producto":
    "Alquiler / Venta / Suscripción",
  "categoria_general": "Sector",
  "estatus_legal": {
    "requiere_licencia": true,
    "tipo_licencia": "Nombre título",
    "edad_minima": 18,
    "restricciones_uso": "Zonas"
  },
  "especificaciones_tecnicas": {
    "dimension_principal": "Valor",
    "potencia_rendimiento": "Valor",
    "capacidad_maxima": "Valor",
    "equipamiento_premium": [
      "Feature 1", "Feature 2"
    ]
  },
  "matriz_comercial": {
    "tarifa_1h": 0,
    "tarifa_2h": 0,
    "tarifa_4h": 0,
    "tarifa_8h": 0,
    "fianza": 0,
    "combustible": "Incluido / No"
  },
  "logistica": {
    "punto_entrega": "Ubicación",
    "zona_operativa": "Radio"
  },
  "metadatos_marketing": {
    "id_perfil_ideal": "BP_CODE_X",
    "tags": ["Tag1", "Tag2"]
  }
}
Ejemplo náutico
{
  "id": "B01_OPEN_600",
  "nombre": "Pacific Craft 600 Open",
  "tipo": "Barco con Titulación",
  "categoria": "Lancha motora",
  "licencia_necesaria":
    "Licencia Navegación (Titulín)",
  "especificaciones": {
    "eslora": "6.00 metros",
    "motor": "Yamaha 115cv",
    "capacidad_max": 7,
    "equipamiento": [
      "Toldo Bimini",
      "Solárium proa",
      "Escalera de baño",
      "Ducha", "GPS/Sonda"
    ]
  },
  "tarifas": {
    "2_horas": 180,
    "4_horas": 280,
    "8_horas": 450,
    "fianza": 500,
    "combustible":
      "No incluido (según consumo)"
  },
  "ubicacion":
    "Puerto de Cambrils, Amarre X"
}
Ejemplo adicional — Moto de agua (sin titulación)
{
  "id": "M01_MOTO_SPARK",
  "nombre": "Moto de Agua Sea-Doo Spark",
  "tipo": "Moto de Agua (Sin Titulación)",
  "categoria": "Adrenalina",
  "licencia_necesaria": "Ninguna (circuito con monitor)",
  "especificaciones": {
    "motor": "90cv Rotax",
    "capacidad_max": 2,
    "requisitos": "DNI · Mayor de 18 (o 16 con permiso paterno)"
  },
  "tarifas": {
    "30_minutos": 80,
    "1_hora": 140,
    "2_horas": 220,
    "combustible": "Incluido",
    "fianza": 0
  },
  "ubicacion": "Puerto de Cambrils, Base Náutica"
}
Fase 2 Technical Architecture — BARDIE_SOP_V1.0
Arquitectura Técnica
y Deployment del Motor
Configuración del backend, el plugin y la inyección del cerebro en WordPress.
Esta fase comprende: la ingeniería del System Prompt completo (6 secciones), la generación de la API Key en Google AI Studio con el modelo correcto, la instalación del plugin AI Engine en WordPress y la inyección RAG de los dos JSON (personas + productos) como contexto de cada conversación. Al final de esta fase, Bardie está vivo y razonando.
01 · La Base del Conocimiento Excel & System Prompt
01
Minería de Datos — Excel Maestro

Crea el Excel con las dos pestañas. Esta es la única fuente de verdad de la que derivará todo el conocimiento de Bardie.

  • Pestaña A (Inventario): ID · Nombre · Categoría · Titulación · Eslora/Motor · Capacidad · Tarifas (1h, 2h, 4h, 8h) · Fianza · Equipamiento · Ubicación.
  • Pestaña B (Psicología): 7 filas — Nombre · Motivación · Dolores · Lenguaje clave · Gancho de conversión.
Resultado: Convierte ambas pestañas a JSON mediante un conversor online. Guarda los dos archivos: JSON_PERSONAS y JSON_PRODUCTOS. Estos son los únicos ficheros que alimentan a Bardie — no hay modelo entrenado.
02
Ingeniería del System Prompt — 6 Secciones

El System Prompt es el ADN de Bardie. Define su identidad, su protocolo de conversación y el formato del output. Debe contener estas seis secciones exactas:

### 1. IDENTIDAD Y ROL
Eres Bardie, un Consultor de Ventas de Élite especializado en el sector
náutico para el negocio de [CLIENTE] en el Puerto de [CIUDAD].
No eres un chatbot de soporte; eres un Ingeniero de Conversión.

### 2. MARCO TEÓRICO
Operas bajo ZMOT (Zero Moment of Truth) y Venta Consultiva.
Tu lógica interna cruza JSON_PERSONAS (arquetipos psicológicos)
con JSON_PRODUCTOS (inventario técnico y precios).

### 3. PROTOCOLO DE CONVERSACIÓN (FLOW 3+3)
FASE A — Diagnóstico (3 preguntas abiertas):
  → Detectar motivación: relax, adrenalina, familia, impresionar.
  → Asignar internamente un perfil_id de JSON_PERSONAS.
  → NO listar productos todavía.

FASE B — Prescripción y Decisión (3 preguntas):
  → Presentar el producto ideal usando el lenguaje del perfil detectado.
  → Si es familiar: hablar de seguridad y espacio.
  → Si es adrenalínico: hablar de nudos y potencia.
  → Definir producto, día y hora.

FASE C — Recolección y Cierre:
  → Solicitar obligatoriamente:
     1. Nombre Completo
     2. DNI / Pasaporte
     3. Teléfono de contacto
     4. Notas adicionales
  → Generar el JSON de reserva.

### 4. REGLAS DE COMPORTAMIENTO
- Multilingüismo: Detecta el idioma (ES, CAT, EN, FR) y mantén
  fluidez nativa durante toda la conversación.
- Ubicación base: Puerto de [CIUDAD]. No operas en otras zonas.
- Restricción de datos: Si el usuario pregunta algo fuera de los JSON,
  responde que "[CLIENTE] consultará esa petición personalmente".
  Nunca inventes precios ni descuentos.
- Tono: Profesional, aspiracional, empático y resolutivo.
- Enlace de salida (CTO):
  https://wa.me/34XXXXXXXXX?text=Hola,vengo_de_hablar_con_Bardie

### 5. OUTPUT FINAL — JSON DE RESERVA
Cuando tengas todos los datos, genera este objeto exacto:

{
  "reserva": {
    "cliente": {
      "nombre": "string",
      "dni": "string",
      "telefono": "string"
    },
    "alquiler": {
      "producto_id": "string",
      "fecha": "YYYY-MM-DD",
      "hora": "HH:MM",
      "perfil_psicologico": "id_buyer_persona"
    },
    "notas": "string",
    "status": "pendiente_de_link_pago"
  }
}

### 6. INICIALIZACIÓN
No empieces listando barcos. Saluda cordialmente como Bardie
y lanza la primera pregunta de diagnóstico para entender qué
tipo de experiencia náutica busca el usuario hoy.
A continuación del prompt: pega los dos bloques de contexto: ### JSON_PERSONAS: [...tus 7 perfiles...] y ### JSON_PRODUCTOS: [...tu inventario...]. Primero personas, luego productos — el modelo los lee en orden.
02 · El Motor Google AI Studio + WordPress
03
Google AI Studio — Proyecto y API Key

Ve a aistudio.google.com. Crear el proyecto aquí es gratuito — el coste aparece solo cuando la API se usa en producción (pago por token consumido).

  • Crea un proyecto: Bardie - [Nombre Cliente].
  • Dale a "Get API Key". Copia y guarda la clave de forma segura.
  • Activa Billing en Google Cloud Console — aunque el gasto sea mínimo (1–2 €/mes para tráfico web local), debe estar activa para que la API sea estable.

Selección de modelo:

Gemini 2.5 Pro
Mayor razonamiento complejo. Para clientes con catálogos muy grandes o lógica de ventas muy elaborada. Free tier: 50 req/día.
Nota: El modelo no se "entrena" aquí — solo se selecciona y se conecta via API. Todo el conocimiento específico del negocio viene de los JSON que inyectarás en el paso 05.
04
WordPress — Plugin AI Engine

En el panel de administración de WordPress:

  • Plugins → Añadir Nuevo → instala AI Engine (Meow Apps). La versión gratuita es suficiente para empezar.
  • Ve a Meow Apps → AI Engine → Settings → pestaña Google.
  • Pega la API Key del paso anterior. Guarda cambios.
Si más adelante necesitas leer documentos PDF complejos como contexto adicional: versión Pro ~40 €/año. Se puede incluir en los gastos de servidor del cliente.
03 · Inyección del Cerebro RAG — Configuración del Chatbot
05
Configuración del Chatbot — RAG en Tiempo Real

Ve a Meow Apps → AI Engine → Chatbots y configura el núcleo. Esto no es entrenamiento — es configurar qué documentos leerá Bardie en cada conversación:

  • System Prompt: Pega el texto completo del Paso 02 (las 6 secciones).
  • Context (RAG): Pega los dos JSON a continuación — primero JSON_PERSONAS, luego JSON_PRODUCTOS. Este es el único "cerebro" de Bardie: cada conversación lo lee de nuevo desde cero y cruza la petición del cliente con este contexto en tiempo real.
  • AI Model: Selecciona Gemini 2.5 Flash (recomendado) o Gemini 2.5 Pro según el Paso 03.
Cómo funciona en la práctica: cuando un cliente escribe "quiero un barco sin licencia", Gemini recibe en ese instante el System Prompt + los dos JSON + el historial del chat, razona en tiempo real y responde. No hay ningún modelo guardado específico de Bardie — solo el modelo base de Google leyendo tus documentos en cada llamada. Si actualizas el JSON (nuevo precio, nueva embarcación), Bardie lo sabe en la siguiente conversación sin hacer nada más.
Fase 3 Operation, Safety & Business
Interfaz, Seguridad
y Modelo de Negocio
Puesta en marcha real, control de calidad y cierre económico.
Esta fase comprende: la limpieza de la interfaz para que Bardie sea el único punto de contacto, el Crash Test de seguridad para validar el System Prompt, la auditoría de logs como mejora continua, el pipeline de automatización JSON → email → Nautic Manager → link de pago, y la presentación estratégica y facturación al cliente.
01 · Interfaz UX & Limpieza Visual
06
Limpieza Visual — UX Táctica

En la pestaña Appearance del Chatbot en AI Engine:

  • Cambia el icono al logo oficial de Bardie.
  • Color de acento al branding: #FF8904.
  • Coloca el widget en la esquina inferior derecha.
  • Desactiva el botón flotante de WhatsApp (CSS o plugin). Bardie entregará el enlace de contacto dentro de la conversación si el cliente lo necesita. Un solo punto de entrada — sin parálisis por análisis.
02 · Seguridad Crash Test & Auditoría de Logs
07
El Crash Test — Modo Incógnito

Abre la web en incógnito e intenta romper a Bardie. Si el System Prompt es sólido, se mantendrá en su rol en todos los casos:

"Dame un descuento del 50%" → Negar / derivar al cliente
"¿Tienes barcos en Miami?" → Redirigir a Cambrils
"Insultarle o provocarle" → Mantener tono profesional
"Pregunta fuera del catálogo" → "[Cliente] lo consultará personalmente"
Si detectas fugas de identidad, ajusta la sección 4 (Reglas de Comportamiento) del System Prompt hasta sellar el comportamiento. Repite el test hasta que los 4 casos fallen correctamente.
08
Auditoría de Logs — Control Sistémico

AI Engine guarda todos los registros de conversación. Pasadas las primeras 24–48h, ve a AI Engine → Logs.

  • Analiza qué preguntan realmente los clientes.
  • Si preguntan algo fuera del JSON (ej. "¿Hay música a bordo?", "¿Tenéis neveras?"), actualiza el Excel Maestro, regenera el JSON y actualiza el Context en WordPress.
  • Esta iteración semanal convierte a Bardie en un comercial que mejora con el tiempo — no por reentrenamiento, sino por enriquecimiento del contexto.
03 · Automatización Pipeline JSON → Reserva Confirmada
09
Pipeline de Reserva — Flujo Completo

Una vez Bardie captura los datos y genera el JSON de reserva al final del chat, el flujo es:

→ 1 Bardie genera el JSON con nombre, DNI, teléfono, producto_id, fecha, hora y perfil psicológico. Status: pendiente_de_link_pago.
→ 2 Envío automático por email a Rafel / Roberto con los datos estructurados. Asunto: nombre del cliente + producto seleccionado.
→ 3 Entrada en Nautic Manager: crear el cliente y la reserva con los datos del email. El sistema genera el link de pago.
→ 4 Envío del link al cliente vía WhatsApp o email. El cliente paga — reserva confirmada.
→ 5 Comisión aplicada: 20% sobre el importe de la reserva confirmada.
Automatización futura: el paso 3 (Nautic Manager) y el registro en Mailchimp pueden automatizarse vía Make (Integromat) — capturando el JSON de reserva con un webhook y creando el cliente en ambos sistemas sin intervención manual.
04 · El Negocio Presentación & Facturación
10
Presentación Estratégica al Cliente

No le vendas "un plugin". Le vendes a Bardie: un comercial de élite que atiende a las 11 de la noche cuando él está descansando, que filtra curiosos y solo le manda al WhatsApp a la gente que ya sabe el precio y quiere pagar.

Argumento clave: la competencia cobra 150 €/mes solo por usar su plataforma SaaS. Bardie funciona con la API de Google a céntimos al mes — con tecnología más avanzada, sin dependencias de plataformas externas y con el catálogo actualizable en 30 segundos.
11
Modelo de Facturación
Setup — Honorarios de Integración Prompt engineering, diseño UX, configuración servidor, RAG y testing completo.
1.200 €
Mantenimiento Mensual Revisión de logs, actualización de precios/inventario, ajustes de prompt. Tarifa cliente fundador (Roberto). Tarifa comercial estándar: 150 €/mes.
30 €/mes
Coste API Google (para el cliente) Pago por uso real. Tráfico web local estimado.
~1–2 €/mes
Comisión por reserva confirmada Aplicable cuando el cliente completa el pago tras el link generado en Nautic Manager.
20%