CastianHans/build-evidence-travel-guide

Construyendo una guía de viaje basada en evidencia para usuarios chinos

Trata el entregable como un manual de campo ejecutable, no como una lista de atracciones.

Configuración predeterminada para el mercado chino

• A menos que el usuario solicite lo contrario, comunica y entrega en chino simplificado.
• Utiliza Xiaohongshu como capa central de la experiencia del viajero chino, manteniendo al mismo tiempo las capas de evidencia oficial, comunidades extranjeras y plataformas locales del destino.
• Al tomar decisiones de precio, proporciona simultáneamente la moneda local, una estimación en RMB con marca de tiempo del tipo de cambio y una comparación con canales comunes chinos.
• Según sea necesario, verifica individualmente Alipay, WeChat Pay, UnionPay, Visa, Mastercard, tarifas de transacciones internacionales, conversión de moneda dinámica, excepciones de solo efectivo y alternativas en caso de fallo de pago.
• Al ejecutar, verifica el pasaporte chino, la salida desde China continental, roaming/tarjeta SIM física/eSIM, enchufe, devolución de impuestos, aduanas, garantía, modelo regional, aplicación/idioma y restricciones postventa.
• Mantén los nombres de plataformas extranjeras, nombres oficiales de productos, nombres de estaciones, modelos y términos de búsqueda útiles en el idioma local para no perder precisión operativa debido a la traducción.

Reglas no negociables

1. Separa los hechos del usuario, las preferencias del usuario, las suposiciones del modelo, los hechos oficiales y las experiencias sociales.
2. No infieras limitaciones físicas a partir de la edad o el rol familiar. Pregunta o utiliza la movilidad y tolerancia al calor declaradas.
3. Verifica cada hecho inestable cercano a la entrega: clima, cierres, horarios, precios, reglas de entradas, cobertura de transporte, métodos de pago y requisitos de entrada.
4. Busca experiencias tanto positivas como negativas para cada candidato importante.
5. Una consulta que contenga "避雷" no es evidencia. Abre el resultado y confirma que discute al candidato exacto.
6. No cuentes resultados fuera de tema, copiados, promocionales o solo de título como evidencia directa.
7. No afirmes una validación negativa completa mientras algún candidato importante permanezca sin cubrir.
8. Mantén el acceso social como solo lectura. Nunca inicies sesión automáticamente, recojas cookies, publiques, comentes, des "me gusta", marques como favorito ni eludas los controles de la plataforma.
9. Cita fuentes oficiales para las reglas duras y fuentes sociales para las experiencias vividas. No sustituyas una por la otra.
10. Renderiza e inspecciona el PDF final página por página antes de la entrega.

Flujo de trabajo

1. Ingestar todo el material proporcionado

• Lee references/intake.md, recopila la información mínima requerida y detente antes de una investigación amplia si algún campo bloqueante es desconocido.
• Lee cada PDF, documento, presentación, imagen, reserva y conversación previa proporcionados.
• Extrae los hechos a un registro de requisitos antes de investigar.
• Marca cada elemento como USER_CONFIRMED, SOURCE_CONFIRMED, ASSUMPTION, UNKNOWN o CONFLICT.
• Conserva los vuelos exactos, la dirección del hotel, las fechas, el tamaño del grupo, los límites de pago, las restricciones de salud, los lugares deseados, los planes opcionales y las acciones prohibidas.
• Nunca arrastres silenciosamente una suposición anterior de otro asistente como un hecho del usuario.

Usa scripts/init_project.py DESTINATION_DIR para crear registros y carpetas reutilizables.

2. Iniciar y diagnosticar las herramientas de investigación

Lee references/bootstrap.md cuando falte o no funcione correctamente Agent-Reach, OpenCLI, el puente del navegador o el acceso a plataformas sociales.

• Prefiere Agent-Reach como enrutador de capacidades y verificador de estado.
• Ejecuta python scripts/doctor.py para identificar dependencias locales faltantes sin modificar el sistema.
• Ejecuta agent-reach doctor --json antes de trabajar con plataformas.
• Utiliza el backend informado como utilizable; no infieras el acceso solo por la instalación.
• Para navegadores Chromium, incluido Edge, usa la sesión del puente del navegador OpenCLI controlada por el usuario.
• Si no hay una sesión iniciada disponible, continúa con páginas oficiales, índices web públicos y plataformas accesibles, etiquetando la brecha.
• No bloquees la verificación oficial independiente simplemente porque un backend social no esté disponible.

