archive

Vue d’ensemble de la skill archive

Ce que archive fait bien

La skill archive s’adresse aux équipes comme aux développeurs solo qui veulent transformer des connaissances issues d’une session ponctuelle en mémoire projet réutilisable. Au lieu de laisser des correctifs enfouis dans l’historique de chat, elle stocke les résolutions de debug, les notes de déploiement et les apprentissages de process dans .archive/YYYY-MM-DD/ sous forme de markdown structuré, puis maintient un index léger dans .archive/MEMORY.md.

Qui devrait installer archive

Cette skill archive convient particulièrement à celles et ceux qui reviennent régulièrement sur les mêmes sujets d’infrastructure, de CI, de release ou de debugging, et qui veulent retrouver plus vite le bon contexte la fois suivante. Elle est particulièrement utile si votre travail s’étale sur plusieurs sessions, plusieurs agents ou plusieurs contributeurs qui ont besoin d’un historique partagé du type « qu’est-ce qui s’est passé la dernière fois ? ».

Le vrai besoin auquel archive répond

Les utilisateurs n’ont pas besoin d’une nouvelle habitude de prise de notes. Ils ont besoin d’un moyen fiable de capturer un contexte technique à forte valeur juste après la fin d’une tâche importante, puis de faire remonter ce contexte avant de relancer une tâche similaire. archive est conçu autour de ce flux de travail, pas comme un outil de documentation générique.

Pourquoi archive est différent d’un prompt classique

Un prompt classique peut demander à une IA de « résumer ce qu’on a fait ». La skill archive ajoute un mode de stockage reproductible, une mise à jour obligatoire de l’index mémoire et un hook de démarrage de session qui charge automatiquement .archive/MEMORY.md lorsqu’il est présent. Cela rend archive for Knowledge Bases concret à l’usage : l’archive devient une partie du contexte de travail futur, et pas simplement un fichier markdown oublié.

Les arbitrages à connaître avant d’installer archive

archive est volontairement simple. Il ne fournit ni base de données, ni recherche vectorielle, ni pipeline de catégorisation automatisée. Sa valeur repose sur une structure de fichiers disciplinée, des tags recherchables et un index mémoire. Si votre équipe ne maintient pas .archive/MEMORY.md, la skill archive perd une grande partie de son intérêt.

Comment utiliser la skill archive

archive install et les fichiers du dépôt à lire en priorité

Un chemin pratique pour archive install est le suivant :

1. Ajoutez la skill depuis le dépôt ReScienceLab/opc-skills dans votre système de skills.
2. Lisez d’abord skills/archive/SKILL.md pour comprendre le workflow.
3. Lisez skills/archive/references/TEMPLATE.md pour voir la structure d’archive attendue.
4. Consultez skills/archive/hooks/hooks.json et skills/archive/hooks/load-memory.py si le chargement du contexte au démarrage vous intéresse.
5. Vérifiez skills/archive/.factory-plugin/plugin.json pour confirmer le comportement prévu.

Si vous ne devez survoler qu’un seul fichier de support, choisissez references/TEMPLATE.md ; c’est lui qui montre à quoi ressemble une « bonne sortie archive ».

Ce dont la skill archive a besoin en entrée

La skill archive fonctionne le mieux si vous lui donnez :

• la tâche ou l’incident terminé
• le résultat principal
• les étapes clés suivies
• les commandes critiques, changements de config ou décisions de code
• les points d’échec et les correctifs finaux
• la catégorie et les tags probables
• les éventuelles anciennes entrées archive liées

Sans ces éléments, l’archive sera trop vague pour être utile plus tard.

Quand déclencher l’usage de archive

Utilisez archive après :

• un déploiement réussi
• une session de debugging difficile
• une migration ou un changement d’infrastructure
• la finalisation d’une fonctionnalité importante
• toute instruction utilisateur du type « archive this »

Ne l’utilisez pas pour chaque petite modification. La skill est faite pour des apprentissages durables, pas pour des journaux d’activité bruyants.

Comment archive s’utilise concrètement

Le workflow visé est le suivant :

1. Vérifier .archive/MEMORY.md pour repérer d’éventuels travaux antérieurs liés.
2. Créer ou réutiliser .archive/YYYY-MM-DD/.
3. Rédiger une archive markdown en suivant la structure du template et le frontmatter YAML.
4. Ajouter une entrée d’index sur une ligne dans .archive/MEMORY.md.
5. Relier les entrées associées via le champ related.

