intellectronica/ruler

解決する課題

AIコーディングアシスタントの指示を管理するのは困難です。なぜなら、各ツール（例：Cursor、Claude Code、Aider、GitHub Copilot）がそれぞれ異なる構成ファイルや形式を使用しているためです。これにより、指示の不整合や重複作業が発生し、プロジェクトの要件変更に伴う「コンテキストの乖離」が生じます。Rulerは、すべてのAI指示に対する単一の信頼できる情報源を提供し、各エージェントが必要とする正しい構成ファイルに自動的に配布します。

仕組み

Rulerはプロジェクト内の中心となる .ruler/ ディレクトリを使用し、そこにAIの指示をMarkdownファイルとして保存します。ruler apply コマンドを実行すると、ツールがこれらのルールを集約し、選択したAIエージェントが必要とする特定の構成ファイルに注入します。ネストされたルール読み込みをサポートしており、プロジェクトルートでグローバルルールを定義し、サブディレクトリ（src/ や tests/ など）でコンポーネント固有のルールによってそれらを上書きまたは拡張することが可能です。

対象ユーザー

このツールは、複数のAI支援コーディングツールを使用しており、手動で構成を更新することなく、プロジェクトのガイドライン、コーディング標準、アーキテクチャ上の制約をすべてのツール間で一貫して維持したい開発者やチーム向けに設計されています。

ハイライト

• 集中管理: すべてのAI指示を標準的なMarkdownファイルを使用して一箇所で管理します。
• 幅広いエージェントサポート: Cursor、Aider、Claude Code、GitHub Copilotなど、数十種類の人気AIコーディングエージェントと互換性があります。
• ネストされた構成: 階層的なルール読み込みをサポートしており、モノレポや複雑なコンポーネントを持つプロジェクトに最適です。
• 自動化されたワークフロー: MCP (Model Context Protocol) サーバー設定を自動的に処理し、.gitignore を更新して生成されたファイルがバージョン管理に含まれないようにします。
• 安全な復元: revert コマンドが含まれており、変更を簡単にロールバックして元の構成を復元できます。