Communitygithub.com

rrrrrredy/industry-research-framework

Cadre de recherche sectoriel : un framework agnostique pour la recherche sectorielle sourcée et la rédaction publiable.

Qu'est-ce que industry-research-framework ?

Ce framework est conçu pour les agents d'IA qui doivent produire des rapports de recherche sectorielle longs et de qualité publiable. Il résout cinq problèmes récurrents : le surapprentissage thématique, la fuite de processus, la dérive des preuves, la fausse complétude et l'effondrement de la profondeur. Le framework impose des conventions pour la persistance de l'état, la séparation des preuves et de la prose, l'évitement des dérives thématiques, la planification des révisions et la transformation d'un backend de recherche volumineux en un article ou rapport propre destiné aux lecteurs. Il est agnostique vis-à-vis des agents et ne fournit pas de scraper, de source de données ou de modèle de rapport fixe. Il est destiné à être utilisé avec des outils comme Claude Code, Cursor ou tout autre agent d'IA capable d'exécuter des tâches de recherche et de rédaction complexes. Le framework fonctionne via un ensemble de fichiers d'état, de registres et de boucles opérationnelles qui guident l'agent de la définition du brief à la finalisation du livrable, en incluant des garde-fous contre les boucles et les dérives de périmètre.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add rrrrrredy/industry-research-framework

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Cadre de recherche sectoriel

Cette compétence est un framework pour la recherche sectorielle de fond et la rédaction publiable. Elle ne fournit ni scraper, ni source de données, ni modèle de rapport fixe ; elle prescrit plutôt des conventions sur la façon dont un agent d'IA persiste l'état, sépare les preuves de la prose, évite la dérive thématique, planifie les révisions et transforme un important backend de recherche en un article ou rapport propre destiné aux lecteurs.

1. Motivation

Les agents de recherche de fond ont tendance à échouer de cinq manières récurrentes :

  1. Surapprentissage thématique : une méthode distillée à partir d'un projet devient faussement considérée comme un cadre universel.
  2. Fuite du processus : l'article final ressemble à un journal de travail, avec des phrases telles que « l'utilisateur a fourni » ou « le matériel montre ».
  3. Dérive des preuves : les sources, les affirmations, l'incertitude et le jugement de l'auteur se confondent en un seul argument indifférencié.
  4. Fausse complétude : un jalon partiel est présenté comme une réalisation finale avant que la couverture, la révision et la correction de la qualité de lecture soient effectuées.
  5. Effondrement de la profondeur : un rapport satisfait aux décomptes de sources et aux listes de contrôle de couverture, mais est trop court, compressé ou superficiel pour la profondeur de recherche attendue par l'utilisateur.

Chaque mécanisme de ce framework cible l'un de ces échecs.

2. Périmètre du contrat

Cette compétence est un framework d'exécution pour produire des livrables de recherche substantiels. Ce n'est pas un système théorique, une architecture de produit ou un langage de modélisation universel.

Garder à l'intérieur de cette compétence :

  1. Processus : calibrage du périmètre de recherche, exécution par étapes, traitement des sources, rédaction, révision, correction et nettoyage final.
  2. État : état de la tâche, progression, résultats, hypothèses, décisions et suivi de direction.
  3. Audit : source, affirmation, incertitude, couverture, profondeur et vérifications de la qualité de lecture.

Garder en dehors de cette compétence, sauf si l'utilisateur demande explicitement un projet de conception système séparé :

  1. Ontologies de domaine, taxonomies universelles ou langages de modélisation généralisés.
  2. Représentations intermédiaires, systèmes de notation, plongements, graphes de connaissances ou moteurs de classement.
  3. Tableaux de bord, interfaces en ligne de commande, bases de données, pipelines d'automatisation ou architecture de produit.
  4. Manifestes de méthodologie qui n'améliorent pas directement le livrable de recherche actuel.

Si une tâche commence à dériver vers les couches exclues, préservez le chemin du livrable actuel, enregistrez l'idée comme une extension future et n'étendez pas le flux de travail.

