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>
60 lines
2.3 KiB
Markdown
60 lines
2.3 KiB
Markdown
---
|
|
paper_slug: NNNN-slug
|
|
frozen_at: "" # timestamp ISO — lo rellena preregister_hypothesis al congelar
|
|
content_hash: "" # hash del contenido congelado — lo rellena preregister_hypothesis
|
|
status: draft # draft -> frozen (preregister_hypothesis lo pasa a frozen; tras congelar NO se edita)
|
|
---
|
|
|
|
> **⚠️ ESTE DOCUMENTO SE CONGELA ANTES DE MIRAR LOS DATOS (anti-HARKing).**
|
|
> El plan de análisis se fija aquí *antes* de ejecutar el experimento. Una vez congelado
|
|
> (`status: frozen`, con `frozen_at` + `content_hash`), **no se edita**. Inventar o ajustar
|
|
> la hipótesis después de ver los resultados (HARKing) invalida el paper. Si el plan cambia
|
|
> tras ver datos, eso es análisis exploratorio y se reporta como tal, no como confirmatorio.
|
|
|
|
# Pre-registro — {{título del paper}}
|
|
|
|
## 1. Pregunta de investigación
|
|
|
|
<!-- La pregunta concreta, en una frase. Debe poder responderse con un experimento. -->
|
|
|
|
## 2. Hipótesis
|
|
|
|
<!-- Falsable (Popper): una predicción que PODRÍA fallar. -->
|
|
|
|
- **H0 (nula):** <!-- no hay efecto / no hay diferencia. Es lo que el test intenta rechazar. -->
|
|
- **H1 (alternativa):** <!-- el efecto esperado, con dirección si la hay. -->
|
|
|
|
## 3. Variables
|
|
|
|
- **Independiente(s):** <!-- lo que se manipula. -->
|
|
- **Dependiente(s):** <!-- lo que se mide (la métrica de resultado). -->
|
|
- **Control:** <!-- lo que se mantiene fijo / se cubre estadísticamente. -->
|
|
|
|
## 4. Diseño
|
|
|
|
<!--
|
|
- N: tamaño de muestra (y justificación / power analysis si aplica).
|
|
- Condiciones / grupos.
|
|
- Muestreo y aleatorización.
|
|
- Criterios de inclusión / exclusión de datos (definidos AHORA, no después).
|
|
-->
|
|
|
|
## 5. Plan de análisis
|
|
|
|
<!--
|
|
El plan estadístico EXACTO, decidido antes de ver los datos:
|
|
- Test estadístico concreto (p.ej. t-test de Welch, Mann-Whitney U, regresión...).
|
|
- Métrica de effect size (p.ej. Cohen's d, diferencia de medias, odds ratio).
|
|
- Criterio de decisión (umbral alpha, qué resultado confirma/refuta H1).
|
|
- Corrección por comparaciones múltiples (p.ej. Holm-Bonferroni) si hay >1 contraste.
|
|
- Manejo de supuestos (normalidad, varianzas) y qué se hace si no se cumplen.
|
|
-->
|
|
|
|
## 6. Predicción cuantitativa
|
|
|
|
<!--
|
|
La predicción numérica concreta que el experimento pondrá a prueba.
|
|
P.ej. "esperamos d >= 0.5 con IC95% que no cruza 0" o "una reducción >= 15% en la métrica X".
|
|
Cuanto más específica, más falsable.
|
|
-->
|