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 :
- Surapprentissage thématique : une méthode distillée à partir d'un projet devient faussement considérée comme un cadre universel.
- 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 ».
- Dérive des preuves : les sources, les affirmations, l'incertitude et le jugement de l'auteur se confondent en un seul argument indifférencié.
- 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.
- 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 :
- Processus : calibrage du périmètre de recherche, exécution par étapes, traitement des sources, rédaction, révision, correction et nettoyage final.
- État : état de la tâche, progression, résultats, hypothèses, décisions et suivi de direction.
- 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é :
- Ontologies de domaine, taxonomies universelles ou langages de modélisation généralisés.
- Représentations intermédiaires, systèmes de notation, plongements, graphes de connaissances ou moteurs de classement.
- Tableaux de bord, interfaces en ligne de commande, bases de données, pipelines d'automatisation ou architecture de produit.
- 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
- 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.
- Porte du brief de recherche avant la collecte : posez un lot de clarifications compact lorsque des informations critiques pour la décision manquent.
- É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.
- 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.
- 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.
- Exécution par étapes : planifiez, collectez, analysez, rédigez, révisez, corrigez et mettez à jour l'état avant de passer à l'unité suivante.
- 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.
- 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.
- 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.
- 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 :
- Lisez
state/task_spec.mdpour l'objectif, le périmètre, le lecteur, la sortie, la profondeur, la norme de preuve et les hypothèses. - Lisez
state/progress.jsonpour l'étape actuelle, les unités achevées, les problèmes ouverts, stale_count et la prochaine action. - Lisez les dernières entrées dans
state/findings.jsonletstate/iteration_log.jsonlpour retrouver la direction récente. - Lisez
state/directions_tried.jsonpour éviter de répéter des chemins échoués ou épuisés. - 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 :
- 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.
- Ne collectez ou ne traitez que les sources nécessaires à cette étape.
- Convertissez les sources en affirmations, incertitudes et notes d'analyse.
- Rédigez une section ou une unité limitée.
- Révisez la section pour les preuves, la couverture, la structure, le scepticisme et la prose.
- Corrigez la section et les registres.
- 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 :
- La porte du brief de recherche a été franchie ou les hypothèses ont été enregistrées.
- La couverture requise est complète ou les limitations sont explicites.
- Les affirmations principales remontent à des sources ou à des enregistrements d'incertitude.
- Les faits, les affirmations de sources, les interprétations et les jugements de l'auteur restent distincts.
- Les contre-preuves ont été traitées.
- Le brouillon respecte le budget de profondeur ou explique explicitement pourquoi la profondeur attendue d'origine n'est plus appropriée.
- La révision par le lecteur a été effectuée après la révision factuelle, de couverture, de structure et de profondeur.
- La prose finale se lit comme le rapport d'un auteur, pas comme un rapport de processus d'agent.
Limites :
- Le framework réduit les erreurs de citation et de preuve ; il ne les élimine pas.
- La révision par sous-agent est une vérification, pas une vérité externe.
- Les lentilles optionnelles peuvent surajuster le rapport si utilisées mécaniquement.
- 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 :
- 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.jsonet rédigez ou pivotez. - Extraction d'affirmations : si
source_registry.csvcroît pendant queclaims_registry.csvreste mince, faites une pause dans la collecte et extrayez les affirmations avant de rassembler plus de sources. - 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.
- 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.
- 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. - 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 :
- 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.
- 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.
- 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.
- 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.
- 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.
- 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 :
- 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.
- 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.
- Arrêt d'affirmation :
source_registry.csvcroît pendant queclaims_registry.csvreste vide, générique ou déconnecté du brouillon. - 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...