egutierrez
6e3c3cf2a2
Nuevo tipo de artefacto para papers académicos reproducibles (papers/<NNNN-slug>/): - Plantillas docs/templates/paper.md (IMRaD completo con guías por sección: Abstract, Introduction, Related work, Methods, Results, Discussion con Limitaciones + Amenazas a la validez, Conclusion + Future work) y docs/templates/preregistration.md (H0/H1 falsable, variables, diseño, plan de análisis con test exacto + effect size + corrección múltiple, predicción cuantitativa; nota anti-HARKing de congelado). - Pipeline init_paper (bash/functions/pipelines/init_paper.sh + .md): calcula el siguiente NNNN, crea las subcarpetas (experiments data figures reviews out), copia las plantillas rellenando el frontmatter (title, slug, date, phase=question, status=draft) y crea references.md. No hace git init (fase interna local). - Función atómica reutilizable next_numbered_dir (bash/functions/io): siguiente prefijo NNNN- escaneando un directorio numerado (reutilizable por papers/reports/issues). - papers/ como artefacto local gitignored (bloque en .gitignore + papers/.gitkeep): un paper en fase interna no contamina el repo padre; al promocionar a publishable se vuelve sub-repo Gitea propio. - Página de capacidad docs/capabilities/papers.md + fila en el INDEX: tabla de funciones del grupo papers (disponibles + en construcción por la flota), ejemplo canónico end-to-end y fronteras. Reutiliza slugify_ascii del registry. Diseño: reports/0001-2026-06-30-papers-system-design.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
95 lines
2.9 KiB
Markdown
95 lines
2.9 KiB
Markdown
---
|
|
title: "TITULO DEL PAPER"
|
|
slug: NNNN-slug
|
|
authors: [Enmanuel]
|
|
date: 2026-01-01
|
|
status: draft # draft | internal | publishable
|
|
phase: question # question -> review -> hypothesis -> design -> running -> analysis -> writing -> internal-review -> polish -> submitted
|
|
tags: []
|
|
domain: datascience
|
|
hypothesis_id: "" # lo rellena preregister_hypothesis al congelar el preregistro
|
|
---
|
|
|
|
<!--
|
|
Paper académico reproducible (formato IMRaD). Esta es la FUENTE editable en Markdown;
|
|
el entregable PDF se genera con render_paper_pdf (grupo `papers`).
|
|
|
|
Regla de oro anti paper-mill: una hipótesis que PODÍA fallar + un experimento con
|
|
riesgo real de refutación + estadística que no es teatro. Si no hay riesgo de
|
|
refutación, no es un paper. Los claims nunca superan a la evidencia.
|
|
-->
|
|
|
|
# {{título del paper}}
|
|
|
|
## Abstract
|
|
|
|
<!--
|
|
Resumen estructurado en 4-6 frases: contexto -> gap -> método -> resultados -> conclusión.
|
|
Sin citas, sin abreviaturas sin definir. Es lo único que mucha gente leerá: que se sostenga solo.
|
|
-->
|
|
|
|
## 1. Introduction
|
|
|
|
<!--
|
|
Embudo en cuatro movimientos:
|
|
1. Contexto — el área y por qué importa.
|
|
2. Gap — qué NO se sabe todavía (el hueco que este paper llena).
|
|
3. Pregunta / hipótesis — formulada de forma falsable (ver preregistration.md).
|
|
4. Contribución — lista explícita de lo que aporta este trabajo ("Contributions:").
|
|
-->
|
|
|
|
## 2. Related work
|
|
|
|
<!--
|
|
Qué existe ya y por qué no basta. Agrupa por enfoque, no por autor. Cada cita debe
|
|
justificar por qué el gap sigue abierto. Output de la fase de revisión (skill deep-research).
|
|
-->
|
|
|
|
## 3. Methods
|
|
|
|
<!--
|
|
Diseño REPRODUCIBLE: otra persona lo corre y obtiene lo mismo.
|
|
- Variables: independiente(s), dependiente(s), control.
|
|
- Diseño: N, condiciones, muestreo, aleatorización.
|
|
- Métricas y cómo se miden.
|
|
- Protocolo paso a paso + dónde vive el código (experiments/) y los datos (data/).
|
|
Debe ser coherente con el preregistration.md congelado (no se cambia el plan tras ver datos).
|
|
-->
|
|
|
|
## 4. Results
|
|
|
|
<!--
|
|
Datos SIN interpretar. Tablas y figuras (figures/) con su lectura literal.
|
|
Reporta effect size + intervalos de confianza, no solo p-valores.
|
|
Incluye también los resultados negativos / no significativos (anti cherry-picking).
|
|
-->
|
|
|
|
## 5. Discussion
|
|
|
|
<!--
|
|
Interpretación de los resultados a la luz de la pregunta. Claims <= evidencia.
|
|
-->
|
|
|
|
### 5.1 Limitaciones
|
|
|
|
<!-- Qué no cubre el estudio, supuestos, datos faltantes. Honestidad explícita. -->
|
|
|
|
### 5.2 Amenazas a la validez
|
|
|
|
<!--
|
|
- Validez interna — ¿la causa es lo que decimos o hay confusores?
|
|
- Validez externa — ¿generaliza fuera de esta muestra/condiciones?
|
|
- Validez de constructo — ¿la métrica mide lo que dice medir?
|
|
- Validez estadística — ¿N suficiente, supuestos del test cumplidos, comparaciones múltiples corregidas?
|
|
-->
|
|
|
|
## 6. Conclusion + Future work
|
|
|
|
<!--
|
|
Cierre en 2-4 frases: qué se aprendió (sin overclaiming) + las siguientes preguntas que abre.
|
|
-->
|
|
|
|
## References
|
|
|
|
<!-- Ver references.md. -->
|