Cette mise à jour de l’index n’est pas une formalité inutile. C’est ce qui permet de retrouver rapidement l’information plus tard.

Un meilleur prompt pour la skill archive

Prompt faible :

• « Archive cette session. »

Meilleur prompt :

• « Use the archive skill to document today’s ECS deploy issue. Include the IAM permission error, the CloudWatch clue, the exact fix, final deploy status, tags for ecs, iam, deploy, category infrastructure, and add a one-line entry to .archive/MEMORY.md. If a related archive exists, link it. »

Cette version plus précise donne au modèle assez de structure pour produire quelque chose de réellement réutilisable.

Comment transformer un objectif flou en demande archive complète

Si votre objectif brut est « conserver ce qu’on a appris », développez-le en précisant :

• ce qui s’est passé
• pourquoi c’était important
• ce qui a échoué
• ce qui a corrigé le problème
• ce qu’il faudra vérifier en premier la prochaine fois
• où cela doit être classé dans les catégories
• comment quelqu’un devra pouvoir le retrouver plus tard via les tags

Cette skill récompense une rédaction pensée pour la recherche et la récupération d’information, pas une écriture narrative.

Les champs du template archive les plus importants

D’après references/TEMPLATE.md, les champs les plus importants sont :

• tags : pour la recherche via grep
• category : pour l’organisation de l’index
• related : pour relier les incidents dans le temps

Dans le corps du document, les sections qui ont le plus de valeur sont généralement :

• Summary
• Issues Encountered & Solutions
• Key Changes

Si vous omettez les détails concrets du correctif, l’archive perd beaucoup de son utilité.

Comment le hook mémoire au démarrage change l’usage de archive

Le hook charge .archive/MEMORY.md dans le contexte de session au démarrage lorsque le fichier existe. Cela signifie que la skill archive ne sert pas seulement à écrire ; elle améliore aussi automatiquement la mémoire des sessions futures. Du point de vue de l’adoption, c’est l’une des meilleures raisons d’installer la skill plutôt que d’utiliser un simple fichier de notes improvisé.

archive for Knowledge Bases et mémoire d’équipe

Pour archive for Knowledge Bases, considérez .archive/MEMORY.md comme la table des matières et chaque fichier markdown daté comme l’enregistrement d’un incident ou d’une tâche. Cela fonctionne bien pour :

• les problèmes opérationnels récurrents
• les checklists de release avec pièges à éviter
• les correctifs spécifiques à un environnement
• les décisions de design avec des conséquences concrètes

C’est moins adapté à une documentation produit large ou à des manuels destinés aux utilisateurs.

Workflow pratique de recherche et de consultation

La skill prend explicitement en charge une recherche légère :

• consulter .archive/MEMORY.md
• utiliser grep -ri "keyword" .archive/

Cela suffit à beaucoup d’équipes d’ingénierie, car le contenu stocké est ciblé, technique et structuré. Utilisez des tags que les gens rechercheront réellement plus tard : noms de services, messages d’erreur, noms de plateformes et noms de composants.

FAQ sur la skill archive

Est-ce que archive vaut le coup si je prends déjà des notes ?

Oui, si vos notes actuelles sont difficiles à retrouver ou ne reviennent jamais dans le contexte de l’agent. La skill archive est utile parce qu’elle standardise l’emplacement, la structure, l’indexation et le chargement mémoire au démarrage de session.

Cette skill archive est-elle adaptée aux débutants ?

Oui, globalement. Le workflow repose sur du markdown simple plus un fichier d’index. Le principal risque pour les débutants est de rédiger des résumés trop abstraits. La skill est plus facile à utiliser si vous partez du template et que vous renseignez des correctifs précis, des commandes et des enseignements concrets.

Quand ne faut-il pas utiliser archive ?

N’utilisez pas archive pour :

• des modifications triviales
• du brainstorming temporaire
• de la documentation longue
• des connaissances qui devraient vivre dans une documentation permanente du dépôt, comme README.md ou des runbooks

Si l’information doit guider tous les contributeurs en permanence, elle a peut-être sa place dans la documentation standard, et pas seulement dans .archive/.

En quoi archive diffère-t-il de la documentation projet classique ?

