● Communauté
theDakshJaitly
⚡ Instantané
mex
par theDakshJaitly · theDakshJaitly/mex
Scaffold de mémoire projet + détecteur de dérive — garde les agents de code IA ancrés dans l'état réel de votre projet, pas dans un instantané d'hier.
mex installe un scaffold de mémoire structuré dans votre dépôt (architecture, conventions, travail en cours, blocages) et livre une CLI qui détecte la dérive entre la mémoire et la réalité. Quand les changements de code contredisent la mémoire, la CLI le signale pour que vous puissiez mettre à jour ou ré-aligner. Léger — conçu pour vivre dans le dépôt et voyager avec l'équipe.
Pourquoi l'utiliser
Fonctionnalités clés
- Scaffold de mémoire structuré : architecture / conventions / en cours / blocages
- CLI de dérive comparant les affirmations de mémoire avec le code/tests réels
- Marqueurs de fraîcheur par section (date de dernière vérification)
- Conçu pour une utilisation humaine + agent partagée ; les deux lisent les mêmes fichiers
- Fonctionne bien avec CLAUDE.md / AGENTS.md
Démo en direct
Aperçu en pratique
prêt
Cas d'usage
Usages concrets : mex
Quand l'utiliser : Jour 1 d'un projet ; vous voulez que les agents montent en vitesse rapidement.
Déroulement
-
Initialiser
Use mex. Initialize project memory with sections: architecture, conventions, in-flight, blockers.✓ Copié
→ Scaffold /.mex/ créé avec templates
-
Remplir les amorces
Auto-extract architecture from existing code and a starter convention list.✓ Copié
→ Sections amorcées avec contenu de démarrage
-
Définir la fraîcheur
Mark each section verified today.✓ Copié
→ Marqueurs de fraîcheur définis
Résultat : Nouveau projet démarrant avec un contexte agent partagé.
Pièges
- L'auto-extraction capture des détails non pertinents — Élaguer impitoyablement — la mémoire est pour les principes, pas pour grep
Quand l'utiliser : La mémoire a été configurée il y a des mois ; personne n'est sûr du degré de péremption.
Déroulement
-
Exécuter la détection de dérive
Use mex. Run drift detection. Report claims that no longer match reality.✓ Copié
→ Rapport de dérive avec affirmation ↔ evidence
-
Mettre à jour ou supprimer
For each drift, decide: update memory or fix the code (claim was right and reality drifted).✓ Copié
→ Décision par item ; PRs ouvertes pour les corrections côté code
-
Re-vérifier
After resolving, mark sections verified today.✓ Copié
→ Mémoire réalignée
Résultat : La mémoire reste un contrat fiable, pas du folklore.
Pièges
- Le détecteur de dérive signale trop agressivement — Ajuster --strictness ; utiliser 'medium' pour les projets actifs
Quand l'utiliser : Vous avez 3 fonctionnalités en cours et quelqu'un d'autre doit les reprendre.
Déroulement
-
Capturer le travail en cours
Use mex. For each open branch, write an in-flight entry: goal, current state, next steps, gotchas.✓ Copié
→ Entrées dans /.mex/in-flight/
-
Vérifier avec la CLI
Run drift on in-flight; ensure entries reflect actual branch state.✓ Copié
→ Dérive propre
-
Transmettre
Generate a teammate-ready summary linking each entry to its branch.✓ Copié
→ Transmission prête pour Slack/email
Résultat : Reprise fluide ; pas d'archéologie requise.
Pièges
- Entrées en cours vagues («travaille sur X») — Forcer le champ «prochaines étapes» du template ; concret ou ça n'aide pas
Combinaisons
Associez-le à d'autres MCPs pour un effet X10
La mémoire vit dans le dépôt ; la committer
Commit /.mex/ to git so memory travels with the codebase.✓ Copié
Vérification CI de dérive sur les PRs
On every PR, run mex drift and post the report as a PR comment.✓ Copié
Coût et limites
Coût d'exécution
- Quota d'API
- Aucun — local
- Tokens par appel
- La dérive utilise LLM pour les affirmations floues ; plafonné par exécution
- Monétaire
- Gratuit
- Astuce
- Utiliser strict=high en CI pour détecter la vraie dérive ; medium pour les vérifications locales quotidiennes
Sécurité
Permissions, secrets, portée
Portées minimales : filesystem-write
Stockage des identifiants : Aucun
Sortie de données : Aucun sauf si le LLM de dérive est configuré vers un fournisseur distant
- La mémoire contient des détails d'architecture — ajouter /.mex/ dans .gitignore si le dépôt est privé et vous avez des forks publics
Dépannage
Erreurs courantes et correctifs
La dérive rapporte des faux positifs
Baisser la rigueur ; ou affiner la formulation des affirmations pour les rendre plus vérifiables
La mémoire croît sans limites
Chaque section a un plafond souple ; consolider périodiquement — garder les principes, archiver les spécificités
La CLI ne trouve pas /.mex/
Exécuter depuis la racine du dépôt ; ou passer --root <chemin>
L'auto-extraction manque des invariants clés
L'auto-extraction est un point de départ ; écrire manuellement les invariants porteurs
Alternatives
mex vs autres
| Alternative | Quand l'utiliser | Compromis |
|---|
| claude-mem-skill | Vous voulez la continuité de session, pas la mémoire de connaissances projet | Problème différent ; mex est pour les invariants au niveau projet |
| CLAUDE.md simple | Petit projet, pas besoin de détection de dérive | Pas de structure ; pas de vérifications de fraîcheur automatiques |
| pilot-shell-skill | Vous voulez spec/plan/portes plus persistance de connaissance | Surface de workflow plus grande ; plus opinioné |