3. Contraintes comportementales

  1. Livrable d'abord : si la sortie demandée est un article ou un rapport, ne dérivez pas vers la conception système, la conception de prompt ou l'exposition du flux de travail.
  2. Porte du brief de recherche avant la collecte : posez un lot de clarifications compact lorsque des informations critiques pour la décision manquent.
  3. État avant l'échelle : pour les tâches longues, écrivez l'état de la tâche dans des fichiers avant d'étendre la collecte de sources.
  4. Les preuves ne sont pas de la prose : les registres, les journaux, les étiquettes d'audit et les échecs d'accès restent en coulisses, sauf si l'utilisateur demande une annexe d'audit.
  5. Budget de profondeur avant la rédaction : enregistrez la profondeur attendue, la fourchette de longueur approximative, le plan d'expansion par unité et ce que « trop court » signifierait pour cette tâche.
  6. Exécution par étapes : planifiez, collectez, analysez, rédigez, révisez, corrigez et mettez à jour l'état avant de passer à l'unité suivante.
  7. Progression par section : rédigez un travail complexe par section, entreprise, cas, période ou argument ; ne générez pas l'intégralité du rapport en une seule passe.
  8. Lentilles optionnelles uniquement : l'analyse de cadrage/catégorisation, l'analyse horizontale-verticale, l'analyse du capital et l'analyse de l'adoption sont des outils, pas une structure par défaut.
  9. La révision boucle la boucle : chaque constat d'audit doit devenir une action de correction, une affirmation déclassée ou une limitation explicite.
  10. La révision par le lecteur vient en dernier : n'améliorez la lisibilité qu'après que les vérifications factuelles, de couverture, de structure et de profondeur soient stables.

4. Architecture

Agent principal
possède la thèse, la structure, le jugement final

Backend de recherche       Frontend de publication
fichiers d'état            thèse / sections
registre des sources       mécanismes / synthèse
registre des affirmations  contre-preuves
liste d'incertitudes       références destinées aux lecteurs
journaux de révision       nettoyage final de la prose

Les sous-agents peuvent inspecter ou contester des parties limitées du backend, mais l'agent principal possède l'argumentation et la prose finale.

5. Fichiers d'état

Pour un travail substantiel, créez :

{tâche}/state/
  task_spec.md            # objectif, lecteur, sortie, périmètre, profondeur, norme de preuve, hypothèses
  progress.json           # étape, unités achevées, problèmes ouverts, stale_count
  findings.jsonl          # résultats et jugements ajoutés uniquement
  directions_tried.json   # directions déjà tentées
  iteration_log.jsonl     # résumés d'étape

{tâche}/logs/
  work.jsonl              # décisions d'exécution
  review.jsonl            # résultats de révision et corrections acheminées

{tâche}/data/
  source_registry.csv
  claims_registry.csv
  uncertainty_registry.csv

Utilisez les fichiers d'état pour récupérer après une perte de contexte. Ne comptez pas sur l'historique de chat comme seule mémoire.

Protocole de récupération de contexte

Lors de la reprise après une perte de contexte, un redémarrage de session ou un transfert :

  1. Lisez state/task_spec.md pour l'objectif, le périmètre, le lecteur, la sortie, la profondeur, la norme de preuve et les hypothèses.
  2. Lisez state/progress.json pour l'étape actuelle, les unités achevées, les problèmes ouverts, stale_count et la prochaine action.
  3. Lisez les dernières entrées dans state/findings.jsonl et state/iteration_log.jsonl pour retrouver la direction récente.
  4. Lisez state/directions_tried.json pour éviter de répéter des chemins échoués ou épuisés.
  5. Reprenez à l'étape correspondante dans la boucle opérationnelle.

Ne réexécutez pas les étapes terminées. Ne redemandez pas le brief de recherche si task_spec.md enregistre déjà les réponses.

6. Porte du brief de recherche

Avant la collecte, décidez si la demande contient suffisamment d'informations critiques pour la décision. Sinon, posez un lot de questions compact avant de commencer. Le lot doit généralement contenir 3 à 7 questions et doit couvrir la longueur ou la profondeur attendue lorsqu'elle est absente.

Ne demandez que les informations critiques manquantes :

  • objet de recherche et limites du périmètre
  • lecteur cible et contexte décisionnel
  • format de sortie, langue et contexte de publication
  • profondeur attendue, fourchette de longueur approximative ou niveau de profondeur
  • unités à couvrir, exclusions et domaines prioritaires
  • sources ou matériels requis, exclusions de sources et norme de preuve
  • période, zone géographique, date limite et si des graphiques/tableaux sont attendus

Si l'utilisateur a déjà fourni suffisamment de contexte, ne posez pas de questions rituelles. Procédez, enregistrez les hypothèses dans task_spec.md et marquez les détails non critiques non résolus comme hypothèses ou incertitudes.

Si des détails critiques restent sans réponse après un lot de clarification, faites des hypothèses conservatrices, enregistrez-les et commencez par une étape 1 limitée au lieu de stagner.

7. Boucle opérationnelle

