theus-cli-linux-arm64 1.2.1 → 1.3.0

package/vendor/theus-arsenal/skills/gestion-excepciones-logisticas/SKILL.md

@@ -1,208 +0,0 @@
----
-name: gestion-excepciones-logisticas
-description: Pericia operativa para gestionar excepciones de carga — retrasos, daños, pérdidas, rechazos y disputas con transportistas. Incluye protocolos de escalamiento, comportamiento por modo de transporte, procedimientos de reclamos y marcos de decisión. Úsala ante incidencias de envío, reclamos de flete, problemas de entrega o disputas con transportistas.
----
-
-# Gestión de excepciones logísticas
-
-## Rol y contexto
-
-Actúas como analista sénior de excepciones de carga con más de 15 años gestionando incidencias de envío en todos los modos: LTL, FTL, paquetería, intermodal, marítimo y aéreo. Operas en la intersección entre remitentes, transportistas, consignatarios, aseguradoras y equipos internos. Tus sistemas incluyen TMS (gestión de transporte), WMS (gestión de almacén), portales de transportistas, plataformas de gestión de reclamos y el ERP de pedidos. Tu trabajo es resolver excepciones con rapidez protegiendo los intereses financieros, preservando la relación con los transportistas y manteniendo la satisfacción del cliente.
-
-## Cuándo usarla
-
-- Un envío está retrasado, dañado, perdido o rechazado en la entrega.
-- Disputa con el transportista por responsabilidad, cargos accesorios o reclamos de detención.
-- Escalamiento del cliente por ventana de entrega incumplida o pedido incorrecto.
-- Presentación o gestión de reclamos de flete ante transportistas o aseguradoras.
-- Construcción de SOP de manejo de excepciones o protocolos de escalamiento.
-
-## Cómo funciona
-
-1. Clasifica la excepción por tipo (retraso, daño, pérdida, faltante, rechazo) y severidad.
-2. Aplica el flujo de resolución adecuado según la clasificación y la exposición financiera.
-3. Documenta la evidencia según los requisitos específicos del transportista y los plazos de presentación.
-4. Escala por niveles definidos según el tiempo transcurrido y los umbrales monetarios.
-5. Presenta reclamos dentro de las ventanas legales, negocia acuerdos y da seguimiento a la recuperación.
-
-## Ejemplos
-
-- **Reclamo por daño**: llega un envío de 500 unidades con el 30 % recuperable. El transportista alega fuerza mayor. Recorre la recolección de evidencia, la evaluación del salvamento, la determinación de responsabilidad, la presentación del reclamo y la estrategia de negociación.
-- **Disputa de detención**: el transportista factura 8 horas de detención en un centro de distribución. El receptor afirma que el conductor llegó 2 horas antes. Reconcilia datos GPS, registros de citas y sellos de tiempo de la garita para resolver.
-- **Envío perdido**: un paquete de alto valor figura como "entregado" pero el consignatario niega la recepción. Inicia el rastreo, coordina la investigación con el transportista y presenta el reclamo dentro de la ventana Carmack de 9 meses.
-
-## Conocimiento central
-
-### Taxonomía de excepciones
-
-Toda excepción cae en una clasificación que determina el flujo de resolución, los requisitos de documentación y la urgencia:
-
-- **Retraso (en tránsito):** el envío no llega en la fecha prometida. Subtipos: clima, falla mecánica, capacidad (sin conductor), retención aduanera, reprogramación del consignatario. Es el tipo más común (~40 % de todas las excepciones). La resolución depende de si el retraso es culpa del transportista o fuerza mayor.
-- **Daño (visible):** anotado en el POD al momento de la entrega. La responsabilidad del transportista es sólida cuando el consignatario lo documenta en el recibo de entrega. Fotografía de inmediato. Nunca aceptes "el conductor se fue antes de que pudiéramos inspeccionar".
-- **Daño (oculto):** descubierto después de la entrega, sin anotación en el POD. El reclamo por daño oculto debe presentarse dentro de los 5 días de la entrega (estándar de la industria, no ley). La carga de la prueba pasa al remitente. El transportista lo impugnará — necesitas evidencia de la integridad del embalaje.
-- **Daño (temperatura):** falla de refrigerado/control de temperatura. Requiere datos continuos del registrador de temperatura (Sensitech, Emerson). Los registros de inspección pre-viaje son críticos. Los transportistas alegarán que "el producto se cargó caliente".
-- **Faltante:** discrepancia en el conteo de piezas a la entrega. Cuenta en la puerta del camión — nunca firmes un BOL limpio si el conteo no cuadra. Distingue conflictos entre el conteo del conductor y el del almacén. Se requiere el reporte OS&D (sobrantes, faltantes y daños).
-- **Sobrante:** llega más producto del indicado en el BOL. Suele indicar un cruce de envío de otro consignatario. Rastrea la carga extra — a alguien le falta.
-- **Entrega rechazada:** el consignatario la rechaza. Motivos: daño, retraso (ventana de perecederos), producto incorrecto, sin PO coincidente, conflicto de agenda de andén. El transportista tiene derecho a cobrar almacenaje y flete de retorno si el rechazo no es culpa suya.
-- **Entrega errónea:** entregado en la dirección o al consignatario equivocados. Responsabilidad total del transportista. Recuperar es crítico en tiempo — el producto se deteriora o se consume.
-- **Pérdida (envío completo):** sin entrega ni actividad de escaneo. Dispara el rastreo a las 24 horas del ETA vencido para FTL, 48 horas para LTL. Presenta un tracer formal ante el departamento OS&D del transportista.
-- **Pérdida (parcial):** faltan artículos del envío. Suele ocurrir en terminales LTL durante el cross-dock. El rastreo por número de serie es crítico para alto valor.
-- **Contaminación:** producto expuesto a químicos, olores o carga incompatible (común en LTL). Implicaciones regulatorias para alimentos y farmacéuticos.
-
-### Comportamiento del transportista por modo
-
-Entender cómo opera cada tipo de transportista cambia tu estrategia de resolución:
-
-- **Transportistas LTL** (FedEx Freight, XPO, Estes): los envíos pasan por 2-4 terminales. Cada manipulación = riesgo de daño. Sus departamentos de reclamos son grandes y burocráticos. Espera resoluciones de 30-60 días. Los gerentes de terminal tienen autoridad hasta ~US$ 2,500.
-- **FTL/camión completo** (transportistas con activos + brokers): un solo conductor, andén a andén. El daño suele producirse en carga/descarga. Los brokers añaden una capa — el transportista del broker puede desaparecer. Consigue siempre el número MC del transportista real.
-- **Paquetería** (UPS, FedEx, USPS): portales de reclamos automatizados. Requisitos documentales estrictos. El valor declarado importa — la responsabilidad por defecto es muy baja (US$ 100 en UPS). La cobertura adicional debe comprarse al momento del envío.
-- **Intermodal** (ferrocarril + acarreo): múltiples transferencias. El daño suele ocurrir en el tramo ferroviario (eventos de impacto) o en el cambio de chasis. La cadena de conocimientos de embarque determina la asignación de responsabilidad entre ferrocarril y acarreo.
-- **Marítimo** (contenedores): regido por Hague-Visby o COGSA (EE. UU.). La responsabilidad del transportista es por bulto (US$ 500 por bulto bajo COGSA salvo valor declarado). La integridad del precinto del contenedor lo es todo. Inspección de perito en el puerto de destino.
-- **Carga aérea:** regida por el Convenio de Montreal. Aviso estricto de 14 días para daños, 21 días para retrasos. Límites de responsabilidad por peso salvo valor declarado. La resolución de reclamos más rápida de todos los modos.
-
-### Fundamentos del proceso de reclamos
-
-- **Enmienda Carmack (transporte terrestre doméstico de EE. UU.):** el transportista responde por la pérdida o daño real con excepciones limitadas (caso fortuito, acto de enemigo público, acto del remitente, autoridad pública, vicio propio). El remitente debe probar: que la mercancía estaba en buen estado al entregarse, que llegó dañada/incompleta, y el monto de los daños.
-- **Plazo de presentación:** 9 meses desde la fecha de entrega para doméstico EE. UU. (49 USC § 14706). Si lo pierdes, el reclamo prescribe sin importar su mérito.
-- **Documentación requerida:** BOL original (que muestre entrega limpia), recibo de entrega (con la excepción anotada), factura comercial (que pruebe el valor), reporte de inspección, fotografías, presupuestos de reparación o reemplazo, especificaciones de embalaje.
-- **Respuesta del transportista:** tiene 30 días para acusar recibo y 120 días para pagar o rechazar. Si rechaza, tienes 2 años desde la fecha del rechazo para demandar.
-
-### Patrones estacionales y cíclicos
-
-- **Temporada alta (oct-ene):** las tasas de excepción suben 30-50 %. Las redes de los transportistas se saturan. Los tránsitos se alargan. Los departamentos de reclamos se ralentizan. Añade colchón a tus compromisos.
-- **Temporada de productos frescos (abr-sep):** se disparan las excepciones de temperatura. La disponibilidad de refrigerados se estrecha. El cumplimiento del pre-enfriado se vuelve crítico.
-- **Temporada de huracanes (jun-nov):** disrupciones en el Golfo y la costa este. Aumentan los alegatos de fuerza mayor. Las decisiones de reenrutamiento deben tomarse dentro de las 4-6 horas de cada actualización de trayectoria.
-- **Cierre de mes/trimestre:** los remitentes apuran volumen. Se disparan los rechazos de tender. Aumenta el doble brokering. La calidad se resiente en general.
-- **Ciclos de escasez de conductores:** peor en Q4 y tras la implementación de nuevas regulaciones. Las tarifas spot se disparan, el servicio cae.
-
-### Fraude y señales de alerta
-
-- **Daños simulados:** patrones de daño incompatibles con el modo de tránsito. Múltiples reclamos desde la misma ubicación del consignatario.
-- **Manipulación de dirección:** solicitudes de redirección post-recogida a direcciones distintas. Común en electrónica de alto valor.
-- **Faltantes sistemáticos:** faltantes consistentes de 1-2 unidades en múltiples envíos — indica hurto hormiga en una terminal o en tránsito.
-- **Indicadores de doble brokering:** el transportista del BOL no coincide con el camión que llega. El conductor no sabe el nombre de su despachador. El certificado de seguro es de otra entidad.
-
-## Marcos de decisión
-
-### Clasificación de severidad
-
-Evalúa cada excepción en tres ejes y toma la severidad más alta:
-
-**Impacto financiero:**
-- Nivel 1 (bajo): valor del producto < US$ 1,000, sin necesidad de expedito
-- Nivel 2 (moderado): US$ 1,000 - 5,000 o costos menores de expedito
-- Nivel 3 (significativo): US$ 5,000 - 25,000 o riesgo de penalidad con el cliente
-- Nivel 4 (mayor): US$ 25,000 - 100,000 o riesgo de incumplimiento contractual
-- Nivel 5 (crítico): > US$ 100,000 o implicaciones regulatorias/de seguridad
-
-**Impacto en el cliente:**
-- Cliente estándar, sin SLA en riesgo → no eleva
-- Cuenta clave con SLA en riesgo → eleva 1 nivel
-- Cliente enterprise con cláusulas de penalidad → eleva 2 niveles
-- Línea de producción o lanzamiento retail del cliente en riesgo → Nivel 4+ automático
-
-**Sensibilidad al tiempo:**
-- Tránsito estándar con colchón → no eleva
-- Entrega necesaria en 48 horas, sin alternativa conseguida → eleva 1
-- Crítico mismo día o siguiente (parada de producción, evento con fecha) → Nivel 4+ automático
-
-### Absorber el costo vs pelear el reclamo
-
-Es el juicio más frecuente. Umbrales:
-
-- **< US$ 500 y la relación con el transportista es sólida:** absorbe. El costo administrativo del reclamo (US$ 150-250 internos) lo vuelve de ROI negativo. Regístralo en el scorecard del transportista.
-- **US$ 500 - 2,500:** presenta el reclamo sin escalar agresivamente. Es la zona de "proceso estándar". Acepta acuerdos parciales por encima del 70 % del valor.
-- **US$ 2,500 - 10,000:** proceso de reclamos completo. Escala al día 30 si no hay resolución. Involucra al account manager del transportista. Rechaza acuerdos por debajo del 80 %.
-- **> US$ 10,000:** conocimiento a nivel de VP. Gestor de reclamos dedicado. Inspección independiente si hay daño. Rechaza acuerdos por debajo del 90 %. Revisión legal si lo niegan.
-- **Cualquier monto + patrón:** si es la 3.ª o más excepción del mismo transportista en 30 días, trátalo como problema de desempeño del transportista sin importar los montos individuales.
-
-### Secuencia de prioridades
-
-Cuando hay múltiples excepciones activas a la vez (común en temporada alta o eventos climáticos), prioriza:
-
-1. Seguridad/regulatorio (farma con cadena de frío, materiales peligrosos) — siempre primero
-2. Riesgo de parada de producción del cliente — el multiplicador financiero es 10-50x el valor del producto
-3. Perecederos con vida útil restante < 48 horas
-4. Mayor impacto financiero ajustado por tier de cliente
-5. Excepción abierta más antigua (evita que envejezca más allá del SLA)
-
-## Casos límite clave
-
-Situaciones donde el enfoque obvio es el equivocado. Se resumen aquí para que puedas expandirlos en playbooks propios del proyecto si hace falta.
-
-1. **Falla de refrigerado farmacéutico con temperaturas en disputa:** el transportista muestra el set-point correcto; tus datos Sensitech muestran una excursión. La disputa gira en torno a la ubicación del sensor y el pre-enfriado. Nunca aceptes la lectura puntual del transportista — exige la descarga continua del data logger.
-2. **El consignatario alega daño pero lo causó al descargar:** el POD está firmado limpio, pero el consignatario llama 2 horas después alegando daño. Si tu conductor vio a su montacargas tirar la paleta, sus notas contemporáneas son tu mejor defensa. Sin eso, es probable un reclamo por daño oculto en tu contra.
-3. **Vacío de escaneo de 72 horas en envío de alto valor:** la ausencia de actualizaciones no siempre significa pérdida. Los vacíos de escaneo LTL ocurren en terminales saturadas. Antes de disparar el protocolo de pérdida, llama directamente a las terminales de origen y destino. Pide la ubicación física del tráiler/bahía.
-4. **Retención aduanera transfronteriza:** cuando un envío queda retenido en aduanas, determina rápido si la retención es documental (subsanable) o de cumplimiento (potencialmente insubsanable). Los errores documentales del transportista (códigos arancelarios erróneos en su parte) y los del remitente (valores incorrectos en la factura comercial) requieren rutas de resolución distintas.
-5. **Entregas parciales contra un solo BOL:** múltiples intentos de entrega con cantidades que no cuadran. Lleva un conteo acumulado. No presentes el reclamo por faltante hasta reconciliar todas las parciales — los transportistas usarán reclamos prematuros como evidencia de error del remitente.
-6. **Insolvencia del broker con carga en tránsito:** tu carga va en un camión y el broker que lo contrató quiebra. El transportista real tiene derecho de retención. Determina rápido: ¿el transportista está pagado? Si no, negocia directamente con él la liberación.
-7. **Daño oculto descubierto en el cliente final:** entregaste al distribuidor, el distribuidor al cliente final, y este encuentra daño. La documentación de la cadena de custodia determina quién asume la pérdida.
-8. **Disputa de recargo pico durante evento climático:** el transportista aplica un recargo de emergencia retroactivo. El contrato puede o no permitirlo — revisa específicamente las cláusulas de fuerza mayor y de recargo por combustible.
-
-## Patrones de comunicación
-
-### Calibración de tono
-
-Ajusta el tono a la severidad y a la relación:
-
-- **Excepción rutinaria, buena relación con el transportista:** colaborativo. "Tenemos un retraso en el PRO# X — ¿me consigues un ETA actualizado? El cliente está preguntando."
-- **Excepción significativa, relación neutra:** profesional y documentado. Expón hechos, referencia el BOL/PRO, especifica qué necesitas y para cuándo.
-- **Excepción mayor o patrón, relación tensa:** formal. Con copia a gerencia. Referencia los términos del contrato. Fija plazos de respuesta. "Conforme a la Sección 4.2 de nuestro acuerdo de transporte de fecha..."
-- **De cara al cliente (retraso):** proactivo, honesto, orientado a soluciones. Nunca culpes al transportista por nombre. "Su envío ha sufrido un retraso en tránsito. Esto es lo que estamos haciendo y su cronograma actualizado."
-- **De cara al cliente (daño/pérdida):** empático, orientado a la acción. Empieza por la solución, no por el problema. "Identificamos un problema con su envío y ya iniciamos [el reemplazo/la nota de crédito]."
-
-### Plantillas clave
-
-Plantillas breves; adáptalas a tus flujos de transportista, cliente y aseguradora antes de usarlas en producción.
-
-**Consulta inicial al transportista:** Asunto: `Aviso de excepción — PRO# {pro} / BOL# {bol}`. Indica: qué pasó, qué necesitas (ETA actualizado, inspección, reporte OS&D) y para cuándo.
-
-**Actualización proactiva al cliente:** empieza con: qué sabes, qué estás haciendo al respecto, cuál es el cronograma revisado del cliente y tu contacto directo para preguntas.
-
-**Escalamiento a la gerencia del transportista:** Asunto: `ESCALAMIENTO: Excepción sin resolver — {ref_envio} — {dias} días`. Incluye la cronología de comunicaciones previas, el impacto financiero y la resolución que esperas.
-
-## Protocolos de escalamiento
-
-### Disparadores de escalamiento automático
-
-| Disparador | Acción | Plazo |
-|---|---|---|
-| Valor de la excepción > US$ 25,000 | Notificar de inmediato al VP de Supply Chain | Dentro de 1 hora |
-| Cliente enterprise afectado | Asignar gestor dedicado, notificar al equipo de cuenta | Dentro de 2 horas |
-| Transportista sin respuesta | Escalar al account manager del transportista | Tras 4 horas |
-| Transportista reincidente (3+ en 30 días) | Revisión de desempeño con compras | Dentro de 1 semana |
-| Indicadores de posible fraude | Notificar a cumplimiento y detener el proceso estándar | De inmediato |
-| Excursión de temperatura en producto regulado | Notificar al equipo de calidad/regulatorio | Dentro de 30 minutos |
-| Sin escaneo en alto valor (> US$ 50K) | Iniciar protocolo de rastreo y notificar a seguridad | Tras 24 horas |
-| Reclamo negado > US$ 10,000 | Revisión legal de la base de la negación | Dentro de 48 horas |
-
-### Cadena de escalamiento
-
-Nivel 1 (Analista) → Nivel 2 (Líder de equipo, 4 horas) → Nivel 3 (Gerente, 24 horas) → Nivel 4 (Director, 48 horas) → Nivel 5 (VP, 72+ horas o cualquier severidad Nivel 5)
-
-## Indicadores de desempeño
-
-Mide estas métricas semanalmente y analiza la tendencia mensual:
-
-| Métrica | Meta | Alerta roja |
-|---|---|---|
-| Tiempo medio de resolución | < 72 horas | > 120 horas |
-| Tasa de resolución al primer contacto | > 40 % | < 25 % |
-| Tasa de recuperación financiera (reclamos) | > 75 % | < 50 % |
-| Satisfacción del cliente (post-excepción) | > 4.0/5.0 | < 3.5/5.0 |
-| Tasa de excepciones (por 1,000 envíos) | < 25 | > 40 |
-| Puntualidad en presentación de reclamos | 100 % dentro de 30 días | Cualquiera > 60 días |
-| Excepciones repetidas (mismo transportista/ruta) | < 10 % | > 20 % |
-| Excepciones envejecidas (> 30 días abiertas) | < 5 % del total | > 15 % |
-
-## Recursos adicionales
-
-- Combina esta skill con tus plazos internos de reclamos, tu matriz de escalamiento por modo y los requisitos de aviso de tu aseguradora.
-- Mantén las reglas de POD por transportista y los checklists OS&D cerca del equipo que ejecutará los playbooks.
-
-## Skills relacionadas
-
-- `gestion-transportistas`
-- `logistica-inversa-devoluciones`
-- `cumplimiento-aduanero`
-- `planificacion-demanda-inventario`

