router-first-architecture

ルーター優先アーキテクチャ

個別のツールを使う前に、ドメインルーターを経由します。ルーターがツールの選択を抽象化します。

パターン

ドメインルーター（math-router など）は、ユーザーの意図を正確な CLI コマンドに決定論的にマッピングします。必ず最初にルーターを使い、例外的なケースでのみ迂回してください。

DO

• 数学の操作を行う前に、math-router route "<intent>" を呼び出します
• ドメインスキルを対応するルーターと同時に有効化します（skill-rules.json の coActivate を使用）
• ルーターの信頼度スコアを信頼し、command: null の場合にのみフォールバックします
• skill-rules.json のトリガーキーワード／パターンは、ルーティングパターンより広く設定します

DON'T

• ルーターが存在する場合に、個別のスクリプトを直接呼び出さないでください
• 個別のスキルにルーティングロジックを重複して実装しないでください
• ドメインスキルがルーターを迂回できるようにしないでください

同時有効化パターン

ドメインスキルは対応するルーターと同時に有効化する必要があります。

{
  "math/abstract-algebra/groups": {
    "coActivate": ["math-router"],
    "coActivateMode": "always"
  }
}

これにより、ドメインの知識が有効化されたときに、ルーターも常に利用可能になります。

2 層アーキテクチャ

1. スキルルールのトリガー層：キーワードや意図のパターンを使い、Claude がルーターを使用するよう促します
2. ルーターのルーティング層：正規表現パターンを使ってスクリプトへ決定論的にマッピングします

トリガー層はルーティング層より広く設定します。ルーターは「見つからない」場合も適切に処理できる必要があります。

ソースセッション

• 2bbc8d6e：「トリガー層がルーティング層より狭かった」— トリガーを拡張
• このセッション：8 つのドメイン数学スキルを math-router と同時に有効化するよう接続