Add Convention

Gardien des conventions de dépôt : trie les doublons, achemine vers le bon fichier

par EvolveHQ · EvolveHQ/docflow

Fonctionne avec configuration ★ 8.0/10

Add Convention — Gardien des conventions de dépôt : trie les doublons, achemine vers le bon fichier

Ce que fait

Fait partie de la boîte à outils ADR docflow. Avant d'écrire quoi que ce soit, il lit CONVENTIONS.md et AGENTS.md en entier, argumente si la règle proposée vaut la peine d'être codifiée, puis l'achemine vers une règle stricte AGENTS.md, une section CONVENTIONS.md, un terme GLOSSARY, ou la transmet comme un ADR. Se déclenche sur 'add a convention', 'make this a rule' ou 'we should always X', et ne fonctionne que dans un dépôt qui contient déjà l'échafaudage docflow.

Rapport de test

Testé sur un dépôt échafaudé avec les propres modèles de docflow, demandant deux règles à la fois : l'anglais britannique partout, et les Conventional Commits. Sans la skill, j'ai ajouté les deux comme de nouvelles sections, ce qui a laissé la règle de commit énoncée à trois endroits et a discrètement supprimé le pied de page obligatoire 'Rationale:' existant ; en suivant la skill, le doublon a été rejeté avec un pointeur vers la section 'Git Contract' existante et la règle de langue est allée dans l'emplacement que CONVENTIONS.md lui réserve déjà, reflétée comme une règle stricte AGENTS.md. Le problème est la précondition : sur un dépôt simple sans CONVENTIONS.md ou AGENTS.md, la skill n'a rien à lire et ne peut pas continuer, vous devez donc d'abord exécuter le bootstrap de docflow, et une copie de cette seule skill ne l'inclut pas. Son évaluation est également un entretien multi-questions pour ce qui est souvent une règle d'une seule ligne.

Testé le: 2026-08-10 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/EvolveHQ/docflow.git
mkdir -p ~/.claude/skills
cd docflow && cp -r plugins/docflow/skills/add-convention ~/.claude/skills/add-convention

Commandes et exemples de prompts

  • /add-conventionGardien des conventions de dépôt : trie les doublons, achemine vers le bon fichier

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • Add a convention requiring British English spelling in our docs
  • Codify a Conventional Commits rule into AGENTS.md or CONVENTIONS.md
  • Should this proposed rule become a hard rule or just a glossary term?