Morfeo IA — Marco Multi-Agente de Formulación de Propuestas de Investigación

Laboratorio de Inteligencia Artificial — Universidad Nacional de Colombia Sede Manizales
Orquestación agéntica, formulación metodológica rigurosa y generación de propuestas científicas en LaTeX y Word

Morfeo IA (propuestasmorfeo-ia) es un entorno de trabajo agéntico diseñado para redactar, estructurar y auditar propuestas completas de investigación y desarrollo tecnológico en Inteligencia Artificial. Produce documentos formales en español bajo formato LaTeX nativo (con exportación determinista a Word/DOCX), estructurados en 16 secciones metodológicas con coherencia matemática, lógica y presupuestal.

El sistema coordina un equipo de 11 subagentes especializados guiados por compuertas de revisión (gates G0.5 a G7), auditoría cruzada de coherencia, generación determinista de diagramas TikZ y una capa de grafos de conocimiento dual conectada mediante el servidor MCP codegraph.

Índice

1. Instalación
2. Inicio Rápido
3. Comandos del CLI (morfeo)
4. Tablero de Control Web (morfeo ui)
5. Ecosistema de Agentes Especializados
6. Flujo del Pipeline y Compuertas de Revisión
7. Capa de Grafos de Conocimiento (Codebase-Memory)
8. Bucle Determinista de Diagramas TikZ
9. Criterios de Estilo y Prosa Natural
10. Runtimes Soportados
11. Pruebas Automatizadas

Instalación

Morfeo se distribuye como paquete de Python instalable vía pip o pipx. El CLI base no impone dependencias externas obligatorias para mantener una huella ligera (~2 MB).

# Instalación recomendada en entorno aislado
pipx install propuestasmorfeo-ia

# O instalación directa con pip
pip install propuestasmorfeo-ia

Si deseas soporte extendido opcional para FastAPI y Uvicorn en el panel de control web:

pip install "propuestasmorfeo-ia[ui]"

(El comando morfeo ui funciona de forma nativa con el servidor multihilo de la biblioteca estándar de Python sin requerir paquetes adicionales).

Inicio Rápido

Para iniciar un nuevo proyecto de propuesta en una carpeta independiente:

# 1. Crear el espacio de trabajo de la propuesta
morfeo init ~/propuestas/salud-mental-ia --title "Sistema de Alertas Tempranas en Salud Mental"

# 2. Entrar al proyecto creado
cd ~/propuestas/salud-mental-ia

# 3. Lanzar el panel de seguimiento visual en el navegador
morfeo ui

# 4. Inspeccionar el estado del proyecto desde la terminal
morfeo status

Dentro del directorio inicializado puedes ejecutar los comandos del asistente en Claude Code (/propuesta-init, /propuesta-analizar, /propuesta-continuar) o el pipeline de tu runtime preferido.

Comandos del CLI (morfeo)

Nota de compatibilidad: El comando marco se mantiene disponible como alias idéntico de morfeo.

Tablero de Control Web (morfeo ui)

