Add Convention

Gatekeeper för repo-konventioner: triagerar dubbletter, dirigerar till rätt fil

av EvolveHQ · EvolveHQ/docflow

Fungerar med konfiguration ★ 8.0/10

Add Convention — Gatekeeper för repo-konventioner: triagerar dubbletter, dirigerar till rätt fil

Vad den gör

En del av docflow ADR-verktygslådan. Innan den skriver något läser den CONVENTIONS.md och AGENTS.md i sin helhet, argumenterar om den föreslagna regeln är värd att kodifiera överhuvudtaget, dirigerar den sedan till en AGENTS.md hård regel, en CONVENTIONS.md sektion, en GLOSSARY-term, eller överlämnar den som en ADR. Utlöses av 'lägg till en konvention', 'gör detta till en regel' eller 'vi borde alltid X', och fungerar endast i ett repo som redan innehåller docflow-ställningen.

Testrapport

Testades på ett repo ställningsbyggt med docflows egna mallar, och bad om två regler samtidigt: British English överallt, och Conventional Commits. Utan färdigheten lade jag till båda som nya sektioner, vilket lämnade commit-regeln angiven på tre ställen och tyst tog bort den befintliga obligatoriska 'Rationale:'-fotnoten; efter färdigheten avvisades dubbletten med en pekare till den befintliga Git Contract-sektionen och språkregeln hamnade i den plats CONVENTIONS.md redan reserverar för den, speglad som en AGENTS.md hård regel. Haken är förutsättningen: på ett vanligt repo utan CONVENTIONS.md eller AGENTS.md har färdigheten inget att läsa och kan inte fortsätta, så du måste köra docflows bootstrap först, och en kopia av denna enda färdighet inkluderar det inte. Dess bedömning är också en intervju med flera frågor för vad som ofta är en enradsregel.

Testad: 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

Kommandon och exempelprompter

  • /add-conventionGatekeeper för repo-konventioner: triagerar dubbletter, dirigerar till rätt fil

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

  • 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?