3. Construir el inventario de candidatos antes de recopilar publicaciones

Enumera cada objeto relevante para la decisión:

• atracción, barrio, centro comercial, museo, restaurante o estrategia alimentaria;
• traslado al aeropuerto, pase de transporte, viaje en tren, plan de taxi, transbordo en estación;
• operación hotelera, paso de equipaje, método de pago, SIM/eSIM;
• producto, tienda, proceso de devolución de impuestos, garantía o problema de aduanas;
• rama dependiente del clima y día de respaldo completo.

Asigna a cada candidato:

• candidate_id estable;
• categoría y nombre canónico exacto;
• fecha propuesta y rol en la ruta;
• importancia: critical, major o minor;
• objetivo de evidencia;
• estado de inclusión: candidate, included, optional o rejected.

No investigues solo el itinerario inicial. Incluye reemplazos plausibles para que la evidencia negativa pueda cambiar el plan.

4. Recopilar evidencia en dos pasadas

Lee references/research-protocol.md antes de comenzar una recopilación sustancial.

Pasada A - construcción amplia de ruta

• Busca itinerarios completos, combinaciones de barrios, restricciones estacionales y arquetipos de viajero.
• Redacta grupos de días geográficamente coherentes.
• Usa esta pasada para descubrir candidatos, no para finalizarlos.

Pasada B - validación a nivel de candidato

Para cada candidato crítico o importante, busca por separado:

• experiencia positiva y duración realista;
• experiencia negativa directa, decepción, cola, calor, accesibilidad, pago, precio, higiene, cierre o fallo logístico;
• reglas oficiales actuales;
• nombre en idioma local y discusión en plataformas locales;
• conexión exacta con la siguiente parada.

Abre las publicaciones completas y los comentarios relevantes. Registra URL, fechas, plataforma, autor (si está disponible), polaridad, relevancia y la afirmación respaldada. Para cada registro social directo, guarda también un extracto, el revisor y una verificación explícita de la identidad del candidato.

5. Hacer cumplir la cobertura de evidencia

Usa estos objetivos predeterminados a menos que el usuario especifique umbrales más estrictos:

Candidato	Positivo	Negativo directo	Oficial/actual	Fracaso operativo
Atracción/ruta crítica	2	2	1	cuando aplique
Atracción/centro comercial importante	2	2	1 si existen reglas/precios	cuando aplique
Restaurante/tienda nombrada	2	2	menú/precio cuando esté disponible	1
Pase de transporte/traslado al aeropuerto	1	2	2 comprobaciones principales	2
Recomendación de producto	2	2 adverso/limitación	precio actual	garantía/compatibilidad según corresponda
Conector menor	1	1 o explícito NOT_APPLICABLE	mapa/regla actual	opcional

NOT_APPLICABLE solo está permitido con una razón escrita. "No se encontró ninguna publicación negativa" es UNCOVERED, no NOT_APPLICABLE.

Los recuentos usan solo URL canónicas únicas. Una publicación duplicada, ID de evidencia duplicado, fila de evidencia huérfana, enumeración no válida, extracto faltante o identidad de candidato no verificada es un error de validación, no una advertencia.

Ejecuta:

python scripts/audit_evidence.py PROJECT_DIR

No pases a la escritura final mientras los candidatos críticos no superen la puerta. Si una plataforma es inaccesible, divulga la deficiencia y usa la mejor alternativa disponible sin pretender equivalencia.

6. Construir cada día desde el hotel

Para cada día:

1. Comienza en la dirección exacta del hotel.
2. Agrupa las paradas por geografía y compatibilidad de días de apertura.
3. Indica cada caminata, entrada/salida de estación, dirección de tren/autobús, transbordos, trayecto en taxi, espera prevista y margen de navegación.
4. Añade la duración realista de la parada a partir de información oficial e informes sociales.
5. Añade comidas, baños, asientos, equipaje, compras y recuperación climática.
6. Calcula el tiempo neto de atracción, tiempo de tránsito/búsqueda, tiempo de comida, margen, tiempo total transcurrido, rango de caminata, rango de costos y hora de salida más tardía.
7. Define las puertas climáticas/visibilidad/entradas y una ruta de respaldo completa.
8. Elimina o degrada los candidatos cuya evidencia negativa supere su valor de ruta.

