Crag: オープンソースツールがプロジェクト設定から統一AIエージェントルールを生成

Cragの機能

Cragは、複数のAIコーディングエージェントのルールファイル間で発生する設定のずれを解決するオープンソースツールです。プロジェクトの既存の設定を分析し、統一されたガバナンスファイルを生成し、それをさまざまなAIエージェントが必要とするすべての特定のルールファイルにコンパイルします。

解決する問題

複数のAIコーディングエージェントを使用する開発者は、設定管理の課題に直面しています。ソースによると、ある開発者は4つのプロジェクトで合計48ファイル、12のルールファイルを管理していました。これには以下が含まれます：

• Claude Code用のCLAUDE.md
• Codex用のAGENTS.md
• Cursor用の.cursor/rules/
• Copilot用のcopilot-instructions.md
• ルールを強制するCIワークフロー

これらのファイルは時間とともにずれが生じ、リンタールールが一致しないためにエージェントが書いたコードがCIで拒否される問題が発生しました。この問題は「誰も12ファイルすべてを読まない」ため、気づかれませんでした。

Cragの仕組み

このツールには2つの主要なコマンドがあります：

• crag analyzeは、CIワークフロー、package.json、tsconfig、テスト設定を含むプロジェクトの設定を読み取ります
• crag compile --target allは、統一されたガバナンスファイルからすべてのルールファイルを生成します

分析により、以下を含む約80行のgovernance.mdファイルが生成されます：

• ゲート
• アーキテクチャガイドライン
• テストプロファイル
• コードスタイルルール
• 避けるべきアンチパターン
• フレームワークの慣例

出力は「自動生成され、シニアエンジニアが書いたように読める」と説明されています。

技術的な詳細

Cragにはいくつかの注目すべき技術的特徴があります：

• LLMは不要
• ネットワーク依存なし
• 依存関係ゼロ
• 決定論的な出力
• プラットフォーム間でSHA検証

試すには：npx @whitehatd/crag demo（@とwhitehatdの間のスペースを削除）

ソースと入手可能性

このツールはオープンソースで、GitHubで入手可能です：https://github.com/WhitehatD/crag。