Data2Model

data2model es una herramienta CLI (Command Line Interface) diseñada para inicializar rápidamente una arquitectura de DataOps basada en agentes. Su objetivo principal es estructurar un nuevo proyecto con todos los flujos de trabajo (workflows) y requerimientos documentados necesarios para comenzar a construir Data Marts, ETLs y Dashboards.

Instalación

Puedes instalar el paquete globalmente en tu máquina para usarlo en cualquier proyecto:

npm install -g .

(Asegúrate de estar en el directorio raíz de este paquete data2model al ejecutar el comando)

Uso

Para usar data2model, dirígete a la carpeta raíz de un nuevo proyecto en tu terminal y ejecuta:

data2model

Integración con IDE (Antigravity)

Si estás utilizando el IDE de Antigravity y quieres generar automáticamente los flujos de trabajo y habilidades (skills) para tu agente local, utiliza el parámetro --ide:

data2model --ide antigravity

Estructura Generada

El comando creará la siguiente estructura en el directorio donde sea invocado:

• input/lineage/: Carpeta destinada a incluir los archivos .md que contienen la información o contexto de origen de la base de datos (Data Lineage).
• input/requirements/: Carpeta destinada a contener subcarpetas por cada requerimiento de negocio que se quiera resolver, incluyendo la documentación necesaria para la generación del Data Mart.
• input/reference_sql/: Carpeta con consultas SQL históricas y patrones validados. El agente consultará este historial para aprender cómo el equipo resuelve uniones (joins), filtrados y problemas comunes.
• input/feedback/: Registro de "historias de éxito" y correcciones manuales (feedback_log.md) que el agente consultará para aprender de decisiones previas.
• docs/: Carpeta con plantillas y estándares documentales, como por ejemplo las plantillas de diseño de Hefesto.
• modular_governance/: Carpeta que contiene la arquitectura modular para el descubrimiento, enriquecimiento, publicación y reporte de metadatos (incluye scripts base en scripts/, manuales en docs/ y plantillas de configuración).
• .agent/ (solo con --ide antigravity):
  • workflows/: Plantillas pre-generadas de DataOps para invocar desde el chat de Antigravity:
    • /d2m-model: Creación y diseño del modelo de datos (Data Mart).
    • /d2m-etl: Construcción del script del pipeline ETL.
    • /d2m-dashboard: Creación del dashboard.
    • /d2m-change: Integración de un nuevo requerimiento o KPI al Data Mart y ETL existente.
    • /d2m-metadata: Descubrimiento físico, enriquecimiento cognitivo, publicación y reporte de metadatos/linaje en OpenMetadata.
  • skills/: Habilidades especializadas que el agente puede usar durante la ejecución de los workflows.