Pour chaque étape :

  1. Exécutez la porte du brief de recherche, puis planifiez le périmètre, les entrées, la sortie et les critères de fin.
  2. Ne collectez ou ne traitez que les sources nécessaires à cette étape.
  3. Convertissez les sources en affirmations, incertitudes et notes d'analyse.
  4. Rédigez une section ou une unité limitée.
  5. Révisez la section pour les preuves, la couverture, la structure, le scepticisme et la prose.
  6. Corrigez la section et les registres.
  7. Mettez à jour la progression et définissez l'étape suivante.

Si un cycle n'ajoute aucune nouvelle preuve, aucun nouveau cas, contre-exemple, framework ou jugement, incrémentez stale_count. Si stale_count >= 2, changez l'angle structurel plutôt que de simplement chercher plus fort.

Pour les livrables longs, n'utilisez pas le nombre de sources, le nombre d'affirmations, le nombre de liens ou la taille du fichier comme substituts d'achèvement. Ce sont des signaux de santé du backend, pas une preuve que le rapport fini a suffisamment de profondeur. Avant l'assemblage final, comparez le brouillon avec le budget de profondeur et développez les unités faibles avant la révision par le lecteur.

8. Discipline des sources et des affirmations

Classez les sources par ce qu'elles peuvent prouver :

  • les documents officiels montrent la position déclarée, l'intention, la surface du produit ou la politique formelle
  • les données primaires soutiennent des affirmations mesurables lorsque les définitions et les méthodes de collecte sont claires
  • les documents d'experts expliquent le raisonnement, le contexte et l'interprétation
  • les documents médiatiques montrent un cadrage public mais nécessitent une corroboration pour les faits durs
  • les preuves d'utilisateurs/communautés montrent la réception mais ne sont pas automatiquement représentatives
  • les contre-preuves limitent, affaiblissent ou falsifient l'affirmation principale

Classez les affirmations séparément :

  • fait vérifié
  • affirmation de source
  • interprétation
  • jugement d'auteur
  • spéculation

Chaque affirmation dure importante devrait avoir une limite de confiance. Ne transformez pas les relations publiques d'entreprise, les espoirs des investisseurs ou l'amplification médiatique en fait.

9. Planification des lentilles d'analyse

Choisissez la lentille qui correspond à la question de recherche :

  • analyse de cadrage/catégorisation : positionnement, légitimité, création de catégorie, signification publique et traduction médiatique
  • analyse horizontale-verticale : profondeur temporelle plus comparaison actuelle des concurrents/substituts
  • analyse d'adoption : comportement des utilisateurs, changement de flux de travail, remplacement, friction
  • analyse du capital : prix, revenus, valorisation, financement, structure de coûts, marges
  • analyse de l'organisation/talents : modèle opérationnel, embauche, leadership, flux de talents
  • analyse de la politique/légitimité : réglementation, conformité, confiance, pression géopolitique ou institutionnelle
  • analyse du contre-cas : l'explication alternative la plus forte et les modes de défaillance

Choisissez une lentille principale et au plus deux lentilles secondaires, sauf si l'utilisateur demande explicitement un rapport multi-méthodes.

Lisez references/optional-analysis-lenses.md lors du choix des lentilles. Ne lisez references/horizontal-vertical-analysis.md qu'après avoir sélectionné cette lentille.

10. Planification des sous-agents

N'utilisez les sous-agents que pour un travail limité :

  • cartographie des exigences
  • découverte de sources pour des régions, acteurs ou classes de sources séparés
  • vérification des chaînes de preuves
  • audit de couverture
  • révision sceptique
  • révision de structure
  • révision de la qualité de lecture après que le brouillon est stable

Un prompt de sous-agent doit inclure l'objectif, les fichiers ou sections à inspecter, le format de sortie, les critères RÉUSSITE/ÉCHEC et les limites. Les sous-agents ne doivent pas réécrire l'intégralité du rapport ni posséder la thèse.

Lisez references/subagents-and-review-loop.md avant la délégation.

11. Finalisation

L'article ou rapport final ne doit contenir que du matériel destiné aux lecteurs :

  • informations en premier lieu lorsque cela est utile
  • note de périmètre
  • sections analytiques organisées par argument, cas, période ou mécanisme
  • synthèse entre les unités
  • contre-preuves et incertitudes exprimées clairement
  • implications
  • annexe de références destinée aux lecteurs

Supprimez :

  • les identifiants de source visibles
  • les étiquettes d'audit
  • les chemins de fichiers
  • « l'utilisateur a fourni »
  • « le matériel montre »
  • « cette source complète »
  • « cette section a passé l'audit »
  • les avertissements excessifs qui affaiblissent plutôt que clarifient le jugement

