idea_world_labDEV JOURNAL
jueves, 18 de junio de 2026

18 de junio de 2026

  • Ayer bebí alrededor de 1 litro de café en una cafetería y hoy me sentí muy mal, lo que me impidió programar adecuadamente
  • Eliminé por completo los entregables de chunking/post‑procesamiento de Godot RAG creados el 17 de junio, considerándolos como línea base
    • Borré docs_chunks.jsonl v1, docs_chunks_v2.jsonl v2 y los entregables de catálogo/índice/mapeo de v3/v3.1
    • También eliminé los scripts preliminares de chunking/post‑procesamiento/validación y el borrador inicial de chat/índice RAG
    • Dejé work/godot_rag/ vacío para no usar los entregables incorrectos como referencia
  • Registré la razón de la limpieza como retrospectiva
    • Determiné que el problema fue haber empezado el chunking antes de analizar suficientemente la estructura de la documentación oficial
    • El objetivo de basarse en toda la documentación oficial de Godot se desvió hacia “API clave MVP” elegidas arbitrariamente por el LLM y hacia direcciones de codificación rígida, contaminando el proceso
    • Señalé que, sin mi instrucción, ChatGPT/Codex redujo el alcance arbitrariamente o asumió que había una respuesta antes de que el paso terminara, generando entregables adicionales
    • Concluí que, cuando se mezclan los productos generados por LLM, candidatos regex, referencias oficiales y reglas aprobadas por el usuario, no pueden usarse como criterio para etiquetadores o clasificadores RAG
  • Volví a registrar las deficiencias de la arquitectura actual
    • La capa de análisis estático es débil
    • No hay validación basada en AST/parsers de GDScript
    • El grafo de dependencias del proyecto Godot es insuficiente
    • La validación de ejecución/sintaxis es limitada
    • La taxonomía de etiquetas sigue siendo gruesa
    • La distinción del provenance entre los productos del LLM y las respuestas verificadas es escasa
    • El diseño para prevenir fugas y eliminar duplicados es deficiente
  • Reorienté la dirección del próximo trabajo hacia el análisis del origen godot_docs_full
    • En lugar de volver a crear RAG o catálogos, primero analizaremos directamente outputs/godot_docs_full/pages
    • Necesitamos verificar qué estructura Markdown tienen los documentos de referencia de clases, migraciones y tutoriales
    • Según la estructura de la documentación oficial de Godot, debemos rediseñar qué unidad de chunk usar: por página, por sección o por miembro de API
    • Concluí que, antes del chunking, debemos definir primero los criterios del informe de validación
  • Retrospectiva de desarrollo: docs/retrospectives/2026-06-18-godot-rag-reset.md