Add Convention

Gatekeeper for repo-konventioner: triagerer dubletter, dirigerer til den rigtige fil

Af EvolveHQ · EvolveHQ/docflow

Virker med opsætning ★ 8.0/10

Add Convention — Gatekeeper for repo-konventioner: triagerer dubletter, dirigerer til den rigtige fil

Hvad det gør

Del af docflow ADR-værktøjssættet. Før den skriver noget, læser den CONVENTIONS.md og AGENTS.md fuldt ud, argumenterer for, om den foreslåede regel overhovedet er værd at kodificere, og dirigerer den derefter til en AGENTS.md hard rule, en CONVENTIONS.md sektion, et GLOSSARY-term eller overdrager den som en ADR. Udløses af 'add a convention', 'make this a rule' eller 'we should always X', og virker kun i et repo, der allerede indeholder docflow scaffold.

Testrapport

Testet på et repo scaffolded med docflows egne skabeloner, hvor jeg bad om to regler på én gang: British English overalt, og Conventional Commits. Uden skillen tilføjede jeg begge som nye sektioner, hvilket efterlod commit-reglen angivet tre steder og lydløst fjernede den eksisterende obligatoriske 'Rationale:' footer; efter skillen blev dubletten afvist med en henvisning til den eksisterende Git Contract-sektion, og sprogreglen kom ind i den plads, CONVENTIONS.md allerede reserverer til den, spejlet som én AGENTS.md hard rule. Fangsten er forudsætningen: på et almindeligt repo uden CONVENTIONS.md eller AGENTS.md har skillen intet at læse og kan ikke fortsætte, så du skal køre docflows bootstrap først, og en kopi af denne ene skill alene inkluderer det ikke. Dens vurdering er også et multi-spørgsmålsinterview for, hvad der ofte er en enkeltlinjers regel.

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

Kommandoer og eksempelprompter

  • /add-conventionGatekeeper for repo-konventioner: triagerer dubletter, dirigerer til den rigtige fil

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

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