12. Validation et limites

Avant de déclarer l'achèvement :

  1. La porte du brief de recherche a été franchie ou les hypothèses ont été enregistrées.
  2. La couverture requise est complète ou les limitations sont explicites.
  3. Les affirmations principales remontent à des sources ou à des enregistrements d'incertitude.
  4. Les faits, les affirmations de sources, les interprétations et les jugements de l'auteur restent distincts.
  5. Les contre-preuves ont été traitées.
  6. Le brouillon respecte le budget de profondeur ou explique explicitement pourquoi la profondeur attendue d'origine n'est plus appropriée.
  7. La révision par le lecteur a été effectuée après la révision factuelle, de couverture, de structure et de profondeur.
  8. La prose finale se lit comme le rapport d'un auteur, pas comme un rapport de processus d'agent.

Limites :

  1. Le framework réduit les erreurs de citation et de preuve ; il ne les élimine pas.
  2. La révision par sous-agent est une vérification, pas une vérité externe.
  3. Les lentilles optionnelles peuvent surajuster le rapport si utilisées mécaniquement.
  4. Les fichiers d'état aident à la récupération, mais ils ne fonctionnent que s'ils sont mis à jour pendant la tâche, pas reconstruits après coup.

13. Garde-fous d'exécution

Utilisez ces garde-fous pour éviter les boucles, la sur-collecte et la dérive de périmètre :

  1. Collecte de sources : si trois recherches ou passages de sources consécutifs n'ajoutent aucune preuve pertinente, arrêtez la collecte dans cette direction, mettez à jour directions_tried.json et rédigez ou pivotez.
  2. Extraction d'affirmations : si source_registry.csv croît pendant que claims_registry.csv reste mince, faites une pause dans la collecte et extrayez les affirmations avant de rassembler plus de sources.
  3. Boucle de révision : limitez les cycles complets de révision-correction à deux par section, sauf si l'utilisateur en demande plus ; enregistrez les problèmes non résolus comme limitations ou tâches de suivi.
  4. Vérification de profondeur : avant la révision par le lecteur, comparez le brouillon avec le budget de profondeur et développez les unités faibles avant d'optimiser la prose.
  5. Expansion du périmètre : si un nouveau travail tombe en dehors de task_spec.md, enregistrez-le comme une extension proposée et demandez avant d'étendre le projet.
  6. Révision par sous-agent : les prompts doivent demander au réviseur de rechercher activement des problèmes ; si aucun problème n'est trouvé, le réviseur doit indiquer quelles preuves soutiennent la RÉUSSITE.

14. Pièges

Surveillez ces schémas de défaillance récurrents :

  1. Théâtre de registre : les registres de sources et d'affirmations semblent complets, mais la prose finale ne synthétise pas les mécanismes ou les compromis.
  2. Prose de liste de sources : les paragraphes répètent « la source X dit Y » au lieu de transformer les preuves en jugement destiné au lecteur.
  3. Polissage prématuré du lecteur : le nettoyage de la prose commence avant que les vérifications de couverture, de preuves, de structure et de profondeur ne soient stables.
  4. Dépassement de lentille : une lentille optionnelle devient l'intégralité du rapport même lorsque la question de l'utilisateur nécessite une structure plus simple.
  5. Expansion du sous-agent : on demande aux réviseurs ou collecteurs de posséder la thèse, de réécrire l'intégralité du rapport ou d'étendre le périmètre.
  6. Substitution de profondeur : le nombre de liens, la taille du fichier ou la couverture de la liste de contrôle sont traités comme une preuve que le rapport est assez profond.

Lisez references/gotchas.md lors du diagnostic de dérive répétée, de l'amélioration des évaluations ou de l'adaptation du framework à un nouvel agent.

15. Arrêts durs

Arrêtez le chemin actuel et réparez l'état avant de continuer lorsqu'un de ces éléments se produit :

  1. Arrêt de brief : une tâche de recherche substantielle manque de lecteur, de périmètre, de forme de sortie, de norme de preuve ou de budget de profondeur après la porte de clarification.
  2. Arrêt de preuve : trois recherches ou passages de sources consécutifs n'ajoutent aucune nouvelle preuve pertinente, aucun nouveau cas, contre-exemple ou jugement.
  3. Arrêt d'affirmation : source_registry.csv croît pendant que claims_registry.csv reste vide, générique ou déconnecté du brouillon.
  4. Arrêt de brouillon : la prose finale contient encore un langage de processus, des identifiants de source internes, des étiquettes d'audit, des chemins de fichiers...

Skills associés