Gentleman-Programming/gentle-ai

Gentle‑AI™ – 既存のAIコーディングエージェント向けエコシステム構成ツール

機能概要

• Gentle‑AI は自前のAIモデルを提供するものではありません。代わりに、すでにインストール済みのコーディングアシスタント（Claude Code、Cursor、OpenCodeなど）に、記憶、計画、スキルライブラリ、セキュリティガードレール、レビューワークフローといったオプション機能を追加します。
• ツールは小さなGoバイナリ（gentle-ai）として動作します。一度のインストール後、インタラクティブなターミナルUIを起動し、使用しているエージェントを選択し、プリセットまたは個別コンポーネントを選択します。その後、プログラムはエージェントのネイティブ設定ディレクトリに適切な設定ファイルを書き込みます。

主要コンポーネント

コンポーネント	機能
Engram™	再起動後も保持される永続的記憶。過去の決定、バグ修正、コンテキストをエージェントが記憶できます。
Skills	エージェントがタスクと一致したときに自動的に読み込む、選別されたコーディング「スキル」のライブラリ。
Persona	オプションの指導的ボイス（例：Gentleman またはニュートラル）でカスタマイズ可能。
Spec‑Driven Development (SDD)	大規模な機能向けの計画ワークフロー：探索 → 提案 → 要件定義 → 設計 → タスクリスト → 実装 → 検証。
Context7	セッション中にライブのフレームワークやライブラリドキュメントを取得するMCP（メタデータ中心プロキシ）サーバ。
Permissions	~/.ssh や .env などの機密パスへのアクセスを拒否するセキュリティガードレール。
GGA (Gentleman Guardian Angel)	AIプロバイダを切り替えるスイッチャーで、リクエストを異なるバックエンドにルーティング可能。
Theme	サポートされているエージェント（Claude Code、OpenCode）向けのオプションのビジュアルテーマ。

プリセットはこれらのコンポーネントをまとめて、迅速なセットアップを可能にします：

• full‑gentleman – すべて（記憶、SDD、すべてのスキルなど）
• ecosystem‑only – オプションの追加機能を除くコアコンポーネント
• minimal – EngramとSDDのみ
• custom – 任意の組み合わせを選択可能。

対応エージェント Gentle‑AIは、Claude CodeやOpenCode（サブエージェントをサポート）から、Windsurfのような単体エージェントツールまで、多数の既存コーディングエージェントに対応しています。各エージェントに対して、ネイティブな設定形式（例：CodexではTOML、Cursorでは~/.cursor/agents/配下のファイル）を生成し、エージェント独自の委任モデルを尊重します。

インストールと使用方法

1. 前提条件 – Node 18+、npm、Git 2.38+、およびGo 1.25.10+（Windowsまたはソースからビルドする場合のみ必要）。使用するAIエージェントはすでに PATH に登録されている必要があります。
2. バイナリのインストール – macOS/Linuxではワンライナーの curl … | bash、Windowsでは go install … を使用。
3. TUIの実行 – gentle-ai を実行すると、エージェント、コンポーネント、Personaを選択できます。設定ファイルの上書き前に既存の設定をバックアップします。
4. 検証 – gentle-ai doctor は読み取り専用のヘルスレポート（バイナリの存在、Engramの到達可能性、ディスク容量、破損したシンボリックリンクなど）を出力します。

判断の仕組み Gentle‑AIは、リクエストに応じて最小限のワークフローを選択するルーティングレイヤーを追加します：

• 小規模で範囲が明確な変更 → 直接インライン実行。
• 中規模の変更（4ファイル以上、広範な調査を伴う） → 追加のアーティファクトなしで、委任されたサブエージェントが処理。
• 不明確で大規模な機能 → エージェントがオプションのSDDワークフローを提示。承認されればのみ実行。 ルーティングの判断は、後のレビュー手順とは独立しています。

Spec‑Driven Development (SDD)

• 「SDDを使う」 と発言するか、エージェントの提案を受け入れることで開始。
• 永続的なアーティファクト（提案、要件定義、設計、タスクリスト）を生成。Engram、バージョン管理されたファイル（OpenSpec）、または両方に保存可能。
• オプションの Research lane で、監査可能な外部証拠を記録可能。
• TDDが有効な場合でも、後の Receipt‑Driven Development (RDD) レビューとは別個に動作。

Receipt‑Driven Development (RDD)（オプション）

• 実装後の証拠に基づくレビューを提供。
• 候補（変更されたバイト列）、凍結（開始時のスナップショット）、および レンズ（リスク、レジリエンス、可読性、信頼性）のセットを定義。
• レビュー作業量はファイル数ではなく、宣言されたリスクレベルに基づいて決定。
• 結果（情報的証拠）と 承認（エージェントがレビュー結果を記録した）を出力。

ドキュメントとコミュニティ

• 完全なドキュメントはリポジトリの docs/ フォルダとパブリックWikiにあります。
• 「doctor」コマンドでトラブルシューティングが可能。
• プロジェクトはMITライセンスで、macOS、Linux、Windowsをサポート。

結論 Gentle‑AIは、単体のAIコーディングアシスタントをより体系的な開発パートナーに進化させる設定レイヤーです。新しいモデルをインストールせずに、記憶、計画、スキル選択、およびオプションの証拠ベースレビューを追加します。