Saltar a contenido

Tu primer paper con la CLI

En este tutorial vas a bootstrappear tu primer paper de punta a punta con belico create-paper. Vas a ver cómo se arma el scaffold IMRaD, qué significa cada flag y cómo seguir hacia el pipeline completo.

Antes de empezar

Necesitás el stack instalado y la CLI disponible (belico --help). Si no la tenés, hacé primero Primeros pasos.

Paso 1 — Entender el comando

belico create-paper crea un paper nuevo desde un template multi-institución. Tres flags son obligatorios:

Flag Qué define Valores válidos
--venue Quartile objetivo Q1, Q2, Q3, Q4, Conference
--domain Dominio científico SHM, biomedical, hydraulics, structural, economics, environmental, geotechnical, materials, transportation, water, air, ...
--client Institución target UC, Scopus, SciELO, PUC, free (case-insensitive)

Flags opcionales útiles:

Flag Efecto
--output-dir DIR Carpeta destino (default: articles/<auto-slug>/)
--briefing Invoca el intake_agent (lazy import)
--no-intake Salta el intake explícitamente
--dry-run No crea archivos, solo muestra el resumen
--lang es\|en Override del idioma de salida

Paso 2 — Ensayar con --dry-run

Antes de crear nada, ensayá para ver el slug y la ruta que se generarían:

belico create-paper --venue Q2 --domain biomedical --client free --dry-run

La CLU muestra una tabla con venue, domain, client, el slug canónico (formato <client>-YYYY-MM-<domain>-<venue>, ej. continental-2026-05-shm-q1) y la ruta destino. Sin tocar el disco.

Paso 3 — Crear el paper

Cuando estés conforme, sacá el --dry-run:

belico create-paper --venue Q1 --domain SHM --client UC --output-dir ./mi-paper

Esto crea:

  • metadata.yaml — venue, domain, client, slug, created_at, status: draft.
  • paper.md — esqueleto IMRaD con header (Abstract, Introduction, Methods, Results, Discussion, Conclusion, References).

Cómo se mapea el cliente

Los slugs se normalizan: UC → continental, PUCP → puc. El nombre de archivo del perfil de institución coincide con config/institutions/<slug>.yaml.

Paso 4 — (Opcional) Intake con briefing

Si querés que el intake_agent procese un briefing al crear:

belico create-paper --venue Q3 --domain economics --client Scopus --briefing

El agente se importa de forma lazy (solo cuando pasás --briefing), preservando el arranque rápido de la CLI.

Paso 5 — Continuar con el pipeline

Crear el paper es la fase de scaffold. A partir de acá entra el pipeline SDD completo (EXPLORE → PROPOSE → SPEC/DESIGN → TASKS → COMPUTE → IMPLEMENT → VERIFY → FINALIZE → ARCHIVE), que el orquestador delega a sub-agentes.

El siguiente paso natural es verificar el borrador cuando tenga contenido:

belico verify --paper-id continental-2026-05-shm-q1

Ver también