Artefactos de Investigación
La investigación registra la evidencia externa detrás de una decisión: evaluaciones tecnológicas, comparaciones de bibliotecas, encuestas de prácticas de la industria. La investigación es fechada, con fuente y de solo añadidura — una instantánea de lo que la evidencia decía en un momento dado, no una opinión en evolución.
Este skill define cómo se organiza, formatea e indexa la investigación. El skill deep-research define cómo se recopila y verifica de forma cruzada; living-docs es propietario de las decisiones y los issues que alimenta. Los tres se componen. Los artefactos de investigación son conceptos OKF — consulte el skill okf-knowledge-format para las reglas de frontmatter/archivos reservados que se aplican aquí.
Uso de este skill (divulgación progresiva)
Este SKILL.md es un stub ligero — un disparador más un enrutador de tareas a temas. El CLI de living-docs contiene las reglas completas de investigación, disciplina de fuentes, estructura y cadena trazable, y las divulga de forma progresiva. Antes de redactar cualquier contenido, cargue el tema para su tarea:
living-docs guide --list— descubra cada tema.living-docs guide <topic> --skill research-artifacts— cargue ese tema.
La salida canalizada es JSON minificado (predeterminado de máquina); use --plain para texto legible por humanos, --json para forzar JSON. Temas: rules, structure, research-report, research-index, research-general-references, about.
Este stub es un enrutador puro (ADR 0017): dispara y apunta a temas — no contiene reglas en línea. La disciplina de fuentes y la cadena investigación → decisión → issue son temas que se cargan antes de redactar mediante guide rules --skill research-artifacts / guide structure --skill research-artifacts.
Cuándo invocar
- Grabar la salida de una sesión de investigación en
docs/research/—living-docs guide research-report --skill research-artifacts. - Estructurar o indexar una nota de investigación (
docs/research/NNNN-<slug>.md+ la entrada del índice + el resumen general) —living-docs guide research-index --skill research-artifacts/guide research-general-references --skill research-artifactspara las plantillas,guide structure --skill research-artifactspara las reglas de diseño. - Aplicar disciplina de fuentes en un borrador (fuentes primarias, banderas de COI de proveedores, etiquetas de inferencia vs. hecho, niveles de confianza, notas de fallo de obtención) —
living-docs guide rules --skill research-artifacts. - Conectar la cadena trazable investigación → decisión → issue (una recomendación aceptada debe llegar a un ADR y luego a issues, en
living-docs) —living-docs guide structure --skill research-artifacts.