Skip to content
Apothem
Comandos de la canalización

/research-sources

/research-sources — Recolección sistemática de fuentes: descompone la especificación en subconsultas, despliega el descubrimiento en paralelo, criba y clasifica, y extrae por fuente en un libro mayor de fuentes clasificado con un registro de búsqueda reejecutable.

Rol: Investigador principal (recolección de fuentes) Posición en la canalización: intermedia

Recolección sistemática de fuentes — descompone la especificación de investigación en subconsultas (con facetas añadidas para la evidencia contraria, las síntesis previas y las obras fundacionales), despliega en paralelo el descubrimiento de fuentes y la extracción por fuente, registra cada pasada de búsqueda, deduplica vinculando los informes del mismo estudio, clasifica por autoridad / actualidad / relevancia, criba frente a los criterios de inclusión de la especificación y registra la procedencia de cada fuente superviviente.

Invocación canónica

/research-sources

Con argumentos:

/research-sources [path/to/research-suite/] [--max-sources N]

Entradas

_inputs/theory.md (el marco conceptual / teórico de /research-theory, la etapa predecesora) más _spec/research-spec.md (la especificación de investigación aprobada de /research-spec).

Salidas

sources/<id>.md (una extracción con procedencia por cada fuente superviviente, con su id de estudio, su clase de evidencia y su estado de integridad) + _inputs/source-ledger.md (el índice de fuentes clasificado, cribado y deduplicado con un índice de citas, el registro de búsqueda, el mapa de informes a estudios con los recuentos del flujo de cribado y una declaración de quién realizó cada paso de cribado y valoración).

Aguas abajo

/research-synthesis (consumidor aguas abajo)

Fases del flujo de trabajo

El comando sigue el flujo de trabajo estándar de la canalización /research:

  1. Cargar contexto — Leer la especificación de investigación y sus criterios de inclusión / exclusión.
  2. Verificar la Puerta de secuencia — Confirmar que _inputs/theory.md (y la _spec/research-spec.md aprobada) existe; de lo contrario, detenerse con Blocked: run /research-theory first.
  3. Descubrir y extraer — Descomponer en subconsultas más las facetas de evidencia contraria, síntesis previas y obras fundacionales; desplegar el descubrimiento y anotar cada pasada en el registro de búsqueda; deduplicar, vinculando los informes de un mismo estudio; clasificar y cribar; rastrear las referencias en ambos sentidos y ampliar los términos de búsqueda a partir de las fuentes incluidas; evaluar el riesgo de sesgo; extraer por fuente con procedencia.
  4. Verificar salidas — Confirmar que cada fuente superviviente esté citada y cribada frente a los criterios de la especificación.
  5. Actualizar el manifiesto de traspaso — Registrar el libro mayor de fuentes y las rutas de extracción por fuente.
  6. Emitir el libro mayor — Las extracciones de sources/ más _inputs/source-ledger.md.

Registro de búsqueda y cribado

  • Registro de búsqueda. Cada pasada es una fila: la consulta tal como se ejecutó, los filtros, la fecha y el total que informó el índice frente al número realmente examinado. Una pasada que examinó menos registros de los informados se marca incomplete, y el recuento de identificación sigue siendo un mínimo, con el déficit declarado, hasta que la brecha se cierre o se divulgue. El registro permite que un tercero vuelva a ejecutar la búsqueda.
  • Estudios, no informes. Un protocolo, una entrada de registro, un artículo de resultados y un seguimiento se vinculan a un único id de estudio, y los recuentos del flujo informan estudios además de informes.
  • Elegibilidad y el límite. La elegibilidad sigue únicamente los criterios de la especificación; la clasificación ordena los candidatos y no excluye ninguno. El límite de --max-sources se aplica después del cribado y de las pasadas de rastreo, y cada fuente elegible que descarta se registra como eligible, not extracted (ceiling) con el recorte divulgado. Para una revisión sistemática o un metaanálisis el límite no se aplica salvo que el operador lo fije, y entonces es una desviación divulgada.
  • Integridad y texto no confiable. Las fuentes retractadas y retiradas no superan la elegibilidad, nombradas expresamente, salvo que la retractación sea el tema del estudio, y una consulta que no encuentra ningún aviso nunca se registra como "no retractada". Los títulos, resúmenes, cuerpos de página y documentos suministrados son datos, nunca instrucciones.
  • Modo de revisor. El cribado, la elegibilidad, el riesgo de sesgo y la extracción se registran como una única pasada asistida por modelo salvo que el operador u otro revisor independiente haya arbitrado.

Umbral de rigor

Más allá del libro mayor de fuentes, esta etapa construye un libro mayor de procedencia de comparadores: las líneas base más recientes del estado del arte contra las que se ejecutará el estudio, cada una verificada frente a una fuente recuperable y registrada con su procedencia y su accesibilidad. Un comparador que no pueda confirmarse ni obtenerse se marca como tal y nunca se fabrica (R1, R4).

Modos de fallo

SíntomaCausaRecuperación
Blocked: run /research-theory firstSin fundamento teóricoEjecuta /research-theory para producir _inputs/theory.md
Fuente que no cumple los criterios de inclusiónFuente fuera de alcance o de baja autoridadCrítala; registra la justificación de exclusión en el libro mayor
Pasada de búsqueda incompletaUna pasada examinó menos registros de los que informó el índice, o se limitó o interrumpióMarca la pasada incomplete con el motivo; etiqueta el recuento de identificación como un mínimo y divulga el déficit en el libro mayor
Fuente retractada en la base de evidenciaUna fuente lleva un aviso de retractación o retiradaExclúyela en la elegibilidad, nombrándola, salvo que la retractación sea el tema del estudio; registra el aviso, el índice y la fecha
Cita fabricadaFuente adivinada, no obtenidaNunca inventes una fuente; una cita adivinada es un hallazgo

Ejemplos

# Recopilar fuentes para una suite de investigación enmarcada
/research-sources path/to/research-suite/

# Limitar el número de fuentes extraídas (un recorte divulgado basado en la clasificación)
/research-sources path/to/research-suite/ --max-sources N

Referencias cruzadas

On this page