iamshadmirza/to-onepager

Transformez une conversation en un one-pager : une revendication, des preuves ancrées, facile à lire et à suivre, avec une destination de publication configurée.

Entrée : chemin/colle d'un transcript si fourni ; sinon la conversation en cours. setup / reconfigure → exécute la configuration même si config.md existe.

Configuration : config.md à côté de ce SKILL.md (local au répertoire d'installation). Structure : config.example.md.

Types de pages (en direct) : research-finding | proposal. Préférez research-finding en cas de doute. Demandez une seule fois si les deux conviennent. Annoncez le choix avant de rédiger.

Étapes

0. Configuration

Si config.md est manquant ou si l'utilisateur demande une reconfiguration :

1. Demandez la destination : local | google-docs | confluence (exactement une).
2. Collectez les champs pour cette destination (voir config.example.md). Confluence nécessite confluence_folder_url.
3. Écrivez config.md dans ce répertoire de compétence.
4. Dites à l'utilisateur que cela s'applique à chaque exécution future ; dites setup pour le modifier.

Achèvement : config.md valide avec une destination connue. Les exécutions de configuration seule s'arrêtent ici, sauf si un one-pager a également été demandé.

1. Minage

Lisez l'intégralité de l'entrée. Notes de travail uniquement (ne les montrez pas à l'utilisateur) :

• Intention de la session : revendication empirique vs pari décisionnel
• La question ou le problème que toute la session a servi
• Hypothèses testées (commencez par les corrections / ce qui a changé)
• Faits ancrés (sourcés) vs revendications non sourcées (confiance moyenne)
• Méthode, limites, questions ouvertes, actions suivantes (décisions produit/recherche, pas des runbooks locaux)

Si l'intention penche vers research-finding, capturez également :

• Mécanismes explicatifs avec comptages (signal dominant, motif FP, contrefactuel)
• Résultats mis en avant par l'utilisateur (« placez ceci dans les Résultats clés »)
• Expérience ? Si la session compare la même mesure dans N conditions (caps, modes, périmètres, configurations, bras A/B), listez chaque condition et le tableau décisif (scorecard, composition des écarts, vérification d'égalité). Signalez fill: experiment.

Si l'intention penche vers proposal, capturez également :

• Problème / qui est impacté, pari recommandé, pourquoi maintenant, approche, alternatives (avec sources quand elles sont présentes), risques
• Prochaines étapes à court terme discutées dans la session

Achèvement : signaux d'intention, corrections, faits sourcés et notes spécifiques à la branche capturés. Pas d'interprétation encore.

2. Routage

Choisissez exactement un type de page dans le catalogue ci-dessous. Annoncez : Type de page : ….

Type de page	Quand l'utiliser	Préférez l'autre quand
research-finding	La preuve répond à « qu'est-ce qui est vrai ? »	La session est principalement un pari avec peu de nouvelles preuves
proposal	La session cadre un pari (problème, chemin, pourquoi, comment)	La session est une pure mesure sans changement recommandé

Réservez la vérification et l'architecture pour plus tard ; si la session ne contient que ces formes, demandez quel type en direct est le plus proche ou arrêtez-vous.

Achèvement : un type de page choisi et annoncé.

3. Distillation

Chargez le template pour le type routé (pointeur de contexte — lisez uniquement ce fichier) :

• research-finding → templates/research-finding.md
• proposal → templates/proposal.md

Remplissez cette structure pour une lecture facile : un lecteur novice doit saisir la revendication en quelques secondes et suivre un fil par section.

Chemin de remplissage research-finding

• Par défaut : Hypothèses → Résultats → Résultats clés (structure par défaut du template).
• Expérience (quand le Minage a signalé fill: experiment) : utilisez la structure expérience du template. Annoncez : Chemin de remplissage : expérience.
  • Échelle de résultats : puces imbriquées (un verdict par condition) plus une ligne de fond facultative ; n'écrasez pas N conditions en une seule méga-phrase.
  • Contexte avant les conditions (facultatif) : après Réponse, un court bloc qui explique les côtés de la comparaison et les termes faciles à confondre (par exemple types vs comptages d'instances) afin que les tableaux ne soient pas mal interprétés. Utilisez-le uniquement lorsque Question ne suffit pas. Préférez un titre simple comme Comment lire ceci ; omettez-le quand il n'est pas nécessaire. N'inventez pas un nom de section obligatoire.
  • Sections de conditions : une section de premier niveau par condition ; chacune est Verdict puis Analyse. Titrez la section par justice ou résultat (par exemple « A/B équitable : cap supprimé »), pas seulement le bouton brut (« MaxMessages = 100 »). Mettez la preuve partageable dans Analyse (scorecard et/ou même conclusion / tableau de composition des écarts).
  • Réplication : imbriquez sous la condition décisive/équitable (par exemple Vérification multi-session) ; n'ajoutez pas une section de condition de premier niveau juste pour les répétitions.
  • Ne pas aplatir une expérience à N conditions en Hypothèses → Résultats → Résultats clés.

Lisibilité (chaque page)

• Commencez par la chose concrète : le titre et Résultat s'ouvrent sur le nombre, le verdict ou le pari. Le contexte suit ; il n'ouvre pas la page. Pour les expériences, Résultat peut porter l'enjeu sous forme d'échelle de puces ; le titre peut nommer la comparaison si Résultat contient les chiffres.
• Expliquez après l'exemple : dans Résultats, Résultats clés, Analyse et Comment, énoncez d'abord le résultat mesuré ou la voie choisie, puis une courte ligne de contexte si nécessaire.
• Un seul travail par section : chaque titre fait un seul travail. Si une section argumente deux choses, divisez ou supprimez.
• Réponse qu'un lecteur novice peut utiliser sans se soucier du type de page : Résultat (TLDR) / Confiance / Et alors
• Le titre est la revendication (incluez un nombre mesuré quand le transcript en a un ; les expériences peuvent mettre le nombre dans Résultat à la place)
• Recommandation : uniquement les actions discutées dans la session. Si la session n'a fait que répondre à une question (recherche fermée, pas de pari produit), écrivez Aucune (ou « recherche terminée ; pas de suivi ») — n'inventez pas de prochaines étapes, de TODO de doc, de devoirs de relecteur ou de plan « ~1 semaine ».
• En-tête : Propriétaire, Aller plus loin
• Section de relecture présente

Propriétaire : identifiez une personne réelle. Pour les destinations Confluence, utilisez les mentions Atlassian lors de la publication (publish.md). Sinon, nom affiché. Demandez si inconnu ; À DÉTERMINER seulement si reporté.

Achèvement : structure routée remplie (par défaut ou expérience) ; chrome complet ; Propriétaire résolu ou À DÉTERMINER explicite ; titre et Résultat commencent par la revendication concrète.

4. Ancrage

Échouez et modifiez jusqu'à ce que chaque vérification passe. Cette étape est la source unique de vérité pour la qualité (les templates ne réitèrent pas ces règles).

Chaque page

• Chaque cellule/puce factuelle remonte au transcript
• Pas de magnitudes non mesurées
• Réponse pour lecteur novice fonctionne sans lire le type de page ; Résultat est le TLDR et commence par la revendication concrète (le Résultat d'expérience peut être une échelle de puces)
• Le titre commence par la revendication (pas un sujet ou un en-tête vague) ; les expériences peuvent nommer la comparaison dans le titre si Résultat contient l'enjeu/les chiffres
• Le corps correspond au type de page routé (pas de structure hybride)
• Un seul travail par section ; pas de section qui à la fois explique et recommande
• Chrome complet (Propriétaire, Aller plus loin)
• Aller plus loin / recommandations restent exempts de détails de runbook local
• Confiance correspond aux preuves ; le titre correspond aux nombres mesurés quand ils sont présents (ou Résultat le fait, pour les échelles d'expérience)
• Budget d'une page : environ 600 mots de prose ; si c'est trop, coupez les idées les moins importantes (ne réduisez pas la police ni ne fourrez une annexe). Exception : les tableaux décisifs d'expérience (scorecard, composition des écarts, vérification d'égalité) ne sont pas coupés pour atteindre le budget ; raccourcissez plutôt les puces autour d'eux.
• Validation simple sur Réponse + Recommandation : voix active, mots courts, supprimez les mots inutiles et le jargon
• Pas de ponts de template : supprimez les phrases comme « dans le paysage actuel », « révolutionnaire », « voici pourquoi c'est important » ou une question de clôture ajoutée uniquement pour l'engagement
• Pas de récapitulation molle : la Recommandation ne reformule pas le Résultat
• Pas de suivis inventés : prochaines étapes uniquement si le transcript les a discutées ; sinon la Recommandation est Aucune / recherche terminée
• Chaque section ajoute quelque chose de nouveau ; supprimez le remplissage qui ne fait que reformuler une section antérieure