ingest

name	ingest
description	Capturer n'importe quel contenu (URL, texte collé, transcript, note) et l'intégrer au bon endroit de ton vault, avec une synthèse exploitable et les bons liens. Apprend ta taxonomie en lisant la doc de ton vault. Valide avant d'écrire. Usage : /ingest <contenu ou URL>

Ingest - capturer et classer un contenu

Prendre un contenu brut (URL, texte collé, transcript, article) et l'intégrer au bon endroit de ton vault, avec le bon format, les bons liens et une synthèse courte. C'est l'acte de base d'un second cerveau : capturer sans créer de désordre.

Trigger : /ingest <contenu ou URL>. Le contenu est dans les arguments.

Principe

Le skill ne plaque pas une arborescence toute faite : il apprend ta taxonomie en lisant la documentation de ton vault, puis classe le contenu dans tes catégories. Si ton vault ne déclare rien, il retombe sur une taxonomie générique raisonnable.

Étape 1 : Apprendre la structure du vault

Lire la doc que le vault donne sur lui-même : fichiers d'instructions (CLAUDE.md, AGENTS.md...), index (README.md, INDEX.md, MOC), et toute règle de rangement ou de nommage. But : connaître les dossiers existants, leur rôle, et les conventions (nommage, frontmatter, format de date) avant de décider où ranger.

Taxonomie de repli (si le vault ne déclare rien d'exploitable) :

Catégorie	Destination type	Quand
Ressource externe	veille/AAAA-MM-JJ-slug.md	Article, vidéo, podcast, post externe
Transcript de réunion	meetings/AAAA-MM-JJ-slug.md	Call, réunion, interview
Leçon / pattern	notes/slug.md	Insight réutilisable, erreur documentée
Réflexion / décision	dossier projet concerné	Décision structurante, pivot
Méthode / SOP	processes/slug.md	Procédure reproductible

Étape 2 : Identifier le type de contenu

• URL -> récupérer le contenu (WebFetch ; pour une vidéo, en récupérer le transcript si possible).
• Texte collé -> analyser directement.
• Référence à un fichier local -> le lire.

Si le contenu est vide ou ambigu, demander de préciser.

Étape 3 : Classer

Déterminer la catégorie (taxonomie du vault, sinon repli) à partir de : type de source (externe / transcript / libre), sujet, intention probable (apprendre / documenter / décider / archiver). Si rien ne matche clairement, demander plutôt que deviner.

Si ton vault a un skill dédié pour un type précis (réunions, vidéos...), défère-lui plutôt que de le traiter ici.

Étape 4 : Extraire et synthétiser

Synthèse adaptée à la catégorie, courte :

• Ressource externe : titre, source, date, 3-5 puces d'insights clés.
• Transcript : participants, décisions, actions, points ouverts.
• Leçon / pattern : le pattern en une phrase, le contexte d'où il vient, comment l'appliquer.
• Réflexion / décision : la thèse, les arguments pour/contre, la décision ou la question ouverte.

Étape 5 : Proposer avant d'écrire

Afficher : catégorie choisie, destination (chemin), synthèse générée. Attendre la validation avant d'écrire quoi que ce soit.

Étape 6 : Écrire et relier

Après validation :

1. Créer le fichier au bon endroit, format type :

   # {Titre}
   
   {Synthèse structurée selon la catégorie}
   
   ## Source
   - {URL ou référence}
   - Date d'ingestion : {AAAA-MM-JJ}
   
   ## Liens
   - [[lien pertinent 1]]
   - [[lien pertinent 2]]
   

2. Relier aux entités mentionnées (projets, personnes, sujets) déjà présentes dans le vault.
3. Si ton vault tient un journal (daily) ou un index, y ajouter une ligne - seulement s'il existe.

Règles

• Ne jamais écrire sans validation.
• Ne pas créer un dossier inexistant sans demander (vérifier l'arborescence avant).
• Anti-doublon : chercher (grep par URL ou titre) si un fichier similaire existe déjà avant de créer.
• Nommage : AAAA-MM-JJ-slug.md (daté) ou slug.md, slug en kebab-case (< 5 mots).
• Suivre les conventions d'écriture de ton vault (nommage, frontmatter, langue, typographie).
• Respecter les zones en lecture seule éventuelles de ton vault (ne pas y écrire sans demande explicite).

Erreurs courantes

Erreur	Correction
Classer en "ressource externe" un contenu interne	Externe uniquement. Interne -> note/pattern, réflexion ou process
Créer un fichier dans un dossier inexistant	Vérifier avant ; créer le dossier après validation seulement
Résumé trop long	3-5 puces pour une ressource, synthèse courte sinon
Oublier les liens	Toujours relier aux entités mentionnées
Ré-ingérer un contenu déjà présent	Grep par URL/titre avant de créer