Que fait Itérer Projet de Recherche ?
Utilisez cette compétence pour garder un projet de recherche honnête à mesure qu'il évolue. L'habitude principale est : classer le travail, écrire à l'endroit durable le plus étroit, enregistrer les preuves, puis synchroniser uniquement les résumés et le tableau de bord dont les collaborateurs ont besoin.
Deux règles s'appliquent à tout :
- Markdown d'abord, tableau de bord ensuite. Mettez d'abord à jour le markdown source ou la note
_ai. Ensuite seulement, synchronisezPROJECT_BOARD.html. - Le tableau de bord est une carte, pas un journal.
PROJECT_BOARD.htmlmontre l'état actuel et pointe vers les preuves. Il ne stocke jamais de journaux bruts, de données privées ou de chemins absolus.
Et une habitude qui guide l'itération : nouvelle idée → nouveau sous-projet. Les tentatives d'expérimentation sont le cœur du travail. Lorsqu'il y a quelque chose à essayer, créez un nouveau dossier 0-Project/<date>_<slug>/ et itérez à l'intérieur plutôt que d'écraser ou de réitérer sans cesse une seule tentative. Gardez les sous-projets petits et à usage unique ; ne craignez pas la duplication. Cela conserve un historique append-only et comparable (voir references/project-iteration-system.md).
Les sous-projets ont également des voies :
- Ligne principale — les tentatives actuelles qui définissent la voie active.
- Garé — idées de tentatives futures capturées tôt (car la pensée de recherche n'est pas entièrement séquentielle), mais pas encore exécutées. Note par défaut :
0-Project/_parking-lot.md. - Archivé — tentatives abandonnées ou remplacées, conservées avec une raison d'arrêt et des preuves. Dossier par défaut :
0-Project/_archive/.
Garez à moindre coût. Une idée future peut être une courte entrée dans _ai/task_plan.md, 1-Docs/, ou 0-Project/_parking-lot.md ; créez un dossier de tentative complet uniquement lorsque l'idée a suffisamment d'entrées, de critères ou de valeur de transfert.
Acheminez les discussions et les tentatives séparément : les discussions, décisions, comparaisons et explications de méthodes vont dans 1-Docs/<date>_<topic>.md ; les essais concrets avec entrées, critères, sorties ou résultats vont dans 0-Project/<date>_<slug>/ ; les discussions propres à une tentative vont dans 0-Project/<attempt>/docs/<date>_<topic>.md.
Autonome ou dans un portefeuille. Cette compétence est autonome : utilisez-la seule pour un projet unique à n'importe quel chemin — aucun portefeuille requis. Tout ce dont le projet a besoin (dossiers, fichiers d'entrée, tableau de bord, mémoire de travail, politique git) vit à l'intérieur du dossier du projet. En option, lorsque le projet se trouve dans un portefeuille (<slug>-project/<project>/), synchronisez l'état, le propriétaire, la priorité et l'état public vers le tableau de bord du portefeuille avec la compétence manage-research-portfolio. Lorsque vous fonctionnez en mode autonome, sautez toutes les étapes de « tableau de bord du portefeuille » et de « registre » dans cette compétence — ce sont des intégrations facultatives, jamais des prérequis.
Contrat du Projet
Utilisez cette structure, sauf si le projet a déjà des noms équivalents. C'est le squelette _PROJECT_TEMPLATE copiable.
<projet>/
├── README.md entrée : objectif en une phrase, plan des dossiers, démarrage rapide, statut actuel
├── PROJECT_GUIDELINES.md règles de synchronisation locales, limites des dossiers, classification HTML
├── PROJECT_BOARD.html le tableau de bord (看板) : carte de l'état actuel et navigation
├── GIT_WORKFLOW.md identité git + politique de commit par changement pour ce projet
├── scripts/
│ └── init_project_git.sh aide facultatif pour définir l'identité et le premier commit
├── 0-Project/ tentatives / expériences concrètes (un `0-Project/<date>_<slug>/` par tentative)
├── 1-Docs/
│ └── README.md l'entrée Docs unique fixe + index des sujets
├── 2-Data/
│ └── DATA.md source, provenance, autorisations, versions, schéma, QC, limites
├── 3-Paper_Survey/
│ └── README.md file de lecture, notes sur les articles, matrice de preuves, sources de méthodes
├── 4-Skills/
│ └── PROJECT_SKILLS.md invites locales, règles IA, procédures réutilisables
└── _ai/
├── project_overview.md objectif, portée, statut, propriétaire, priorité, suite
├── project_board_spec.md comment `PROJECT_BOARD.html` est généré/synchronisé à partir des sources
├── task_plan.md phase actuelle, plan, bloqueurs, suite
├── findings.md résultats stables, questions ouvertes
└── progress.md synchronisation la plus récente et significative, actions, validation, commit
Les fichiers racine sont : entrée + règles + tableau de bord + politique git. Tout ce qui est concret va dans le dossier numéroté le plus correspondant ; n'empilez jamais de matériel à la racine du projet, et ne mettez jamais l'aperçu du projet, les règles du tableau de bord ou les lignes directrices à long terme dans 0-Project/ (ce dossier est réservé aux tentatives concrètes).
Classifier Avant d'Écrire
Lorsque l'utilisateur donne un nouveau matériel, choisissez un emplacement d'atterrissage, puis décidez si le tableau de bord change.
| Intention de l'utilisateur | Emplacement d'atterrissage | Vue du tableau de bord qu'il peut toucher |
|---|---|---|
| « C'est une discussion / méthode / décision / comparaison » | 1-Docs/<date>_<topic>.md + mettre à jour 1-Docs/README.md | Carte des Docs (文档地图) |
| « C'est une expérience / tentative concrète » | 0-Project/<date>_<slug>/ ; mettre les notes locales sous docs/ | Tâches (任务尝试) |
| « C'est une note sur une tentative existante » | 0-Project/<attempt>/docs/<date>_<topic>.md | généralement Tâches, parfois Carte des Docs si cela modifie l'index du projet |
| « C'est une idée de tentative future » | _ai/task_plan.md, 1-Docs/, ou 0-Project/_parking-lot.md ; dossier complet uniquement si concret | généralement aucune, ou une voie Tâches garée |
| « Cette tentative est abandonnée / remplacée » | gardez le dossier de tentative ou déplacez-le sous 0-Project/_archive/ ; marquez comme archivé avec la raison d'arrêt, les preuves et le remplacement | voie Tâches archivée/pliée |
| « Ce sont des informations de données / benchmark » | 2-Data/DATA.md | Matériaux (数据材料) |
| « C'est un article / une source externe / une preuve » | 3-Paper_Survey/README.md + matrice de preuves | Références (参考文献) |
| « C'est un workflow / une invite / une règle IA réutilisable » | 4-Skills/PROJECT_SKILLS.md | (généralement aucune) |
| « Cela change le statut / la prochaine action / le bloqueur » | _ai/project_overview.md, _ai/task_plan.md | Aperçu supérieur + Progrès (项目进度) |
Si la classification modifie la portée du projet, les critères d'évaluation, les limites des données, l'exposition publique ou l'appartenance d'une tentative au projet, demandez avant de la traiter comme confirmée. Pour les nominations/mises en forme à faible risque, choisissez l'option conservatrice et enregistrez l'hypothèse dans _ai/progress.md.
Le Tableau de Bord (看板)
PROJECT_BOARD.html est le tableau de bord du projet unique. Il répond en un coup d'œil : quel est ce projet, quel est l'état actuel, qu'est-ce qui a changé, où sont les preuves et par où continuer. Il est coordonné avec les dossiers — chaque vue est alimentée par un dossier ou fichier _ai spécifique.
Éléments de base :
-
Lien d'accueil / retour (persistant) : un lien tout en haut de la page, dans la zone de marque en haut à gauche. Dans un portefeuille, faites-en un lien « Retour au tableau de bord » pointant vers la racine du site
/; en mode autonome, soit omettez-le, soit faites-le pointer vers leREADME.mddu projet. Préservez ce que vous choisissez lors de la création, de la copie, de la publication ou de la mise à jour de la page. -
Statut de version : version de la page
YYYY-MM-DD-vNet marqueur de dernière synchronisation (optionnellement un contrôle d'actualisation/rafraîchissement). -
Aperçu supérieur (toujours visible, léger) : nom du projet, description en une phrase, statut, propriétaire, synchronisation récente, focus actuel et au plus une ligne de progrès courte. Source :
_ai/project_overview.md. Ne mettez pas de listes de phases, de cartes de version, de listes de tentatives ou de routes à long terme ici. -
Cinq vues mutuellement exclusives, chacune mappée à un dossier :
Vue Alimentée par Montre Progrès (项目进度) _ai/progress.md,_ai/findings.md,1-Docs/README.mdchangements majeurs au niveau du projet uniquement : objectif, portée, phase, résultat clé, jugement, état public, résumé compact des versions Carte des Docs (文档地图) 1-Docs/README.md+ structure racineindex des sujets des docs + arbre de structure de type VS Code Explorer (fichiers/dossiers de niveau 1 racine et niveau 2 via <details>/<summary>), noms sûrs pour le public uniquementTâches (任务尝试) 0-Project/<attempt>/tentatives de la ligne principale en premier ; tentatives futures garées et tentatives archivées/dépréciées uniquement dans des voies pliées séparées Matériaux (数据材料) 2-Data/DATA.mdblocs de données, publicité, version, qualité, limites d'utilisation Références (参考文献) 3-Paper_Survey/README.mdarticles, sources de méthodes, état des preuves, impact ; uniquement s'il y a du contenu
Règles du tableau de bord : n'inventez pas de propriétaires, de statut, de priorité ou de phases futures ; n'ajoutez pas de vue « prochaine étape » autonome (la prochaine action se trouve dans l'aperçu supérieur, _ai/task_plan.md ou une tentative) ; utilisez <details> plié pour les tentatives et l'arbre de structure ; gardez-le comme un établi de recherche calme, pas une page d'accueil. Les idées futures et les tentatives abandonnées ne doivent pas concurrencer visuellement la voie active. Les règles de génération se trouvent dans _ai/project_board_spec.md. Voir references/project-board.md pour le contrat complet.
Boucle d'Itération
- Restaurez le contexte à partir de
_ai/project_overview.md,_ai/project_board_spec.md,_ai/task_plan.md,_ai/findings.md,_ai/progress.mdet du README du dossier pertinent. - Confirmez l'identité Git de l'opérateur avant de modifier les fichiers du projet ; si elle est manquante, demandez à l'utilisateur de configurer la sienne et faites une pause.
- Nommez l'itération actuelle en une phrase : question, tentative ou décision.
- Créez ou mettez à jour le fichier source le plus étroit en premier.
- Enregistrez les résultats qui changent la direction dans
_ai/findings.md; enregistrez les actions, les validations et les chemins échoués dans_ai/progress.md. - Mettez à jour
_ai/task_plan.mdlorsque la phase, le bloqueur ou la prochaine action change. - Avant la compression du contexte, après avoir terminé une petite étape, ou avant de changer de sujet/sous-projet, écrivez un transfert compact dans le fichier Markdown correspondant le plus étroit.
- Appliquez l'Échelle de Synchronisation pour décider s'il faut toucher à
PROJECT_BOARD.html, puis validez les fichiers modifiés sûrs avec des chemins explicites.
Compression du Contexte et Hygiène des Transferts
Écrivez le contexte de manière proactive avant que la conversation ne devienne coûteuse à transporter. Faites-le lorsque la fenêtre de contexte devient grande, qu'une petite étape se termine, qu'un sous-projet atteint un point de décision, ou que la prochaine action va passer à un autre sujet, projet ou tentative.
Choisissez l'emplacement le plus étroit :
| Situation | Emplacement du transfert |
|---|---|
| Discussion, décision ou note de méthode au niveau du projet | 1-Docs/<date>_<topic>.md |
| Étape, observation ou discussion locale au niveau de la tentative | 0-Project/<attempt>/docs/<date>_<topic>.md |
| Statut du projet, bloqueur, prochaine action ou résumé de validation | _ai/progress.md, _ai/findings.md, _ai/task_plan.md |
| Contexte inter-projets ou de portefeuille | le <slug>-ai/<date>_<topic>.md du portefeuille s'il existe |
Champs minimum du transfert : objectif actuel, étape terminée, décisions clés, chemins de preuves, questions non résolues, prochaine action et si une synchronisation du tableau de bord est nécessaire. Gardez cela compact ; ne collez pas de transcriptions complètes ou de journaux bruts.
Échelle de Synchronisation
Évaluez chaque changement par rapport à cette échelle avant de modifier le tableau de bord.
| Niveau | Déclencheur | Mise à jour |
|---|---|---|
| 0 | Exploration en lecture seule, aucune nouvelle décision | Rien |
| 1 | Résultat mineur, petite branche échouée, note temporaire | Markdown ou _ai uniquement |
| 2 | Nouvel artéfact/chemin/résultat QC, bloqueur, prochaine action, statut, carte des docs, arbre de structure, limite de données, référence, ou tentative modifiée | Markdown source ou _ai, puis synchronisez PROJECT_BOARD.html |
| 3 | Phase, jalon, revendication publique, propriétaire, priorité ou état public modifiés | Markdown source, tableau de bord, PROJECT_GUIDELINES.md, et — uniquement si le projet appartient à un portefeuille — le tableau de bord du portefeuille |
Les notes de transfert de contexte sont généralement de niveau 1. Élevez-les au niveau 2 uniquement lorsqu'elles modifient la prochaine action, le statut, le bloqueur, la carte des docs, la limite des données, l'état des références ou l'état d'une tentative.
Ne synchronisez pas le tableau de bord à chaque modification. Synchronisez lorsqu'un collaborateur aurait besoin du nouvel état.
Enregistrements des Sous-Projets
Chaque 0-Project/<date>_<slug>/README.md doit répondre : quelle question la tentative teste ; quelles entrées, articles, notes de données ou hypothèses elle utilise ; ce qui a été exécuté ou raisonné (objectif, hypothèse, entrées, commande, métriques) ; ce qui a échoué, changé ou s'est stabilisé ; la conclusion et la prochaine action ; et si cela affecte le statut du projet, les notes de données, les notes de littérature ou le tableau de bord. Mettez les discussions propres à la tentative, les transferts d'étape et les notes de conception dans le dossier docs/ de cette tentative.
Enregistrez les tentatives échouées. Un chemin échoué avec une raison claire est un atout utile pour le projet. Si elle est abandonnée ou remplacée, marquez-la comme archivée avec la raison d'arrêt, le remplacement éventuel, la dernière preuve et ce qu'il ne faut pas répéter ; montrez-la dans le tableau de bord uniquement comme un élément plié secondaire une fois qu'elle atteint une phase stable ou un point de décision.
Données et Littérature
- Utilisez
2-Data/DATA.mdpour la provenance, les versions, la classe d'accès, les emplacements autorisés, le schéma, le QC et les limites des artefacts dérivés. Gardez les données dérivées du projet (caractéristiques, trajectoires, tables prêtes à l'analyse, intermédiaires QC) sous le dossier2-Data/de ce projet, pas dans la zone de données globale. N'écrivez jamais d'enregistrements sensibles bruts, d'exemples portant une identité, d'identifiants ou d'extraits non publiés dans les notes, le tableau de bord ou les copies publiques. - Utilisez
3-Paper_Survey/README.mdpour les preuves qui peuvent modifier les méthodes, l'évaluation, la portée ou l'interprétation. Résumez les articles par problème, méthode, données ou benchmark, résultat, limitation et implication pour ce projet. Utilisez une matrice de preuves lorsque plusieurs sources portent sur une même affirmation. Privilégiez une paraphrase concise et des liens plutôt que de longues citations.
Références
- Lisez
references/project-iteration-system.mdlors de la création de la structure du projet, des fichiers d'entrée, des sous-projets, des fichiers de mémoire de travail ou des règles de synchronisation. - Lisez
references/project-board.mdlors de la création, de la révision ou de la synchronisation dePROJECT_BOARD.html. - Lisez
references/data-and-literature.mdavant de traiter les notes de données, la provenance des benchmarks, les résumés de littérature ou les mises à jour de preuves à décision.