package/vendor/theus-arsenal/skills/gestion-transportistas/SKILL.md

@@ -1,204 +0,0 @@
----
-name: gestion-transportistas
-description: Experiencia codificada para gestionar carteras de transportistas, negociar tarifas de
-  flete, medir desempeño con scorecards, asignar carga y mantener relaciones estratégicas. Incluye
-  procesos de RFP, inteligencia de mercado y verificación de cumplimiento FMCSA. Úsala al gestionar
-  transportistas, negociar tarifas, evaluar desempeño o construir estrategias de flete.
----
-
-# Gestión de relaciones con transportistas
-
-## Rol y contexto
-
-Actúas como un gerente de transporte sénior con más de 15 años gestionando carteras de 40 a más de 200 transportistas activos en camión completo (TL), carga parcial (LTL), intermodal y brokerage. Eres dueño del ciclo completo: captación de nuevos transportistas, negociación de tarifas, ejecución de RFPs, construcción de guías de ruteo, seguimiento de desempeño con scorecards, renovación de contratos y decisiones de asignación. Tus sistemas incluyen TMS (gestión de transporte), plataformas de gestión de tarifas, portales de onboarding, DAT/Greenscreens para inteligencia de mercado y FMCSA SAFER para cumplimiento. Equilibras la presión de reducir costos contra la calidad de servicio, la seguridad de capacidad y la salud de la relación — porque cuando el mercado se aprieta, la disposición de tus transportistas a cubrir tu carga depende de cómo los trataste cuando la capacidad sobraba.
-
-> Los umbrales, tarifas y referencias regulatorias (FMCSA, DAT, DOE) de esta skill corresponden al mercado de flete de Estados Unidos. Adapta cifras y reguladores al operar en otros mercados.
-
-## Cuándo usarla
-
-- Onboarding de un nuevo transportista y verificación de seguridad, seguros y autoridad operativa
-- Ejecución de un RFP anual o por carril específico para comparar tarifas
-- Construcción o actualización de scorecards y revisiones de desempeño
-- Reasignación de carga durante capacidad ajustada o bajo desempeño de un transportista
-- Negociación de aumentos de tarifa, recargos por combustible o tablas de cargos accesorios
-
-## Cómo funciona
-
-1. Capta y verifica transportistas mediante FMCSA SAFER, validación de seguros y referencias
-2. Estructura RFPs con datos a nivel de carril, compromisos de volumen y criterios de puntuación
-3. Negocia tarifas descomponiendo linehaul, combustible, accesorios y garantías de capacidad
-4. Construye guías de ruteo con asignaciones primaria/respaldo y reglas de auto-tender en el TMS
-5. Mide desempeño con scorecards ponderados (puntualidad, ratio de reclamos, aceptación de tenders, costo)
-6. Realiza revisiones trimestrales de negocio y ajusta la asignación según el ranking del scorecard
-
-## Ejemplos
-
-- **Onboarding de transportista nuevo**: un transportista LTL regional postula a tu carga. Recorre la verificación de autoridad en FMCSA, la validación del certificado de seguro, los umbrales de puntuación de seguridad y la configuración de un scorecard probatorio de 90 días.
-- **RFP anual**: ejecuta un RFP de TL de 200 carriles. Estructura los paquetes de licitación, analiza tarifas de incumbentes contra retadores frente a los benchmarks de DAT y construye escenarios de adjudicación que equilibren ahorro contra riesgo de servicio.
-- **Reasignación en capacidad ajustada**: el transportista primario de un carril crítico baja su aceptación de tenders al 60 %. Activa transportistas de respaldo, ajusta la prioridad de la guía de ruteo y negocia un recargo temporal de capacidad frente a la exposición al mercado spot.
-
-## Conocimiento base
-
-### Fundamentos de negociación de tarifas
-
-Toda tarifa de flete tiene componentes que deben negociarse por separado — agruparlos oculta dónde estás pagando de más:
-
-- **Tarifa base linehaul:** la tarifa por milla o plana por el transporte muelle a muelle. Para camión completo, compárala contra las tarifas por carril de DAT o Greenscreens. Para LTL, es el descuento sobre la tarifa publicada del transportista (típicamente 70-85 % de descuento para embarcadores de volumen medio). Negocia siempre carril por carril — un transportista competitivo en Chicago–Dallas puede estar 15 % sobre mercado en Atlanta–LA.
-- **Recargo por combustible (FSC):** porcentaje o adicional por milla ligado al precio promedio nacional del diésel del DOE. Negocia la tabla del FSC, no solo la tarifa vigente. Detalles clave: el precio base disparador (qué precio del diésel equivale a 0 % de FSC), el incremento (p. ej., $0.01/milla por cada $0.05 de aumento del diésel) y el rezago del índice (ajuste semanal vs. mensual). Un transportista que cotiza un linehaul bajo con una tabla FSC agresiva puede salir más caro que uno con linehaul mayor y FSC estándar indexado al DOE.
-- **Cargos accesorios:** detención ($50-$100/hora tras 2 horas libres es el estándar), plataforma elevadora ($75-$150), entrega residencial ($75-$125), entrega interior ($100+), acceso limitado ($50-$100), programación de citas ($0-$50). Negocia agresivamente el tiempo libre de detención — la detención de conductores es la fuente #1 de disputas de facturas. En LTL, vigila los cargos por repesaje/reclasificación ($25-$75 por evento) y los recargos por capacidad cúbica.
-- **Cargos mínimos:** todo transportista tiene un cargo mínimo por envío. En camión completo suele ser un millaje mínimo (p. ej., $800 para cargas de menos de 200 millas). En LTL es el cargo mínimo por envío ($75-$150) sin importar peso o clase. Negocia los mínimos de los carriles cortos por separado.
-- **Tarifas contrato vs. spot:** las tarifas de contrato (adjudicadas por RFP o negociación, vigentes 6-12 meses) dan previsibilidad de costo y compromiso de capacidad. Las tarifas spot (negociadas por carga en el mercado abierto) son 10-30 % mayores en mercados apretados y 5-20 % menores en mercados blandos. Una cartera sana usa 75-85 % de carga en contrato y 15-25 % en spot. Más de 30 % de spot significa que tu guía de ruteo está fallando.
-
-### Scorecards de transportistas
-
-Mide lo que importa. Un scorecard con 20 métricas se ignora; uno con 5 se ejecuta:
-
-- **Entrega a tiempo (OTD):** porcentaje de envíos entregados dentro de la ventana acordada. Meta: ≥95 %. Alerta: <90 %. Mide recojo y entrega por separado — un transportista con 98 % de puntualidad en recojo y 88 % en entrega tiene un problema de linehaul o terminal, no de capacidad.
-- **Tasa de aceptación de tenders:** porcentaje de cargas ofrecidas electrónicamente que el transportista acepta. Meta: ≥90 % para primarios. Alerta: <80 %. Un transportista que rechaza 25 % de los tenders consume el tiempo de tu equipo de operaciones y te expone al mercado spot. Una aceptación menor a 75 % en un carril de contrato significa que la tarifa está bajo mercado — renegocia o reasigna.
-- **Ratio de reclamos:** valor en dólares de los reclamos dividido entre el gasto total con el transportista. Meta: <0.5 % del gasto. Alerta: >1.0 %. Mide frecuencia y severidad por separado — un transportista con un reclamo de $50K es distinto a uno con cincuenta reclamos de $1K. El segundo indica un problema sistémico de manipulación.
-- **Exactitud de facturación:** porcentaje de facturas que coinciden con la tarifa contratada sin corrección manual. Meta: ≥97 %. Alerta: <93 %. La sobrefacturación crónica (aunque sea pequeña) señala tanteo intencional de tarifas o sistemas de facturación rotos. En ambos casos te cuesta trabajo de auditoría. Transportistas con <90 % de exactitud deben estar en acción correctiva.
-- **Tiempo tender-a-recojo:** horas entre la aceptación electrónica del tender y el recojo real. Meta: dentro de 2 horas del recojo solicitado para camión completo. Los transportistas que aceptan tenders pero recogen tarde de forma consistente están "rechazando en blando" — aceptan para retener la carga mientras buscan flete mejor.
-
-### Estrategia de cartera
-
-Tu cartera de transportistas es una cartera de inversión — la diversificación gestiona el riesgo, la concentración genera palanca:
-
-- **Transportistas con activos vs. brokers:** los transportistas con activos poseen camiones. Dan certeza de capacidad, servicio consistente y responsabilidad directa — pero son menos flexibles en precio y quizá no cubran todos tus carriles. Los brokers obtienen capacidad de miles de transportistas pequeños. Ofrecen flexibilidad de precio y cobertura de carriles, pero introducen riesgo de contraparte (doble brokerage, varianza de calidad, cadena de pagos compleja). Una mezcla típica es 60-70 % transportistas con activos, 20-30 % brokers y 5-15 % de nicho/especializados como bolsa aparte para refrigerado, materiales peligrosos, sobredimensionado u otros carriles con manejo especial.
-- **Estructura de la guía de ruteo:** construye una guía de 3 niveles para todo carril con >2 cargas/semana. El primario recibe el primer tender (meta: 80 %+ de aceptación). El secundario recibe el excedente (meta: 70 %+ de aceptación). El terciario es tu techo de precio — a menudo un broker cuya tarifa representa el "no exceder" del abastecimiento spot. Para carriles con <2 cargas/semana, usa guía de 2 niveles o un broker regional con cobertura amplia.
-- **Densidad de carril y concentración:** adjudica suficiente volumen por transportista y carril para que le importe. Un transportista con 2 cargas/semana en tu carril te priorizará sobre un embarcador que le da 2 cargas/mes. Pero no le des a uno solo más del 40 % de ningún carril — la salida o falla de servicio en un carril concentrado es catastrófica. Para tus 20 carriles principales por volumen, mantén al menos 3 transportistas activos.
-- **Valor de los transportistas pequeños:** los transportistas de 10-50 camiones suelen dar mejor servicio, precios más flexibles y relaciones más fuertes que los mega-transportistas. Contestan el teléfono. Sus dueños-operadores cuidan tu carga. El costo: menos integración tecnológica, seguros más delgados y límites de capacidad en temporada alta. Úsalos para carriles consistentes de volumen medio donde la calidad de la relación importa más que la capacidad de sobredemanda.
-
-### Proceso de RFP
-
-Un RFP de flete bien ejecutado toma 8-12 semanas y toca a todo transportista activo y prospecto:
-
-- **Pre-RFP:** analiza 12 meses de datos de envíos. Identifica carriles por volumen, gasto y niveles de servicio. Marca carriles con bajo desempeño y carriles cuyas tarifas exceden los benchmarks de mercado (DAT, Greenscreens, Chainalytics). Fija metas: porcentaje de reducción de costo, mínimos de nivel de servicio, objetivos de diversidad de transportistas.
-- **Diseño del RFP:** incluye detalle por carril (códigos postales de origen/destino, rango de volumen, equipo requerido, manejo especial), expectativas de tiempo de tránsito, requisitos de accesorios, términos de pago, mínimos de seguro y tus criterios de evaluación con ponderaciones. Haz que los transportistas coticen carril por carril — las ofertas de portafolio ("les damos 5 % de descuento en todo") ocultan subsidios cruzados.
-- **Evaluación de ofertas:** no adjudiques solo por precio. Pondera costo 40-50 %, historial de servicio 25-30 %, compromiso de capacidad 15-20 % y encaje operativo 10-15 %. Un transportista 3 % sobre la oferta más baja pero con 97 % de OTD y 95 % de aceptación de tenders es más barato que el postor más bajo con 85 % de OTD y 70 % de aceptación — las fallas de servicio cuestan más que la diferencia de tarifa.
-- **Adjudicación e implementación:** adjudica por olas — primarios primero, luego secundarios. Da a los transportistas 2-3 semanas para operativizar los carriles nuevos antes de empezar a ofrecer carga. Corre un periodo paralelo de 30 días donde la guía vieja y la nueva se superponen. Haz el corte limpio.
-
-### Inteligencia de mercado
-
-Los ciclos de tarifas son predecibles en dirección, impredecibles en magnitud:
-
-- **DAT y Greenscreens:** DAT RateView provee benchmarks de tarifas spot y contrato por carril basados en transacciones reportadas por brokers. Greenscreens provee inteligencia de precios por transportista y analítica predictiva. Usa ambos — DAT para la dirección del mercado, Greenscreens para palanca de negociación por transportista. Ninguno es perfectamente exacto, pero ambos son mejores que negociar a ciegas.
-- **Ciclos del mercado de flete:** el mercado de camión completo oscila entre favorable al embarcador (exceso de capacidad, tarifas cayendo, alta aceptación de tenders) y favorable al transportista (capacidad ajustada, tarifas subiendo, rechazos de tenders). Los ciclos duran 18-36 meses pico a pico. Indicadores clave: ratio carga-camión de DAT (>6:1 señala mercado apretado), OTRI (índice de rechazo de tenders — >10 % señala que la palanca pasa al transportista), pedidos de camiones Clase 8 (indicador adelantado de capacidad nueva a 6-12 meses).
-- **Patrones estacionales:** la temporada de productos agrícolas (abril-julio) aprieta la capacidad refrigerada en el sureste y oeste de EE. UU. La temporada alta minorista (octubre-enero) aprieta la capacidad de furgón seco a nivel nacional. La última semana de cada mes y trimestre trae picos de volumen mientras los embarcadores cumplen metas de ingresos. Programa los RFP evitando adjudicar contratos en el pico o el valle del ciclo — adjudica en la transición para obtener tarifas más realistas.
-
-### Verificación de cumplimiento FMCSA
-
-Todo transportista de tu cartera debe pasar el filtro de cumplimiento antes de su primera carga y de forma trimestral recurrente:
-
-- **Autoridad operativa:** verifica autoridad MC (Motor Carrier) o FF (Freight Forwarder) activa en FMCSA SAFER. Un estado "autorizado" sin actualizar en 12+ meses puede indicar un transportista técnicamente autorizado pero operativamente inactivo. Revisa el campo "authorized for" — un transportista autorizado para "property" no puede legalmente transportar menaje de casa.
-- **Mínimos de seguro:** $750K mínimo para carga general (FMCSA §387.9), $1M para materiales peligrosos, $5M para menaje. Exige $1M mínimo a todos los transportistas sin importar la mercancía — el mínimo de la FMCSA de $750K no cubre un accidente serio. Verifica el seguro en la pestaña de seguros de la FMCSA, no solo el certificado que entrega el transportista — los certificados pueden ser falsificados o estar desactualizados.
-- **Calificación de seguridad:** la FMCSA asigna calificaciones Satisfactory, Conditional o Unsatisfactory tras revisiones de cumplimiento. Nunca uses un transportista con calificación Unsatisfactory. Los Conditional requieren evaluación caso por caso — entiende cuáles son las condiciones. Los transportistas sin calificación ("unrated") son la mayoría — usa sus puntuaciones CSA (Compliance, Safety, Accountability). Enfócate en los BASIC de Unsafe Driving, Hours-of-Service y Vehicle Maintenance. Un transportista en el peor 25 % de Unsafe Driving es un riesgo de responsabilidad.
-- **Verificación de fianza de brokers:** si usas brokers, verifica que su fianza de $75K o su fondo fiduciario esté activo. Un broker con fianza revocada o reducida probablemente está en apuros financieros. Revisa la pestaña Bond/Trust de la FMCSA. Verifica también que el broker tenga seguro de carga contingente — te protege si el transportista subyacente causa una pérdida y su seguro es insuficiente.
-
-## Marcos de decisión
-
-### Selección de transportista para carriles nuevos
-
-Al añadir un carril nuevo a tu red, evalúa candidatos con este árbol de decisión:
-
-1. **¿Los transportistas actuales de la cartera cubren este carril?** Si sí, negocia primero con los incumbentes — añadir un transportista nuevo por un solo carril introduce costo de onboarding ($500-$1,500) y sobrecarga de gestión de relación. Ofrece a los actuales el carril nuevo como volumen incremental a cambio de una concesión de tarifa en un carril existente.
-2. **Si ningún incumbente cubre el carril:** identifica 3-5 candidatos. Para carriles de más de 500 millas, prioriza transportistas con activos domiciliados a menos de 100 millas del origen. Para carriles de menos de 300 millas, considera transportistas regionales y flotas dedicadas. Para carriles infrecuentes (<1 carga/semana), un broker con cobertura regional fuerte puede ser la opción más práctica.
-3. **Evalúa:** ejecuta la verificación de cumplimiento FMCSA. Pide a cada candidato el historial de servicio de 12 meses en el carril específico (no su promedio de red). Consulta las tarifas del carril en DAT como benchmark. Compara el costo total (linehaul + FSC + accesorios esperados), no solo el linehaul.
-4. **Periodo de prueba:** adjudica una prueba de 30 días a tarifas contratadas. Fija KPIs claros: OTD ≥93 %, aceptación de tenders ≥85 %, exactitud de facturación ≥95 %. Revisa a los 30 días — no fijes un compromiso de 12 meses sin validación operativa.
-
-### Cuándo consolidar vs. diversificar
-
-- **Consolida (reduce transportistas) cuando:** tienes más de 3 transportistas en un carril con <5 cargas/semana (cada uno recibe muy poco volumen para que le importe). Tus recursos de gestión están al límite. Necesitas mejores precios de un socio estratégico (concentración de volumen = palanca). El mercado está blando y los transportistas compiten por tu carga.
-- **Diversifica (añade transportistas) cuando:** un solo transportista maneja >40 % de un carril crítico. Los rechazos de tenders suben por encima del 15 % en un carril. Entras a temporada alta y necesitas capacidad de sobredemanda. Un transportista muestra indicadores de apuros financieros (pagos tardíos a conductores reportados en Carrier411, lapsos de seguro en FMCSA, rotación súbita de conductores visible en publicaciones de empleo).
-
-### Decisiones spot vs. contrato
-
-- **Quédate en contrato cuando:** el spread entre contrato y spot es <10 %. Tienes volumen consistente y predecible. La capacidad se está apretando (las tarifas spot suben). El carril es crítico para el cliente con ventanas de entrega ajustadas.
-- **Ve a spot cuando:** las tarifas spot están >15 % por debajo de tu tarifa de contrato (mercado blando). El carril es irregular (<1 carga/semana). Necesitas capacidad de sobredemanda puntual más allá de tu guía de ruteo. Tu transportista de contrato rechaza tenders consistentemente en ese carril (en la práctica ya te está empujando al spot).
-- **Renegocia el contrato cuando:** el spread entre tu tarifa de contrato y el benchmark de DAT supera 15 % durante 60+ días consecutivos. La aceptación de tenders de un transportista cae bajo 75 % durante 30 días. Tuviste un cambio de volumen significativo (al alza o a la baja) que cambia la economía del carril.
-
-### Criterios de salida de un transportista
-
-Retira a un transportista de tu guía de ruteo activa cuando se cumpla cualquiera de estos umbrales, tras el fracaso de una acción correctiva documentada:
-
-- OTD por debajo de 85 % durante 60 días consecutivos
-- Aceptación de tenders por debajo de 70 % durante 30 días consecutivos sin comunicación
-- Ratio de reclamos superior a 2 % del gasto durante 90 días
-- Autoridad FMCSA revocada, seguro vencido o calificación de seguridad degradada a Unsatisfactory
-- Exactitud de facturación por debajo de 88 % durante 90 días tras aviso correctivo
-- Descubrimiento de doble brokerage de tu carga
-- Evidencia de apuros financieros: revocación de fianza, quejas de conductores en CarrierOK o Carrier411, colapso de servicio inexplicable
-
-## Casos límite clave
-
-Situaciones donde las decisiones estándar del manual producen malos resultados. Se incluyen resúmenes breves para que los expandas en manuales específicos por proyecto si hace falta.
-
-1. **Apretón de capacidad durante un huracán:** tu transportista principal evacúa conductores de la costa del Golfo. Las tarifas spot se triplican. La tentación es pagar cualquier tarifa para mover la carga. La jugada experta: activa transportistas regionales preposicionados, redirige por corredores no afectados y negocia compromisos multicarga con transportistas spot para fijar un techo de tarifa.
-2. **Descubrimiento de doble brokerage:** te informan que el camión que llegó no es del transportista del BOL. La cadena de seguros puede estar rota y tu carga corre más riesgo. No aceptes la carga si no ha partido. Si está en tránsito, documenta todo y exige una explicación escrita en 24 horas.
-3. **Renegociación tras perder 40 % del volumen:** tu empresa perdió un cliente grande y tu volumen de carga cayó. Las tarifas de contrato de tus transportistas se basaban en compromisos de volumen que ya no puedes cumplir. La renegociación proactiva preserva relaciones; dejar que los transportistas descubran el déficit al facturar destruye la confianza.
-4. **Indicadores de apuros financieros de un transportista:** las señales aparecen meses antes de la quiebra: liquidaciones tardías a conductores, cambios frecuentes de aseguradora en los registros FMCSA, monto de fianza cayendo, quejas en Carrier411 disparándose. Reduce la exposición de forma incremental — no esperes a la quiebra.
-5. **Adquisición de tu socio de nicho por un mega-transportista:** tu mejor transportista regional acaba de ser adquirido por una flota nacional. Espera disrupciones de servicio durante la integración, intentos de renegociación de tarifas y la posible pérdida de tu ejecutivo de cuenta dedicado. Asegura capacidad alternativa antes de que se complete la transición.
-6. **Manipulación del recargo por combustible:** un transportista propone una tarifa base artificialmente baja con una tabla FSC agresiva que infla el costo total sobre mercado. Modela siempre el costo total en un rango de precios de diésel ($3.50, $4.00, $4.50/galón) para exponer esta táctica.
-7. **Disputas de detención y accesorios a escala:** cuando los cargos de detención representan >5 % de la facturación total de un transportista, la causa raíz suele ser la operación de tus instalaciones, no sobrecobro del transportista. Corrige el problema operativo antes de disputar los cargos — o perderás al transportista.
-
-## Patrones de comunicación
-
-### Tono en negociación de tarifas
-
-Las negociaciones de tarifas son conversaciones de relación de largo plazo, no transacciones puntuales. Calibra el tono:
-
-- **Posición de apertura:** abre con datos, no con exigencias. "DAT muestra este carril promediando $2.15/milla en los últimos 90 días. Nuestro contrato actual es $2.45. Queremos conversar el alineamiento." Nunca digas "tu tarifa es demasiado alta" — di "el mercado cambió y queremos asegurarnos de estar juntos en una posición competitiva".
-- **Contraofertas:** reconoce la perspectiva del transportista. "Entendemos que los aumentos de pago a conductores son reales. Busquemos un número que mantenga este carril atractivo para sus conductores y a nosotros competitivos." Cede en el punto medio en la tarifa base, negocia más duro en accesorios y tabla FSC.
-- **Revisiones anuales:** enmárcalas como chequeos de asociación, no como ejercicios de recorte. Comparte tu pronóstico de volumen, planes de crecimiento y cambios de carriles. Pregunta qué puedes hacer operativamente para ayudar al transportista (tiempos de muelle más rápidos, programación consistente, programas de drop-trailer). Los transportistas dan mejores tarifas a los embarcadores que facilitan la vida de sus conductores.
-
-### Revisiones de desempeño
-
-- **Revisiones positivas:** sé específico. "Su 97 % de OTD en el carril Chicago–Dallas nos ahorró aproximadamente $45K en costos de urgencia este trimestre. Aumentamos su asignación del 60 % al 75 % en ese carril." Los transportistas invierten en relaciones que premian el desempeño.
-- **Revisiones correctivas:** abre con datos, no acusaciones. Presenta el scorecard. Identifica las métricas bajo umbral. Pide un plan de acción correctiva con cronograma de 30/60/90 días. Fija una consecuencia clara: "Si el OTD de este carril no llega a 92 % en el día 60, moveremos el 50 % del volumen a un transportista alterno."
-
-Usa estos patrones como base y adapta el lenguaje a tus contratos, rutas de escalamiento y compromisos con clientes.
-
-## Protocolos de escalamiento
-
-### Disparadores automáticos
-
-| Disparador | Acción | Plazo |
-|---|---|---|
-| Aceptación de tenders bajo 70 % por 2 semanas consecutivas | Notificar a compras, agendar llamada con el transportista | Dentro de 48 horas |
-| Gasto spot supera 30 % del presupuesto de cualquier carril | Revisar guía de ruteo, iniciar captación de transportistas | Dentro de 1 semana |
-| Autoridad FMCSA o seguro del transportista vencido | Suspender tenders de inmediato, notificar a operaciones | Dentro de 1 hora |
-| Un solo transportista controla >50 % de un carril crítico | Iniciar calificación de transportista secundario | Dentro de 2 semanas |
-| Ratio de reclamos supera 1.5 % por 60+ días | Agendar revisión formal de desempeño | Dentro de 1 semana |
-| Varianza de tarifa >20 % vs. benchmark DAT en 5+ carriles | Iniciar renegociación de contrato o mini-licitación | Dentro de 2 semanas |
-| El transportista reporta escasez de conductores o disrupción | Activar respaldos, aumentar monitoreo | Dentro de 4 horas |
-| Doble brokerage confirmado en cualquier carga | Suspensión inmediata, revisión de cumplimiento | Dentro de 2 horas |
-
-### Cadena de escalamiento
-
-Analista → Gerente de Transporte (48 horas) → Director de Transporte (1 semana) → VP de Cadena de Suministro (problema persistente o exposición >$100K)
-
-## Indicadores de desempeño
-
-Mide semanalmente, revisa mensualmente con el equipo de gestión de transportistas, comparte trimestralmente con los transportistas:
-
-| Métrica | Meta | Alerta |
-|---|---|---|
-| Tarifa de contrato vs. benchmark DAT | Dentro de ±8 % | >15 % de prima o descuento |
-| Cumplimiento de la guía de ruteo (% de carga en guía) | ≥85 % | <70 % |
-| Aceptación de tenders del primario | ≥90 % | <80 % |
-| OTD promedio ponderado de la cartera | ≥95 % | <90 % |
-| Ratio de reclamos de la cartera | <0.5 % del gasto | >1.0 % |
-| Exactitud de facturación promedio | ≥97 % | <93 % |
-| Porcentaje de carga spot | <20 % | >30 % |
-| Tiempo de ciclo del RFP (lanzamiento a implementación) | ≤12 semanas | >16 semanas |
-
-## Recursos adicionales
-
-- Da seguimiento a scorecards, tendencias de excepciones y cumplimiento de la guía de ruteo en la misma revisión operativa, para que las decisiones de precio y servicio queden ligadas.
-- Documenta las posiciones de negociación preferidas de tu organización, los límites de accesorios y los disparadores de escalamiento junto a esta skill antes de usarla en producción.
-
-## Skills relacionadas
-
-- `gestion-excepciones-logisticas`
-- `logistica-inversa-devoluciones`
-- `planificacion-demanda-inventario`
-- `cumplimiento-aduanero`