La documentation classique décrit le système tel qu’il est censé fonctionner. L’usage de archive capture ce qui s’est réellement passé pendant une tâche ou un incident : les pistes qui ont échoué, le correctif exact et le contexte qui se perd d’ordinaire. C’est une couche de mémoire opérationnelle historique, pas un remplacement des documents de référence.

archive nécessite-t-il un outillage particulier ?

Pas vraiment. Le format de base repose sur des fichiers markdown et .archive/MEMORY.md. Le dépôt inclut aussi un hook qui charge la mémoire au démarrage de session, mais même sans cela, la skill archive reste utile comme schéma de stockage discipliné.

Quelles sont les limites de ce guide archive ?

Ce guide archive reflète ce que le dépôt prend réellement en charge : des archives basées sur des fichiers, une mémoire indexée, des catégories simples, des liens related et un rappel via hook. Il ne promet pas de pipelines de résumé automatisés, de recherche sémantique ni de synchronisation avec une base de connaissances externe.

Comment améliorer la skill archive

Rédiger des entrées archive pour la recherche, pas pour raconter une histoire

Les meilleures sorties archive se parcourent rapidement plus tard. Placez le problème, le correctif et les commandes critiques à des endroits où un futur lecteur pourra les repérer vite. Un récit bien tourné a moins de valeur qu’un enregistrement direct et facilement retrouvable.

Utiliser des tags que les gens chercheront vraiment

Bons tags :

• noms de services ou d’outils
• noms exacts de sous-systèmes
• noms de plateformes de déploiement
• mots-clés d’erreur
• noms des environnements concernés

Mauvais tags :

• mots vagues comme issue, work ou update

C’est l’un des leviers les plus puissants pour améliorer la qualité d’usage de archive.

Rendre MEMORY.md utile, pas cérémoniel

Une entrée d’index faible dit :

• « Fixed deployment issue »

Une entrée forte dit :

• « ECS deploy failed due to missing IAM permission for secret access; resolved by updating task role policy »

L’index doit aider quelqu’un à décider quelle archive ouvrir ensuite.

Capturer les tentatives ratées quand elles influencent les décisions futures

Si l’équipe a essayé deux mauvais correctifs avant de trouver le bon, incluez-les lorsqu’ils permettent d’éviter de refaire les mêmes pertes de temps. C’est là que la skill archive dépasse souvent la documentation standard : elle conserve les impasses qui comptent.

Fournir de meilleures entrées pour obtenir de meilleures sorties archive

Avant de demander à la skill d’archiver, rassemblez :

• le texte exact de l’erreur
• les commandes pertinentes
• les fichiers ou réglages modifiés
• l’état final vérifié
• pourquoi le correctif final a fonctionné

Ces détails améliorent concrètement la réutilisation future et la capacité de recherche.

Modes d’échec fréquents dans l’usage de la skill archive

Les problèmes les plus courants sont :

• absence de mise à jour de .archive/MEMORY.md
• tags trop génériques
• catégorie peu claire ou absente
• résumé sans détail opérationnel
• entrées archive sans lien avec des incidents antérieurs

La plupart des mauvais résultats avec archive viennent d’entrées incomplètes, pas du template lui-même.

Itérer après le premier brouillon archive

Après le premier brouillon, vérifiez :

• Quelqu’un peut-il retrouver cela avec des termes de recherche probables ?
• Le résumé indique-t-il à la fois le résultat et la cause ?
• Les commandes clés ou changements de configuration sont-ils inclus ?
• Un futur agent saurait-il quoi essayer en premier ?
• Faut-il le relier à une entrée antérieure associée ?

Une courte seconde passe améliore souvent fortement la qualité de l’archive.

Utiliser archive en complément, pas à la place, de la documentation permanente

Si la session a révélé une règle durable, mettez aussi à jour la documentation de référence. La skill archive doit préserver une connaissance au niveau des événements ; elle ne doit pas devenir l’unique endroit où vit une consigne critique pour l’équipe.

Améliorer l’adoption de archive avec un déclencheur d’équipe clair

Les équipes obtiennent de meilleurs résultats lorsqu’elles définissent des déclencheurs explicites, par exemple :

• chaque déploiement en production avec surprise
• chaque incident avec un correctif non évident
• chaque migration
• chaque demande utilisateur du type « save this for next time »

Cela permet de garder une archive utile sans la remplir de bruit.