agentleFS
vynarimvynarim/ClaudePlugins/CLAUDE.md

ClaudePlugins

CLAUDE.md1 starsChanged 2 months agoMITView on GitHub

Repo-catalogue de la marketplace dev-tools (plugins Claude Code). Repo public, généraliste : outillage Claude Code transverse, sans domaine métier. Vocabulaire : repo ClaudePlugins · marketplace dev-tools · plugin claude-utils · skills /<nom>. Un plugin, deux axes — tranché le 14/09/2026, ne pas rouvrir. claude-utils porte le processus de développement (commit, tests, publication, permissions, docs, trace de session) et le produit affiché à l'utilisateur (charte visuelle, cadre mobile), ce second axe sous préfixe ui-. Il y a eu deux plugins du…

The file

Files
CLAUDE.md

ClaudePlugins — index projet

Repo-catalogue de la marketplace dev-tools (plugins Claude Code). Repo public, généraliste : outillage Claude Code transverse, sans domaine métier. Vocabulaire : repo ClaudePlugins · marketplace dev-tools · plugin claude-utils · skills /<nom>.

Un plugin, deux axes — tranché le 14/09/2026, ne pas rouvrir. claude-utils porte le processus de développement (commit, tests, publication, permissions, docs, trace de session) et le produit affiché à l'utilisateur (charte visuelle, cadre mobile), ce second axe sous préfixe ui-. Il y a eu deux plugins du 16/08 au 14/09 ; la fusion s'est décidée sur trois constats : le routage se fait sur la description de chaque skill, pas sur le plugin — la séparation ne protégeait rien ; un usage solo n'a que faire de l'installation à la carte ; et le bandeau des projets n'affichait que le premier plugin, rendant les skills ui- invisibles là où on travaille.

claude-utils, 13 skills — eco · audit · test · garde-fou · doc · kit-sync · perms · ship · deploy · reprise · update-plugins · ui-charte · ui-frame. Rôle de chacune et structure du repo : README.md. Ces listes sont l'une des déclarations contrôlées par coherence.mjs : y ajouter toute nouvelle skill.

Règles du catalogue

  • audit, deploy, test, doc, kit-sync et perms portent la méthode et lisent leurs spécificités dans .claude/<nom>-notes.md côté projet (gabarits dans claude-utils/skills/<nom>/references/). Sans ses notes, deploy s'arrête ; les autres tournent en mode dégradé.
  • garde-fou n'a pas de notes propres, et c'est voulu : elle lit test-notes.md et deploy-notes.md. Une skill qui réclame ses propres notes pour redire ce qui est écrit à côté fabrique la divergence.
  • Journaux écrits sans demander : .claude/audit-log.md, .claude/kit-log.md.
  • La description d'eco ne doit pas être ramenée au gabarit maison : c'est la seule skill proactive du plugin, l'aligner la rendrait réactive. Exception inscrite dans plugin-check § « Exceptions admises » et dans la table EXCEPTIONS de coherence.mjs — les deux bougent ensemble.
  • Côté produit (ui-*) : un seul fichier de notes pour les deux skills (.claude/uxui-notes.md), pas un par skill — le profil d'un projet ne change pas selon la skill qui le lit. Le préfixe ui- reste : il groupe ces skills dans le sélecteur et dit leur axe. (Sa raison d'origine — contourner une recherche par sous-chaîne dans coherence.mjs — a disparu avec le resserrage du 14/09.)
  • Une skill ne change pas d'identité une fois publiée — ni de plugin, ni de nom — sans faire le tour des postes : ceux qui gardent l'ancienne copie ont deux skills pour le même geste. La fusion du 14/09 a payé ce prix une fois (uninstall claude-uxui sur chaque poste) ; avec un seul plugin, la question ne se repose plus.
  • Six cibles de déclaration pour claude-utils (il a un QUICKSTART.md). coherence.mjs découvre les plugins et retire les cibles absentes au lieu de rougir — un second plugin sans QUICKSTART en aurait cinq.
  • marketplace.metadata.version est la version du catalogue, pas celle d'un plugin. Le plugin a la sienne, contrôlée contre sa ligne du README racine.

