Add Convention
Gatekeeper für Repo-Konventionen: sortiert Duplikate, leitet zur richtigen Datei
Funktioniert mit Setup
Was es kann
Teil des docflow ADR-Toolkits. Bevor etwas geschrieben wird, liest es CONVENTIONS.md und AGENTS.md vollständig, argumentiert, ob die vorgeschlagene Regel überhaupt kodifiziert werden sollte, und leitet sie dann an eine AGENTS.md Hard Rule, einen CONVENTIONS.md Abschnitt, einen GLOSSARY-Begriff oder übergibt sie als ADR. Wird bei 'add a convention', 'make this a rule' oder 'we should always X' ausgelöst und funktioniert nur in einem Repo, das bereits das docflow-Gerüst enthält.
Testbericht
Getestet an einem mit docflow-eigenen Vorlagen gerüsteten Repo, wobei zwei Regeln gleichzeitig angefragt wurden: British English überall und Conventional Commits. Ohne den Skill fügte ich beide als neue Abschnitte hinzu, wodurch die Commit-Regel an drei Stellen stand und der bestehende obligatorische 'Rationale:'-Footer stillschweigend weggelassen wurde; dem Skill folgend wurde das Duplikat mit einem Verweis auf den bestehenden Git Contract-Abschnitt abgelehnt, und die Sprachregel kam in den dafür bereits in CONVENTIONS.md vorgesehenen Slot, gespiegelt als eine AGENTS.md Hard Rule. Der Haken ist die Vorbedingung: In einem einfachen Repo ohne CONVENTIONS.md oder AGENTS.md hat der Skill nichts zu lesen und kann nicht fortfahren, daher muss man zuerst docflow's Bootstrap ausführen, und eine Kopie dieses einen Skills allein enthält es nicht. Seine Bewertung ist auch ein Mehrfachfragen-Interview für das, was oft eine einzeilige Regel ist.
Getestet am: 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
Befehle & Beispiel-Prompts
/add-conventionGatekeeper für Repo-Konventionen: sortiert Duplikate, leitet zur richtigen Datei
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
Add a convention requiring British English spelling in our docsCodify a Conventional Commits rule into AGENTS.md or CONVENTIONS.mdShould this proposed rule become a hard rule or just a glossary term?