paper-writing — Procédure de brouillon d'article académique
Compétence qui organise la procédure de brouillon d'un position paper / preprint / article de revue selon les règles canoniques de l'orchestrateur paper-ecosystem.
Quand activer
- Rédiger un brouillon de papier pour les plateformes SSRN / arXiv / Zenodo / revue
- Extraire un papier à partir d'une série d'essais existants, d'ADR ou d'historique d'implémentation
- Passer à la rédaction de chaque section après validation du plan du position paper
- Réviser un preprint v1 → v2 (lorsqu'une réécriture significative est nécessaire)
Hors activation
- Blog post / essai (humain principal, informel) → utiliser
writing-ecosystem - llms.txt / FAQ (IA principal) → utiliser
llms-txt-writer - README / CHANGELOG (doc de projet) → écrire directement sans compétence
Checklist pré-rédaction
Avant de commencer le brouillon du papier, l'auteur doit avoir terminé ce qui suit :
1. Établir la liste des sources primaires
Lister les sources primaires que le papier va citer :
- Essais / billets de blog sources (URL + date + résumé d'une ligne)
- ADR / documents de spécification sources (chemin repo + version + résumé d'une ligne)
- Articles externes sources (Auteur ANNÉE + arXiv ID / DOI + résumé d'une ligne)
- Documents de normes / cadres sources (Organisme ANNÉE + ID de norme)
Chaque source primaire doit être accessible en lecture directe lors de la rédaction du brouillon (URL accessible, repo cloné, PDF téléchargé).
2. Éviter de se baser sur le glossaire / les résumés
Ne pas utiliser un glossaire / résumé / document secondaire du repo comme source de citation à la place de la source primaire. La dérive du document secondaire se propagerait au papier (détails : Règles de Fidélité aux Sources de la compétence paper-ecosystem).
Les documents secondaires sont utilisés uniquement pour :
- Vérifier la cohérence des définitions de termes (vérifier que la définition du papier correspond à celle du glossaire)
- Référence pour le format de la liste de références (exemple de style pour déterminer les champs à inclure)
3. Mappage 1:1 entre affirmation et source citée
Au stade du plan, écrire en une phrase l'affirmation centrale de chaque section, et lui associer une source citée en correspondance 1:1. Les affirmations dont le mappage est ambigu doivent être résolues avant d'entrer dans le brouillon.
Exemple de format :
§3 affirmation centrale : "L'échec de redirection a deux modes architecturalement distincts — le mode de principe (intrinsèque aux boucles autonomes) et le mode artificiel (tâche de workflow routée via des boucles autonomes)."
Sources citées :
- Essai 5 (zenn-content/articles-en/react-agent-business-quadrant-2.md, 2026-04-30)
- ADR-0009 §Contexte (agent-attribution-practice/docs/adr/0009-triage-before-autonomy.md)
- Elish (2019) "Moral Crumple Zones"
4. Préservation des sous-classifications
Lorsqu'une source primaire attribue une sous-forme / sous-cellule / sous-type à un concept, cela doit être explicité dans l'introduction du terme dans le papier. L'aplatissement constitue une dérive (détails : Règles de Cohérence du Vocabulaire de la compétence paper-ecosystem).
Modèle de section (position paper / preprint)
Structure standard en 9 sections :
- Page de titre — Titre + sous-titre + auteur + ORCID + version + dépôt compagnon + licence
- Résumé — 250-300 mots, structure en 3 paragraphes (ci-dessous)
- Introduction — Énoncé du problème + aperçu de la thèse + feuille de route des sections
- [Sections du corps] — Contribution centrale du papier. Environ 3 à 6 sections
- Relation avec les cadres existants — Court (1 paragraphe à 1 page), relations avec les cadres concurrents
- Conclusion — Reprise de la thèse + questions ouvertes
- Références — Simplifié style APA
- Remerciements (optionnel)
- Annexe (optionnel)
Pour un article de revue, ajuster la numérotation des sections, la hiérarchie des titres et la disposition des tableaux et figures selon le style maison de la revue.
Structure du résumé (250-300 mots)
3 paragraphes :
- Énoncé du problème (~70-90 mots) — Quel phénomène est abordé et ce qui manque dans le discours actuel
- Contributions (~120-150 mots) — Énoncer explicitement les 2-3 contributions centrales du papier. Pour chaque contribution, une phrase sur quoi, pourquoi et comment
- Conséquence (~60-90 mots) — Ce que la contribution apporte au public du papier, avec mention des questions ouvertes non résolues
Mots-clés (5-8) placés juste après le résumé.
Format des références (simplifié style APA)
| Type de source | Format |
|---|---|
| Article de revue | Auteur, A. B. (ANNÉE). Titre. *Nom de la revue* Vol(Numéro) : pages. |
| Prépublication arXiv | Auteur, A. B., & Auteur, C. D. (ANNÉE). *Titre.* arXiv:NNNN.NNNNN. |
| Article de conférence | Auteur, A. B. (ANNÉE). Titre. Dans *Titre des actes* (pages). Éditeur. |
| Document industriel / entreprise | Organisme. (ANNÉE). *Titre.* URL |
| Norme | Organisme. (ANNÉE). *ID de norme Titre.* Éditeur. |
| Dépôt / jeu de données | Auteur, A. B. (ANNÉE). *Titre (Version).* Plateforme. DOI |
Détails : Règles de Formatage des Citations de la compétence paper-ecosystem.
Convention multilingue (optionnelle)
Si une version en langue subordonnée (ex. traduction en japonais) est créée en parallèle :
- La version anglaise est la version principale, la version en langue subordonnée n'est pas la version de référence
- Nom de fichier :
<nom-papier>.md(anglais) +<nom-papier>.ja.md(japonais) - En cas de modification du contenu, la version anglaise vient en premier, la version en langue subordonnée est mise à jour progressivement
- Les termes techniques (Quadrant / Phase Separation / nom d'artefact, etc.) restent en anglais dans la version en langue subordonnée, ou sont accompagnés de l'anglais
Détails : Convention multilingue de la compétence paper-ecosystem.
Processus de rédaction (rédaction d'une section)
Procédure de brouillon pour chaque section :
- Rédiger l'affirmation de la section en une phrase (revérifier la sortie de la checklist pré-rédaction)
- L'ouverture de la section doit être concrète : exemple / phénomène connu / citation de la source citée, ne pas commencer par un cadrage abstrait
- Placer immédiatement après la preuve soutenant l'affirmation (1:1 avec la citation)
- Marquer la transition de section à la fin de la section : ce qui est transmis à la section suivante, ce qui est transféré comme hypothèse de la section actuelle
- Les paragraphes subordonnés doivent suivre soit une direction de décomposition de l'affirmation, soit une direction de traitement des contre-arguments / alternatives, pas les deux à la fois (le mélange affaiblit le flux)
Après avoir terminé le brouillon de chaque section, lancer en parallèle l'agent paper-reviewer + l'agent source-fidelity-checker + l'agent vocabulary-consistency-checker pour effectuer la révision (détails : organigramme Quand Utiliser Quoi de la compétence paper-ecosystem).
Contrôle qualité (avant dépôt)
Juste avant le dépôt, vérifier :
- Toutes les sections ont passé la révision par
paper-reviewer - Toutes les affirmations ont reçu un verdict ALIGNÉ ou PARTIEL (DRIFT n'est pas présent) de
source-fidelity-checker - Tous les termes ont passé la vérification de
vocabulary-consistency-checker(introduction de sous-classification explicite) -
citation-formatterrapporte 0 citation orpheline, correspondance 1:1 entre citations et références - Le nombre de mots du résumé se situe dans la plage standard de la plateforme
- Tous les DOI / arXiv ID / URL sont valides
- En cas de version multilingue, pas de divergence de contenu entre la version anglaise et les autres
Pour les dimensions détaillées, se référer aux 4 sections de règles canoniques de la compétence paper-ecosystem.
Liens connexes
- Compétence
paper-ecosystem— Source de référence pour la Fidélité aux Sources / la Cohérence du Vocabulaire / la Voix Académique / le Format des Citations. Orchestrateur sur lequel repose cette compétence - Agent
paper-reviewer— Révision de structure après le brouillon d'une section - Agent
source-fidelity-checker— Vérification de la correspondance citation-affirmation après le brouillon d'une section - Agent
vocabulary-consistency-checker— Vérification de la cohérence terminologique après le brouillon d'une section - Agent
citation-formatter— Contrôle final des citations et références avant dépôt - Compétence
writing-ecosystem— Pour les billets de blog / essais, utiliser celle-ci, pas la présente - Compétence
llms-txt-writer— Pour la documentation destinée à l'IA, utiliser celle-ci, pas la présente