Conventions

  • Pas de commit/push automatique. Faire les modifs, puis attendre /ship. Voir [[no-auto-commit-ship-skill]].
  • Aucun trailer Co-Authored-By ni mention d'assistant dans les messages de commit ni dans les corps de PR, quel que soit le dépôt. Voir [[no-coauthored-by-trailer]].
  • Messages : type(domaine): ce que ça apporte — l'apport, pas le geste — puis une à deux lignes de pourquoi ou d'effet, puis une ligne Axe : <axe> reprenant le découpage d'/audit (sécurité · données · métier · performance · propreté · config). Types : feat, fix, docs, chore, refactor, test, perf, ci. Règle complète : ship étape 6 — ici on ne fait que la rappeler, c'est la skill qui fait foi. Travail directement sur main.
  • Publier = bump version du plugin + valider les JSON touchés (un manifeste cassé empêche le chargement du plugin sur tous les postes) + /ship, puis /update-plugins sur chaque poste. Procédure : DEPLOYMENT.md.
  • Renommer, supprimer ou ajouter une skill oblige à sortir de ce dépôt. Les projets d'Apps/ recopient la liste des skills en dur dans leur CLAUDE.md, et plusieurs l'affichent en bandeau à la fin de chaque réponse : une entrée périmée propose une commande qui n'existe plus, à chaque message. Aucun garde-fou de CI ne le voit — coherence.mjs ne regarde que ce dépôt. Le bandeau est identique partout — mêmes emojis, mêmes skills, même ordre alphabétique, au caractère près. La ligne canonique vit dans DEPLOYMENT.md, § « Le bandeau des projets » ; un projet à skills locales ajoute une seconde ligne 🏠, jamais sur la même. Contrôle : node .claude/skills/plugin-check/references/bandeaux.mjs (local au poste, hors CI). Chercher aussi par d'autres motifs que l'emoji — une liste peut vivre en prose ou sous un titre ## Skills. Inventaire : [[bandeau-skills-projets]].
  • main n'est pas protégée — tranché non, ne pas rouvrir. Un required_status_checks rejette les poussées directes, impose un flux PR et casse /ship. Le garde-fou CI est informatif, et c'est assumé : sur un dépôt solo, la notification d'échec suffit.

État courant

Bloc remplacé à chaque /reprise, jamais empilé. Le vérifier contre git status avant de le croire — il décrit l'état au moment où il a été écrit, pas l'état courant.

claude-utils 3.1.0, catalogue 4.0.0 — non commités. Un seul plugin : claude-uxui est absorbé, ui-frame et ui-charte sont deux skills de claude-utils (13 au total), préfixe ui- conservé. Le bandeau canonique des six projets voisins les affiche désormais. La 3.0.0 (onze skills, garde-fou, reprise) et le cours revu sont publiés et poussés.

À reprendre en premier

  1. Publier, puis retirer l'ancien plugin sur chaque poste. /ship → /update-plugins → claude plugin uninstall claude-uxui@dev-tools — ici et sur l'autre PC. Sans l'uninstall, ui-frame et ui-charte existent en double (l'ancienne copie reste installée, le catalogue ne la retire pas). Vérifier ensuite claude plugin list : une seule entrée dev-tools par scope.
  2. Éprouver ce qui n'a jamais tourné. Les notes de Nemesis (contrôle « la version est dans le bundle » écrit sans être exécuté, section Rollback vide) et ui-charte, jamais passée sur un dépôt.
  3. ui-frame, premier essai. Banc négatif : EpeeChaudron (mobile-first et lisible sur PC, donc responsive — la skill doit refuser). Manque le dépôt mobile-only pour l'essai positif ; aucune des six apps Vite + React n'est identifiable comme telle depuis son package.json. À désigner.

Dettes et fausses pistes — ne pas refaire

  • agents-sync (#09) est FERMÉE — tranché le 14/09, ne pas rouvrir. Zéro .claude/agents/ dans les 9 projets ; un seul AGENTS.md (EpeeChaudron), fichier Codex dans un projet sans CLAUDE.md. La roadmap des 9 skills est terminée.
  • Deux plugins, c'était une fausse bonne idée — tranché le 14/09. Le routage est par skill, pas par plugin ; la séparation ne coûtait que de la doublure. Ne pas recréer un plugin par axe.
  • claude plugin update|uninstall -s project ne résout pas par répertoire courant. Vérifié depuis trois dépôts. La seule voie est le registre ~/.claude/plugins/installed_plugins.json.
  • Double scope sur ce poste — non tranché, et ce n'est pas un bug. Le enabledPlugins du .claude/settings.json (suivi par git, synchronisé par OneDrive) recrée l'installation project au démarrage ; le retirer casserait le scope projet voulu sur l'autre PC. Ne pas y toucher.
  • Le bandeau des projets ne se cherche pas par l'emoji seul — ligne canonique dans DEPLOYMENT.md, contrôle bandeaux.mjs (local, hors CI).
  • audit (257 l.) et ship (227 l.) dépassent le seuil de 150 — assumé.
  • Nemesis : Objectifs.xlsx est modifié depuis avant les chantiers du 14/09, sans rapport avec eux. Non commité — le regarder avant de l'emporter.

État git

ClaudePlugins — main, 0 commit d'avance sur origin/main, le lot de fusion non commité (dossier claude-uxui/ retiré, deux skills déplacées, manifestes, docs). Six projets voisins : leur CLAUDE.md modifié (bandeau étendu), non commités.

Détails déportés (lire seulement si pertinent)

  • .claude/lecons.md — leçons de méthode : contrôles maison en PowerShell 5.1, vérifier une trace contre git, ce qui reste hors du garde-fou CI, règles de permissions tranchées
  • .claude/perms-notes.md — limites du détecteur d'ombrage
  • README.md — présentation · INSTALL.md — installer · DEPLOYMENT.md — maintenir/publier

Compact instructions

Conserver : l'État courant, les trois points de reprise, les décisions tranchées (main non protégée, exception eco, garde-fou sans notes, agents-sync fermée, un seul plugin) et les fichiers cibles. Supprimer : explorations sans suite, sorties de commandes, hypothèses abandonnées.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.