convention.sh

Was ist convention.sh?

convention.sh ist ein gehostetes Toolkit, das Coding Agents lehrt, konsistenteren, produktionsreiferen TypeScript zu erzeugen. Es stellt eine Bibliothek handtuningter TypeScript-Konventionen bereit, die Agents bei Bedarf abrufen können, statt auf ein statisches, promptbeschränktes Regelwerk angewiesen zu sein.

Der Kernzweck ist es, schlampigen TypeScript-Output zu reduzieren, indem Agents konkrete Konventionen erhalten – wie strengere Typisierungsmuster und Laufzeitvalidierungsansätze –, die über eine Standard-Schnittstelle geliefert werden.

Wichtige Funktionen

• Gehosteter MCP-Server für Konventionen: convention.sh läuft als gehosteter Model Context Protocol (MCP)-Server, den ein Agent für die benötigten Konventionsschnipsel abfragen kann.
• Abruf von Snippets bei Bedarf (27 Konventionen): Statt eine Wand aus Regeln in jeden Prompt einzubetten, ziehen Agents nur die relevanten Snippets aus einer Bibliothek von 27 Konventionen ab, wenn sie angefragt werden.
• Konventionen für TypeScript-Korrektheit: Die aufgeführten Konventionen betonen strenge Typisierung (Vermeidung von any), die Validierung unzuverlässiger Eingaben mit Zod und discriminated unions statt optionaler Felder.
• Modellkontext-Integration via MCP: Funktioniert mit jedem Agenten, der das Standard Model Context Protocol unterstützt, indem der MCP-Endpunkt in die Agentenkonfiguration eingefügt wird.
• Immer aktuell ohne Neudeployments: Da die Konventionen vom gehosteten MCP-Endpunkt serviert werden, werden Änderungen bei nachfolgenden Anfragen übernommen, ohne Prompt-Überarbeitungen oder App-Neudeployments.

So verwenden Sie convention.sh

1. Fügen Sie den MCP-Endpunkt zu Ihrem Agenten hinzu mit dem bereitgestellten Terminalbefehl, der den gehosteten Endpunkt registriert: claude mcp add conventiondotsh --transport http https://mcp.convention.sh.
2. Führen Sie Ihre üblichen TypeScript-Aufgaben in Ihrem Coding Agenten aus.
3. Lassen Sie den Agenten Konventionen bei Bedarf anfragen: Während einer Aufgabe fragt der Agent die spezifischen Konventionsschnipsel(s) vom convention.sh-Server ab, wenn er sie benötigt.

Falls Sie einen anderen MCP-fähigen Agenten als im Beispiel verwenden, konfigurieren Sie ihn so, dass er denselben gehosteten MCP-Endpunkt von convention.sh aufruft.

Anwendungsfälle

• Refactoring von TypeScript-Modulen mit einheitlichem Stil: Beim Generieren oder Aktualisieren von TypeScript-Code Konventionen anfragen, damit der Agent einheitliche Muster für Typisierung und Eingabevalidierung anwendet.
• Validierung unzuverlässiger Eingaben in API-Handlern: Konventionen nutzen, die Zod-Validierung empfehlen, um Eingabeprüfungen explizit und konsistent zu halten.
• Vermeidung von Mehrdeutigkeit bei optionalen Feldern: Beim Entwerfen von Datenshapes discriminated unions statt optionaler Felder bevorzugen, um Variantenbehandlung im generierten Code klarer zu machen.
• Reduzierung von Prompt-Bloat bei längeren Coding-Sessions: Agentenprompts fokussiert halten, indem der Agent nur bei Bedarf spezifische Konventionsschnipsel abruft.
• Teams standardisieren Agenten-Output: Dieselben Konventionsschnipsel von einem gemeinsamen gehosteten Endpunkt servieren, damit MCP-integrierte Agents maschinensynchron bleiben (Updates werden bei nächsten Anfragen übernommen).

FAQ

• Was bedeutet „on demand“ hier? Die Konventionen werden über einen gehosteten MCP-Server geliefert, und der Agent fordert während einer Aufgabe nur die benötigten Schnipsel(s) aus einer Bibliothek von 27 Konventionen an, statt jedes Mal ein vollständiges Regelwerk zu erhalten.

• Muss ich etwas selbst bauen oder hosten? Die Website beschreibt convention.sh als gehosteten MCP-Server, daher fügen Sie den Endpunkt zu Ihrem Agenten hinzu, statt die Konventionsbibliothek selbst zu hosten.

• Wie integriere ich es in meinen Coding Agenten? Verwenden Sie den MCP-Integrationsflow: Konfigurieren Sie einen MCP-fähigen Agenten für den gehosteten Endpunkt unter https://mcp.convention.sh. Die Seite enthält ein Beispielkommando zum Hinzufügen des MCP-Servers.

• Welche Arten von TypeScript-Regeln sind enthalten? Die Seite listet Beispiele für Konventionen mit Fokus auf strenge Typisierung (kein any), Validierung unzuverlässiger Eingaben mit Zod und discriminated unions statt optionaler Felder.

• Muss ich Prompts aktualisieren, wenn Konventionen ändern? Nein – da die Konventionen vom gehosteten MCP-Endpunkt serviert werden, nimmt der Agent neue Regeln bei der nächsten Anfrage auf, ohne Neudeployments oder veraltete Kopien über Maschinen.

Alternativen

• Statische Prompt-Regellisten oder Wikis: Sie können TypeScript-Richtlinien direkt in jeden Prompt einfügen, aber das erhöht den Prompt-Umfang und führt oft zu inkonsistenter Anwendung.
• Lokale Linting-/Formatierungs-Toolchains (z. B. TypeScript ESLint): Diese Tools erzwingen Stilregeln und erkennen Probleme nachträglich, während convention.sh Konventionen während der Codegenerierung über MCP bereitstellt.
• Andere retrieval-basierte Agent-Kontext-Tools: Wenn Sie bereits RAG oder tool-basiertes Kontext-Fetching für Coding nutzen, könnten Sie einen ähnlichen „Konventionen bei Bedarf abrufen“-Workflow aufbauen – allerdings müssten Sie die Konventionsbibliothek und die Retrieval-Logik selbst warten.