El comando morfeo ui lanza un panel de control interactivo en el navegador (http://localhost:8765):

• Pipeline y Compuertas: Monitoreo en vivo de las 13 fases y el estado de aprobación de los 8 gates (G0.5, G1, G2, G3, G4, G5, G5.5, G6.4, G6.5, G7).
• Telemetría de Uso: Desglose del consumo acumulado de tokens, tool-uses y duración por fase a partir del registro del framework.
• Grafos de Conocimiento: Visores embebidos interactivos para explorar el grafo de literatura científica (papers-graph) y el mapa de relaciones del vault Obsidian (vault-graph).
• Visor PDF Integrado: Previsualización del documento LaTeX compilado con descarga directa.

Ecosistema de Agentes Especializados

El marco cuenta con 11 subagentes especializados con roles no solapados:

Flujo del Pipeline y Compuertas de Revisión

El ciclo de formulación se divide en unidades metodológicas estrictas:

Fase 0    Ingesta de insumos y clasificación TDR / borrador
  │
  ├── [GATE G0.5] Aprobación de tabla de secciones ajustada al TDR
  │
Fase 1    Árbol de problemas (§3) y pregunta de investigación
  ├── Bucle TikZ: figura arbol_problemas (render determinista)
  └── [GATE G1] Veredicto Revisor
  │
Fase 2    Estado del arte (§4, ≥30 refs Q1/Q2) e hipótesis (§5)
  ├── Bucle TikZ: figura estado_arte
  └── [GATE G2] Veredicto Revisor
  │
Fase 3    Justificación y pertinencia (§2, TRL 6/7 explícito)
  └── [GATE G3] Veredicto Revisor
  │
Fase 4    Objetivo general (§6) y 3 específicos (§7) — mapeo 1:1 con subproblemas
  └── [GATE G4] Veredicto Revisor
  │
Fase 5    Marco conceptual (§8) y equipo de trabajo (§9, roles derivados de §7)
  └── [GATE G5] Veredicto Revisor
  │
Fase 5.5  Metodología articulada (§10)
  ├── Bucle TikZ: figura metodologico
  └── [GATE G5.5] Veredicto Revisor
  │
Fase 6    Resultados esperados (§11) y consideraciones éticas (§12)
Fase 6.4  Presupuesto financiero (§13)
  └── [GATE G6.4] Veredicto Revisor
  │
Fase 6.45 Cronograma de actividades (§14, Gantt) y productos (§15)
Fase 6.5  Front-matter (Resumen, Resumen ejecutivo, Palabras clave)
  └── [GATE G6.5] Veredicto Revisor
  │
Fase 7    Auditoría cruzada final y ensamble de main.tex
  └── [GATE G7] Aprobación final y compilación PDF/DOCX

El flujo completo, en diagrama

El diagrama muestra cada etapa en este orden con su comando, sus agentes especializados, sus compuertas de revisión (gates) humanas y lo que deja en disco. La versión interactiva, con enlaces al código fuente de cada nodo y navegación visual offline, se encuentra en:

👉 docs/diagrams/morfeo-pipeline-flow.html (abre en cualquier navegador web; generado con Archify y validado con archify check). Su fuente y especificación viven en docs/diagrams/.

Tres certezas antes de la primera corrida.

1. Nada de lo que redactas o investigas se sincroniza a GitHub. La carpeta proposals/ (con sus cuatro subcarpetas insumos/, artefactos/, grafos/ y redaccion/) viaja a GitHub completamente ignorada en .gitignore; una propuesta es material de investigación confidencial y propiedad intelectual de sus autores, y publicarla por accidente es una fuga. Solo vive en tu máquina local.
2. Cada fase valida dependencias estrictas antes de ejecutarse. Si falta un insumo o una compuerta previa, el sistema se detiene y reporta el prerrequisito faltante en lugar de inventar contenido.
3. Las compuertas humanas nunca son saltadas en automático. Cada gate requiere el veredicto del usuario o del Revisor para avanzar formalmente.

• Diagrama de Flujo (Mermaid/SVG): Visualiza también la secuencia BPMN en docs/pipeline-flow.svg o revisa las notas de diseño en docs/pipeline-flow.md.

Capa de Grafos de Conocimiento (Codebase-Memory)

Morfeo integra la capa de grafo mediante el servidor MCP codegraph (@colbymchenry/codegraph), gestionando dos corpus por corrida:

1. <run-id>-papers: Indexa el repositorio de literatura científica recolectada en artefactos/scoping/papers/, extrayendo clusters conceptuales y relaciones temáticas en grafos/papers-graph-report.md.
2. <run-id>-vault: Indexa el espejo Markdown compatible con Obsidian en artefactos/vault/, evaluando la conectividad de ideas entre secciones e insumos en grafos/vault-graph-report.md.

El script scripts/graph_html.py genera un gemelo visual interactivo en HTML para cada grafo (grafos/<corpus>-graph.html), permitiendo inspeccionar la red conceptual tanto en local como desde el visor del panel de control web.

Bucle Determinista de Diagramas TikZ

Los diagramas (árbol de problemas, mapa del estado del arte y diagrama metodológico) no se codifican a mano en LaTeX. La geometría se genera mediante un compilador determinista:

python3 scripts/figura.py <name> --spec specs/<name>.spec.json

1. Diseñador-TikZ redacta únicamente la especificación en formato JSON (specs/<name>.spec.json).
2. render_tikz.py calcula anchos óptimos, equiespaciado de columnas, anclas y aplica la paleta institucional (UNAL, LabIA, GCPDS).
3. compile_tikz.py compila la figura y ejecuta el autofix determinista ante advertencias de Overfull \hbox.
4. audit_tikz.py valida mecánicamente 17 criterios técnicos (incluyendo legibilidad y dimensiones físicas).
5. Revisor-Figuras emite juicio visual exclusivamente sobre escala, armonía y centrado a partir del render PNG pregenerado.

Criterios de Estilo y Prosa Natural

Toda la prosa generada en español pasa obligatoriamente por las directrices de dos metodologías integradas:

• estilo-natural-es: Garantiza cadencia variada, predominio de voz activa, transiciones fluidas y eliminación de fórmulas mecánicas habituales en modelos de lenguaje, manteniendo fidelidad estricta a datos, citas y cifras.
• depuracion-redundancias-es: Audita que cada párrafo introduzca un avance conceptual genuino, eliminando reiteraciones léxicas o argumentativas dentro de una misma sección.

Runtimes Soportados

El marco admite ejecución multi-runtime:

• Claude Code (Canónico): Definición principal en .claude/agents/ y .claude/commands/.
• Google Antigravity: Port generado en .agent/workflows/ y .agent/skills/.
• OpenCode: Port generado en .opencode/agents/ y .opencode/commands/.
• Pi: Port generado en .pi/agents/ y .pi/prompts/.

Para sincronizar y validar los puertos secundarios ante cualquier modificación de los archivos base:

python3 scripts/gen-antigravity.py
python3 scripts/gen-opencode.py --check
python3 scripts/gen-pi.py --check

Pruebas Automatizadas

El proyecto cuenta con una suite integral de pruebas unitarias y de integración que verifican la integridad del CLI, la compilación de diagramas y la coherencia del manifiesto:

python3 -m unittest discover -s tests -p "test_*.py"

Licencia

Distribuido bajo la licencia Apache 2.0. Desarrollado por el Laboratorio de Inteligencia Artificial de la Universidad Nacional de Colombia Sede Manizales.