Développer un sujet
Transformer un sujet candidat en un contrat de contenu approuvé. Le travail est prêt pour la rédaction uniquement lorsque l'argumentation, les preuves et les limites n'ont plus besoin d'être inventées en aval.
Périmètre
Partez d'un sujet candidat ou d'un petit ensemble naturellement délimité. Lorsque plusieurs directions proches subsistent, comparez-les légèrement en termes de valeur pour le public, de nouveauté, de vérifiabilité, de démontrabilité, d'adéquation avec l'auteur et de risque de surengagement ; demandez à l'utilisateur de choisir avant une recherche approfondie. L'analyse exploratoire de tendances et la gestion d'un backlog d'idées restent en dehors de ce skill.
Espace de travail des preuves
Créez un répertoire content/ dans le projet vidéo :
content/
|-- RESEARCH.md
|-- TOPIC.md
`-- experiments/
Utilisez RESEARCH.md pour les faits sourcés, les interprétations, les désaccords, les inconnues, les directions rejetées et les liens vers le matériel source. Séparez la collecte de la sélection éditoriale.
Considérez une affirmation comme matérielle lorsqu'elle affecte si le sujet fonctionne, importe au public, diffère d'une alternative, peut être démontrée ou reste valide dans le périmètre énoncé. Soutenez-la par une source ou une expérience suffisamment solide pour cette affirmation précise ; étiquetez les preuves plus faibles comme provisoire plutôt que de les étirer en silence.
Lorsqu'une affirmation nécessite une preuve exécutable, effectuez la plus petite expérience pouvant la trancher et rédigez content/experiments/<nom>.md avec la question, la méthode, les échantillons, l'environnement, la commande, les résultats, les limites et les conclusions que le résultat soutient. Conservez le code et les données brutes dans le projet qui les possède ; enregistrez leurs chemins et leur révision Git au lieu de les copier dans le projet vidéo.
Contrat de contenu
Rédigez content/TOPIC.md :
---
status: brouillon
audience: ...
question_principale: ...
these: ...
portee: ...
voix:
langue: ...
competences: []
documents: []
indisponibles: []
statut: resolue | supposee
---
# Titre de travail
## Promesse au lecteur
## Argumentation
### A01 - Affirmation
- rôle: Pourquoi cette affirmation existe dans l'argumentation
- affirmation: La proposition exacte
- preuves: Liens vers les en-têtes de RESEARCH.md ou les rapports d'expérience
- confiance: établie | provisoire
- limite: Ce que la preuve n'établit pas
## Hors du périmètre
## Questions ouvertes
## Titres alternatifs
Résolvez les sources de voix dans cet ordre : directive explicite de l'utilisateur, directives du projet ou de la marque, un skill de style d'écriture disponible correspondant à la langue et au type de contenu, préférences visibles de l'utilisateur, exemples d'écriture, puis une valeur par défaut explicative claire. Enregistrez les sources réellement utilisées et persistez les sources demandées mais indisponibles sous voix.indisponibles ; ne supposez pas de mémoire indisponible ou de profil caché.
Porte d'approbation
Présentez le titre de travail, la thèse, la portée, l'argumentation, les preuves clés, les limites et les questions ouvertes matérielles pour examen. Un titre peut continuer à changer, mais le public, la thèse, la portée, l'argumentation, les preuves et les limites de conclusion sont des décisions verrouillées.
Seule une approbation explicite de l'utilisateur change le frontmatter en :
status: approuvé
approuve_le: AAAA-MM-JJ
digest_approuve: sha256:<digest>
Le digest est le SHA-256 du fichier complet après suppression de la seule ligne digest_approuve:. Recalculez-le avant de faire confiance à l'approbation. Une discordance rend l'approbation caduque et remet le fichier en brouillon. Après une modification non matérielle vérifiée du titre ou une correction éditoriale, le digest peut être rafraîchi sans nouvelle approbation ; propagez le nouveau digest à chaque artefact dépendant.
Jusque-là, conservez toute rédaction à l'intérieur de RESEARCH.md, des rapports d'expérience et du brouillon TOPIC.md. Ne créez pas ARTICLE.md ou BEATS.md ; une demande d'aller vite ou une permission de choisir une thèse ne remplace pas l'approbation du contrat résultant.
Un changement matériel ultérieur à une décision verrouillée remet TOPIC.md en brouillon et rend caduque l'approbation de l'article en aval. Les corrections éditoriales, les exemples et les changements de titre qui préservent le sens ne révoquent pas l'approbation.
Avant de présenter content/TOPIC.md ou toute révision ultérieure, suivez ../boring-video/references/markdown-review.md. Conservez le chemin Markdown canonique comme version actuelle et appliquez les retours de révision là.
Le sujet est complet lorsque TOPIC.md est approuvé, que chaque affirmation matérielle pointe vers des preuves suffisantes, que les questions ouvertes restantes sont non bloquantes et visibles, qu'un rédacteur d'article peut rédiger sans inventer les faits, les expériences, la position de l'auteur, l'argumentation ou la portée, et que le critère d'achèvement de la révision Markdown est satisfait.