Visitas al sitio: …

Meta-skill de alineación BOA5 en ingeniería con Tríada humano–IAs: evidencia empírica en OpenGravity Video Studio

Autores: Severo Peguero; Gemini (IA, Google); Cursor (IA, Anthropic); Antigravity / Gemini (IA, entorno auxiliar)
Fecha: 29 de Marzo 2026
Estado: ✅ PAPER CIENTÍFICO
Etiquetas: [PAPER][BOA5][TRIADA][OPENGRAVITY][EVIDENCIA_EMPIRICA][FASTAPI][METODOLOGIA]

🙏 GLORIA A DIOS

"Porque el Señor da la sabiduría, y de su boca viene el conocimiento y la inteligencia." (Proverbios 2:6)

"Porque de Él, y por Él, y para Él, son todas las cosas. A Él sea la gloria por los siglos. Amén." (Romanos 11:36)

📋 RESUMEN EJECUTIVO

Se documenta un meta-skill reutilizable para equipos humano–múltiples IAs (modelo Tríada): fijar estado deseado verificable y checklist; recibir propuestas de distintos agentes; anclar la decisión en evidencia del mundo (logs HTTP, orden de rutas en el framework, sistema de archivos). La viñeta operativa es OpenGravity Video Studio (FastAPI + frontend estático): un contrato API “textbook” (DELETE /api/videos/{archivo}) chocó con StaticFiles montado en /, produciendo 405 Method Not Allowed en el log de uvicorn. La solución fue cambiar el contrato (POST /api/delete-video con JSON) y reforzar validación de rutas y UI.

La evidencia incluye: (i) extractos de log del fallo; (ii) corrida reproducible con curl (§7 del anexo); (iii) traza HTTP literal desde navegador con POST /api/delete-video 200 y GET /api/videos posterior 200 (§2.6); (iv) acta de validación humana en interfaz (lista coherente, fin de entradas engañosas tipo “0.p MB”, borrado extremo a extremo). Se declara explícitamente el carácter cualitativo y trazable de la evidencia (no experimento con muestra N). El repositorio SecretariaVirtual aloja documentación versionada en docs/opengravity_studio/; el código del Studio permanece en despliegue local (T7 Shield).

1. INTRODUCCIÓN

1.1 Problema

En colaboración humano–IA–IA, es frecuente que varios modelos converjan en una API “elegante” sin contrastarla con el montaje real del servidor. Si la interfaz muestra síntomas ambiguos (“no borra”, “la tarjeta vuelve”), sin logs el equipo puede debatir en abstracto indefinidamente.

1.2 Pregunta de investigación (ingeniería de métodos)

¿Puede documentarse un ciclo completo que una hipótesis de stack (orden de rutas + archivos estáticos) con trazas HTTP verificables y prueba humana en UI, de forma útil para BOA5 (metanivel de proceso: cómo se ancla la acción en el mundo requerido)?

1.3 Alcance y límites

  • Incluye: viñeta reproducible, invariantes de implementación, anexo de evidencia con checklist.
  • No incluye: inferencia estadística, benchmark con N grande, ni afirmación de generalidad fuera del patrón FastAPI/Starlette + StaticFiles en /.

2. MARCO: TRÍADA Y META-SKILL

Rol Función
Director humano Criterios de producto, priorización, validación final en navegador.
Gemini / Antigravity Propuestas amplias, diseño, planes en entornos auxiliares.
Cursor (Claude) Lectura de repo, parches, lectura de logs, explicación de causa raíz.

Regla de oro: cuando el voto de dos IAs choca con el log de uvicorn, gana el mundo externo.

Pasos del meta-skill: (1) estado deseado + Definition of Done; (2) propuestas de agentes; (3) anclaje con logs/montaje/disco; (4) contrato e implementación alineados; (5) validación documentada.

3. VIÑETA TÉCNICA: OPENGRAVITY VIDEO STUDIO

3.1 Síntoma y lectura del log

Peticiones DELETE o POST bajo el prefijo /api/videos/... (distintas de la ruta exacta del listado) devolvían 405. Interpretación: el montaje app.mount("/", StaticFiles(...)) intercepta rutas que el estático interpreta como recursos bajo su árbol; no llegan al manejador FastAPI deseado.

3.2 Invariante de implementación

Usar POST /api/delete-video con cuerpo JSON {"filename":"…","confirm":1} fuera del patrón conflictivo. Refuerzos: Path.resolve() + relative_to para confinar borrado a videos/; cabeceras anti-caché en listado; bust de caché en fetch; papelera deshabilitada durante la petición.

3.3 Coherencia lista–disco

Filtrado en el listado principal de temporales, ._*, y archivos menor que 64 KB para reducir entradas engañosas; modo Basura para limpieza. Importación por URL con yt-dlp en segundo plano, con mensajes [import:…] al chat del Studio.

4. EVIDENCIA (SÍNTESIS DEL ANEXO)

Los detalles literales (transcripciones de terminal, extractos uvicorn, protocolo curl) viven en el documento de trazabilidad del repositorio: docs/opengravity_studio/EVIDENCIA_TRAZABILIDAD_STUDIO_BIBLIOTECA_2026-03.md (secciones §2, §2.5–2.6, §7, §8).

Línea de cierre: hipótesis → parche → 200 en POST /api/delete-video → segundo GET /api/videos 200 → confirmación humana en UI.

5. DISCUSIÓN

5.1 Relación con BOA5 (Pieza A)

El caso ilustra P2 en práctica: no sustituir el juicio humano ni el log por el “voto” del modelo cuando la evidencia externa es accesible. La trazabilidad (anexo + commits + logs) es el análogo operativo de P3.

5.2 Herramienta y ciencia

Construir el Studio es ingeniería; registrar el ciclo con honestidad metodológica es ingeniería de métodos al servicio de divulgación científica del trabajo con IA en equipo.

6. CONCLUSIONES

  1. El meta-skill Tríada + anclaje en log cerró un fallo real de routing que la UI sola no explicaba.
  2. La evidencia cualitativa (405, curl, uvicorn literal, acta humana) es suficiente para sostener la tesis de proceso en este caso, sin confundirla con un ensayo clínico.
  3. El patrón es transferible a otros módulos donde convivan API y StaticFiles amplio.

REFERENCIAS Y MATERIAL DE APOYO

  • docs/opengravity_studio/EVIDENCIA_TRAZABILIDAD_STUDIO_BIBLIOTECA_2026-03.md
  • docs/opengravity_studio/BORRADOR_PIEZA_B_META_SKILL_TRÍADA_2026-03-30.md
  • docs/opengravity_studio/README.md
  • docs/_SUBRED_SITIO_WEB/AGREGAR_PAPER_GUIA_COMPLETA_2026-03-09.md (invariante de publicación web)

Palabras clave: BOA5, Tríada, FastAPI, StaticFiles, evidencia cualitativa, OpenGravity, ingeniería de métodos, uvicorn, delete-video