convention.sh

convention.shとは？

convention.shは、コーディングエージェントに一貫した実運用向けTypeScriptを生成させるためのホスト型ツールキットです。手動調整されたTypeScript規約のライブラリを提供し、エージェントがオンデマンドで取得可能で、静的なプロンプトサイズのルールセットに頼る必要がありません。

主な目的は、エージェントに具体的な規約（例: 厳格なタイピングパターンやランタイム検証アプローチ）を提供し、雑なTypeScript出力を減らすことです。これを標準インターフェース経由で配信します。

規約のためのホスト型MCPサーバー: convention.shはホスト型Model Context Protocol (MCP)サーバーとして動作し、エージェントが必要な規約スニペットをクエリできます。
オンデマンドスニペット取得（27規約）: プロンプトにルールの一山を埋め込む代わりに、エージェントは27規約のライブラリから必要なスニペットのみをリクエスト時に取得。
TypeScriptの正確性を重視した規約: 厳格なタイピング（any回避）、Zodによる信頼できない入力の検証、任意フィールドよりdiscriminated unionsを優先する規約を強調。
MCP経由のモデルコンテキスト統合: Standard Model Context Protocol対応の任意のエージェントで動作。MCPエンドポイントをエージェント設定に追加するだけ。
再デプロイ不要で常に最新: ホスト型MCPエンドポイントから規約を提供するため、変更は次のリクエストで反映され、プロンプトリライトやアプリ再デプロイ不要。

エージェントにMCPエンドポイントを追加 提供されたターミナルコマンドでホストエンドポイントを登録: claude mcp add conventiondotsh --transport http https://mcp.convention.sh。
通常のTypeScriptタスクを実行 コーディングエージェントで開始。
エージェントが必要に応じて規約をリクエスト: タスク中に、convention.shサーバーから必要な特定規約スニペット（複数可）をエージェントが要求。

例と異なるMCP対応エージェントを使用する場合、同じホスト型MCPエンドポイントをconvention.shで指定して設定してください。

一貫したスタイルでTypeScriptモジュールをリファクタリング: TypeScriptコード生成/更新時に規約をリクエストし、タイピングと入力検証に同一パターンを適用。
APIハンドラーでの信頼できない入力検証: Zod検証を推奨する規約を使い、入力チェックを明示的・一貫的に保つ。
任意フィールドの曖昧さ回避: データ形状設計時、任意フィールドよりdiscriminated unionsを優先し、生成コードでのバリアント処理を明確に。
長時間のコーディングセッションでのプロンプト肥大化削減: 必要な時だけエージェントが特定規約スニペットを取得し、プロンプトを集中。
チームでのエージェント出力標準化: 共有ホストエンドポイントから同一スニペットを提供し、MCP統合エージェントをマシン間で同期（更新は次リクエストで反映）。

ここでの「オンデマンド」とは？ ホスト型MCPサーバー経由で規約を配信。エージェントはタスク中に27規約ライブラリから必要なスニペットのみをリクエストし、全ルールセットを毎回受け取らない。
自分でビルドやホストが必要？ convention.shはホスト型MCPサーバーとして記述されているため、エージェントにエンドポイントを追加するだけで、自分で規約ライブラリをホスト不要。
コーディングエージェントとの統合方法は？ MCP統合フロー使用: MCP対応エージェントをhttps://mcp.convention.shのホストエンドポイントで設定。ページにMCPサーバー追加コマンド例あり。
どのようなTypeScriptルールが含まれる？ ページに例示された規約: 厳格タイピング（anyなし）、Zodによる信頼できない入力検証、任意フィールドよりdiscriminated unions優先。
規約変更時にプロンプト更新が必要？ 不要—ホスト型MCPエンドポイントから規約を提供するため、エージェントは次リクエストで新ルールを取得。再デプロイやマシン間陳腐コピー不要。

静的プロンプトルールリストやWiki: 各プロンプトにTypeScriptガイドラインを直接含められますが、プロンプトの肥大化を招きやすく、一貫性のない適用になりがちです。
ローカルリンター/フォーマッティングツールチェーン（例: TypeScript ESLint）: これらのツールはスタイルを強制し、問題を事後的に検出しますが、convention.shはMCP経由でコード生成時に規約を提供します。
その他の検索ベースのエージェントコンテキストツール: RAGやツールベースのコンテキスト取得をすでに使用している場合、「必要な規約をフェッチ」ワークフローを自作できますが、規約ライブラリと検索ロジックのメンテナンスが必要です。