No conviertas un día completo en una sola atracción simplemente porque los viajeros sean mayores. Usa la movilidad real, el terreno, la temperatura, la humedad, la sombra y las preferencias declaradas.

7. Auditar pases de transporte y pagos por separado

Para cada recomendación de pase o pago:

• calcula el punto de equilibrio frente al itinerario real;
• distingue precio de tarjeta, precio de pase, depósito, método de recarga, regla de activación, validez, reembolsos y tarifas de servicio;
• enumera los modos incluidos y excluidos y los límites geográficos;
• verifica si cada viajero necesita una tarjeta separada;
• separa los procedimientos de compra en el aeropuerto, compra en la ciudad y regreso al aeropuerto;
• investiga casos de fallo: rechazo de tarjeta extranjera, máquinas solo en efectivo, producto incorrecto, toque perdido, activación tardía, stock no disponible, ruta incompatible y dificultad de reembolso;
• distingue la aceptación de Alipay/WeChat de la compatibilidad con códigos QR presentados por el comerciante, y la aceptación de UnionPay de las afirmaciones genéricas de "tarjeta aceptada";
• advierte contra la conversión de moneda dinámica e indica si la liquidación en moneda local es normalmente preferible;
• proporciona una alternativa exacta e indica el impacto en efectivo.

Nunca recomiendes un pase solo porque su duración de validez coincide con la duración del viaje.

8. Auditar restaurantes, compras y productos

• Prefiere una regla de decisión en lugar de un lugar frágil de "visita obligada".
• Establece límites de cola, reglas de transparencia de precios, verificaciones de pedidos y alternativas en la misma zona.
• Para productos, compara el modelo/tamaño exacto y el precio neto del mismo día, no el precio de lista.
• Compara el precio neto del destino con un precio de referencia fechado de China continental y muestra ambos en CNY cuando sea práctico.
• Incluye reacciones adversas, usuarios no adecuados, diferencias de modelo regional, garantía, voltaje/frecuencia, idioma, aduanas y restricciones de equipaje.
• Trata las promociones como observaciones que caducan, nunca como precios garantizados.

9. Escribir el manual de campo

Lee references/planning-and-pdf.md antes de redactar.

El PDF debe comenzar con:

1. clima del período del viaje y hora de actualización;
2. preparación antes de la salida.

Luego incluye:

• reservas y límites estrictos;
• operaciones de tarjeta de transporte y traslado al aeropuerto;
• calendario general;
• una sección completa por día;
• una tarjeta de ejecución por parada;
• alternativas completas;
• comida, compras, productos, manejo de emergencias, tarjetas en idioma local;
• cobertura de evidencia y fuentes legibles para humanos.

Usa imágenes solo cuando ayuden materialmente al reconocimiento, la navegación o una decisión no obvia. No uses capturas de pantalla sociales como navegación fija cuando los letreros en vivo o las instrucciones del mapa sean más confiables.

10. Validar y entregar

• Vuelve a verificar los hechos oficiales inestables.
• Ejecuta la auditoría de evidencia y resuelve todos los fallos críticos.
• Genera el PDF.
• Ejecuta scripts/validate_pdf.py FILE.pdf --require "term" ....
• Ejecuta scripts/render_pdf.py FILE.pdf RENDER_DIR.
• Inspecciona la hoja de contactos y las páginas representativas a resolución completa.
• Corrige recortes, desbordamientos, páginas accidentales dispersas, URL ilegibles, glifos faltantes, imágenes rotas y tarjetas ambiguas entre páginas.
• Registra el número de páginas, tamaño del archivo, SHA-256, recuentos de investigación, candidatos descubiertos y marca de tiempo de verificación.
• Entrega el PDF y, cuando se solicite, el paquete de fuentes/evidencia.

Lenguaje de evidencia

Usa afirmaciones precisas:

• DIRECT: la fuente abierta discute el candidato y problema exactos.
• PARTIAL: misma área/categoría, pero no el candidato o escenario exacto.
• MISMATCH: el resultado de búsqueda trata sobre otro objeto; exclúyelo de los recuentos.
• PROMOTIONAL: incentivo del creador o promoción obvia; consérvalo solo como descubrimiento.
• OFFICIAL: información dura autorizada, no prueba de experiencia del viajero.
• UNCOVERED: evidencia requerida no encontrada.

Nunca escribas "todos los elementos fueron verificados por publicaciones negativas" a menos que la auditoría de evidencia pase en el umbral declarado.