Add Convention

Strážce konvencí repozitáře: třídí duplikáty, směruje do správného souboru

od EvolveHQ · EvolveHQ/docflow

Funguje s nastavením ★ 8.0/10

Add Convention — Strážce konvencí repozitáře: třídí duplikáty, směruje do správného souboru

Co umí

Součást sady nástrojů docflow ADR. Před napsáním čehokoli přečte CONVENTIONS.md a AGENTS.md v plném rozsahu, argumentuje, zda navrhované pravidlo stojí za kodifikaci, poté ho směruje na tvrdé pravidlo AGENTS.md, sekci CONVENTIONS.md, termín GLOSSARY nebo ho předá jako ADR. Spouští se na 'add a convention', 'make this a rule' nebo 'we should always X' a funguje pouze v repozitáři, který již obsahuje docflow scaffold.

Testovací report

Testováno na repozitáři scaffoldovaném vlastními šablonami docflow, s požadavkem na dvě pravidla najednou: British English všude a Conventional Commits. Bez dovednosti jsem obě připojil jako nové sekce, což zanechalo pravidlo commitu uvedené na třech místech a tiše vynechalo existující povinnou patičku 'Rationale:'; po použití dovednosti byl duplikát odmítnut s ukazatelem na existující sekci Git Contract a jazykové pravidlo se dostalo do slotu, který pro něj CONVENTIONS.md již rezervuje, zrcadleno jako jedno tvrdé pravidlo AGENTS.md. Háček je v předpokladu: na prostém repozitáři bez CONVENTIONS.md nebo AGENTS.md nemá dovednost co číst a nemůže pokračovat, takže musíte nejprve spustit docflow bootstrap, a kopie této jedné dovednosti sama o sobě ho neobsahuje. Její hodnocení je také vícedotazový rozhovor pro to, co je často jednořádkové pravidlo.

Testováno: 2026-08-10 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /add-conventionStrážce konvencí repozitáře: třídí duplikáty, směruje do správného souboru

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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