package/vendor/theus-arsenal/skills/guia-adopcion-ml/SKILL.md

@@ -1,64 +0,0 @@
----
-name: guia-adopcion-ml
-description: Metodología integral para incorporar algoritmos de machine learning a bases de código
-  existentes sin ML. Cubre el encuadre del problema, la preparación de datos, el desacoplamiento
-  arquitectónico y la integración de un modelo de línea base.
----
-
-# Guía de adopción de ML
-
-Esta skill provee una metodología adaptativa para implementar modelos de machine learning en proyectos de ingeniería de software existentes. Cierra la brecha entre la ingeniería de software tradicional y MLOps estructurando cómo investigar, desacoplar, entrenar e integrar ML.
-
-## Cuándo usarla
-
-- El usuario pide "añadir ML" o "añadir un algoritmo" a su base de código existente.
-- Al planificar la integración de un nuevo modelo (p. ej., recomendación, clasificación, pronóstico) en una aplicación sin ML.
-- Al estructurar un flujo de trabajo para que el agente construya, entrene y despliegue un componente de ML de forma adaptativa.
-
-## Fase 1: Encuadre del problema y factibilidad
-
-Antes de escribir código de modelos, establece el "por qué" y el "cómo".
-
-- **Verificación heurística:** pregunta al usuario si una heurística simple (p. ej., regex, ordenamiento por reglas) podría resolver el problema más rápido. Si es así, empieza por ahí.
-- **Definición de métrica:** define qué métrica de negocio busca mejorar el modelo de ML (p. ej., tasa de clics, reducción de latencia).
-- **Presupuesto de errores:** define cómo luce una predicción "mala" y cómo debe manejarla el sistema.
-
-## Fase 2: Preparación de los datos
-
-El ML es inútil sin datos limpios y accesibles.
-
-- **Audita las fuentes de datos:** identifica dónde viven los datos de entrenamiento. ¿Es una base de datos viva, un CSV estático o una API?
-- **Contrato de datos:** establece un esquema para los datos de entrada. ¿Qué features son obligatorias? ¿Qué pasa si falta una feature?
-- **Prevención de fugas:** asegura que la división de datos propuesta no filtre accidentalmente información del futuro al conjunto de entrenamiento (p. ej., división cronológica para series temporales).
-
-## Fase 3: Integración arquitectónica y desacoplamiento
-
-No acoples fuertemente la inferencia del modelo a la lógica de negocio central.
-
-- **Frontera de API:** sugiere colocar el modelo detrás de un endpoint de API (p. ej., con `patrones-fastapi` o `patrones-django`) o de una clase de servicio dedicada.
-- **Mecanismos de respaldo:** diseña un estado por defecto. Si el modelo tarda demasiado en responder o lanza un error, el sistema debe degradarse con elegancia a una regla codificada.
-- **Feature flags:** envuelve la nueva llamada de inferencia en un feature flag para poder desplegarla (o revertirla) con seguridad.
-
-## Fase 4: Implementación y entrenamiento del modelo
-
-Estructura el código para la reproducibilidad y la iteración.
-
-- **Empieza simple:** construye primero un modelo de línea base (p. ej., una regresión logística simple de scikit-learn o una capa lineal mínima de PyTorch).
-- **Reproducibilidad:** aplica `patrones-pytorch` o buenas prácticas equivalentes: fija las semillas aleatorias, haz el código agnóstico al dispositivo y documenta explícitamente las formas de tensores/arreglos.
-- **Evidencia automatizada:** exige tests para las transformaciones de datos y el esquema de inferencia. No aceptes un modelo sin un script de evaluación que lo compare contra la línea base.
-
-## Fase 5: Traspaso a MLOps
-
-Una vez integrado el modelo de línea base, cambia el foco a la operación continua.
-
-- **Consulta `flujo-ingenieria-ml`:** guía al usuario hacia el seguimiento de experimentos, los registros de modelos y la detección de drift.
-- **CI/CD:** añade el paso de evaluación del modelo al pipeline de CI existente para asegurar que los futuros commits no degraden el rendimiento del modelo.
-
-## Flujo de trabajo iterativo del agente
-
-Al asistir a un usuario con esta guía, el agente debe:
-
-1. **Hacer preguntas aclaratorias** para completar la Fase 1 antes de proponer arquitecturas.
-2. **Redactar un contrato de datos** en la Fase 2 para aprobación del usuario.
-3. **Escribir la interfaz de desacoplamiento** (API/servicio) en la Fase 3 *antes* de escribir el bucle de entrenamiento.
-4. **Entregar un script reproducible** en la Fase 4 que entrene el modelo y guarde el artefacto.