Artefacts de Recherche
La recherche enregistre les preuves externes derrière une décision : évaluations de technologies, comparaisons de bibliothèques, enquêtes sur les pratiques industrielles. La recherche est datée, sourcée et en ajout seul — un instantané de ce que les preuves disaient à un moment donné, pas une opinion évolutive.
Ce skill définit comment la recherche est organisée, formatée et indexée. Le skill deep-research définit comment elle est collectée et vérifiée ; living-docs possède les décisions et les issues qu'elle alimente. Les trois se composent. Les artefacts de recherche sont des concepts OKF — voir le skill okf-knowledge-format pour les règles de frontmatter/fichiers réservés appliquées ici.
Utilisation de ce skill (divulgation progressive)
Ce SKILL.md est un stub minimal — un déclencheur et un routeur tâche->sujet. Le CLI living-docs contient les règles de recherche complètes, la discipline des sources, la structure et la chaîne traçable, et les divulgue progressivement. Avant de rédiger quoi que ce soit, chargez le sujet correspondant à votre tâche :
living-docs guide --list— découvrez tous les sujets.living-docs guide <sujet> --skill research-artifacts— chargez ce sujet.
La sortie redirigée est minifiée en JSON (par défaut pour machine) ; --plain pour du texte lisible, --json pour forcer le JSON. Sujets : rules, structure, research-report, research-index, research-general-references, about.
Ce stub est un pur routeur (ADR 0017) : il déclenche et pointe vers les sujets — il ne contient aucune règle en ligne. La discipline des sources et la chaîne recherche → décision → issue sont des sujets, chargés avant la rédaction via guide rules --skill research-artifacts / guide structure --skill research-artifacts.
Quand invoquer
- Enregistrer la sortie d'une session de recherche dans
docs/research/—living-docs guide research-report --skill research-artifacts. - Structurer ou indexer une note de recherche (
docs/research/NNNN-<slug>.md+ la liste d'index + le regroupement général) —living-docs guide research-index --skill research-artifacts/guide research-general-references --skill research-artifactspour les templates,guide structure --skill research-artifactspour les règles de mise en page. - Appliquer la discipline des sources sur un brouillon (sources primaires, drapeaux conflit d'intérêts vendeur, étiquettes inférence/fait, niveaux de confiance, notes d'échec de récupération) —
living-docs guide rules --skill research-artifacts. - Mettre en place la chaîne traçable recherche → décision → issue (une recommandation acceptée doit atteindre une ADR puis des issues, dans
living-docs) —living-docs guide structure --skill research-artifacts.