install-maintenance-graft-rtk-ponytail-lite

プロンプト

# Verified Installation and Maintenance — Graft + RTK + Ponytail lite

現在のリポジトリで以下のスタックをインストール、更新、修復、または検証しています：

- Graft：コード理解、ローカルグラフ、LSP強化。
- RTK：ターミナルノイズ低減。
- Ponytail：liteポリシー、互換性がある場合はネイティブ統合。

まずは読み取り専用のインベントリから始めます。その後、以下の不足している質問をしてください。
回答を得たら、最終チェックまで許可された操作を実行します。

クライアントと範囲を決定する前にインストールを開始しないでください。
この会話で既に決定された事項については再度尋ねないでください。

## 1. インベントリ、次にユーザーの選択

### 変更なしのインベントリ

以下を特定してください：

- OS、アーキテクチャ、シェル、環境：ローカルマシン、WSL、SSH、コンテナ；
- リポジトリルート、ワークツリー、Gitステータスおよび進行中のGit操作；
- Git、Node、npm、RTK、Graft、および利用可能なクライアントの実際のパス、バージョン、インストール方法；
- Claude Code、Codex、Kimi、Cursor Agent CLI、Cursor IDEを個別に；
- Gemini、Copilot CLI、またはその他の既存のクライアント（オプション対象として）；
- 実際に使用されている設定ディレクトリ、リダイレクト変数、およびAgentsRoomなどのオーケストレーター；
- 既存のユーザー、プロジェクト、プラグイン、および継承されたフック設定。

`agent`の正体をCursorとして扱う前に検証してください。
バイナリが存在するだけでは認証、フックの機能、MCPの読み込みを証明しません。

このインベントリ中に自動更新、接続、インストールを開始しないでください。
秘密情報を公開しないでください。

短い表を提示してください：
クライアント | バイナリ/バージョン | 実効設定 | 既知の状態

### 一括で尋ねる質問

回答が不足している質問のみを尋ねてください：

1. 操作：
   - 不足コンポーネントをインストールし互換バージョンを維持。
   - スタックを検証済み安定バージョンに更新。
   - 既存インストールを修復しバージョンは維持。
   - 検証のみ、変更なし。

2. クライアント：
   - 検出されたすべてのクライアント。
   - 実際に検出されたリストからの選択。
   - 不在のクライアントの設定も準備。

3. 統合範囲：
   - 共有プロジェクト：リポジトリ向けのポータブル設定。
   - 個人プロジェクト：このリポジトリ向けの有効化、バージョン管理されていないローカルファイル。
   - グローバルユーザー：このユーザーのプロジェクト向け有効化。
   - 混合：クライアントまたはコンポーネントごとの個別選択。

範囲が混合の場合は必要な明確化のみ尋ねてください。

更新の場合は、既知でなければバージョン制約も尋ねてください。
そうでなければ明示的な安定バージョンを提案してください。

クライアントアプリケーション自体はインストールまたは更新しないでください：
操作対象はGraft、RTK、Ponytailおよびそれらの必要な依存関係です。
古いクライアントは必要なバージョンと残る対応と共に報告されます。

### 選択を具体化する

書き込む前に計画結果を表示してください：

コンポーネント/クライアント | 目標バージョン | 範囲 | 対象ファイル | 共有効果 | フォールバック

特に説明する点：

- ユーザーレベルにインストールされた実行可能ファイルは複数リポジトリで利用可能。
- この実行可能ファイルの更新はすべてのローカルユーザーに影響。
- プラグインはグローバルキャッシュを持つがプロジェクトごとに有効化。
- プロジェクトごとのフックは共有状態を使う場合もある。
- Graftインデックスはリポジトリ/ワークツリー固有。
- オーケストレーターが提供するグローバル設定はプロジェクトに隔離可能：名前だけでなく実際の範囲を検証。

選択を得たら繰り返し確認せずに進めてください。
範囲の拡張や物理的な解決策の変更が必要な場合のみ新たな決定を求めてください。

## 2. 実行ルール

順序：
インベントリ → 選択 → バックアップ → RTK → Graft/LSP → Ponytail → 指示 → 検証 → レポート。

リポジトリの指示と管理ポリシーを尊重してください。
ファイルがAgentsRoomや他のオーケストレーターで管理されている場合は、公式の仕組みを使い、生成ファイルを直接変更しないでください。

変更前に：

- JSON/JSONC/TOML設定のフォーマットと構造を検証；
- 影響を受けるファイルをリポジトリ外にバックアップしアクセス制限；
- ロールバックに必要なバージョンと要素を記録；
- インストーラーのドライランがあれば確認。

無効なファイルは空の設定で置き換えないでください。

他のMCP、フック、権限、指示、コメント（可能な限り）、状態行を保持しつつ設定をマージ。
承認ルールや信頼フィンガープリントは変更しないでください。

既存のGit変更を保持。コミット、プッシュ、リセット、クリーン、スタッシュ、アプリケーションコードの変更は行わない。
未解決のコンフリクトや進行中のGit操作がある場合はリポジトリへの書き込みを停止し、独立した診断を続行。

Graphify、CodeGraph、Caveman、Headroomはインストールしない。
古い競合統合は正確に特定しバックアップし許可された範囲内でのみ削除。
他で使われているツールをグローバルにアンインストールしない。

エラーは依存するステップをブロックし、他の独立したクライアントは影響を受けない。
制限を回避するためにステップを成功と宣言しないでください。

## 3. 機能と範囲：設定前に検証

インストール済みバージョンのヘルプと使用する公開バージョンのドキュメントを参照してください：

- https://github.com/rtk-ai/rtk
- https://github.com/trailhq/Graft
- https://github.com/DietrichGebert/ponytail
- 選択した各クライアントの公式ドキュメント。

main/developブランチはリリースにない機能を記述している場合があります。
疑わしいオプションはリリース、ヘルプ、または配布コードを確認してください。

各統合について以下を確立してください：

クライアント | 利用可能なプロジェクトフック | 互換インストーラー |
有効化範囲 | 状態範囲 | 証拠

以下を混同しないでください：
「クライアントがプロジェクトフックを受け入れる」
と「このツールのインストーラーがプロジェクトレベルでそれらをインストールできる」

現在のバージョンで再検証すべきチェックポイント：

- Claude: ユーザー設定、共有プロジェクト、ローカルプロジェクト。
- Cursor: ユーザーおよびプロジェクトのフック；IDEとCLIを別々にテスト。
- Codex: ユーザー/プロジェクトの設定とプラグインの有効化；
  実際に利用可能なフック機構を検証。
- Kimi: プロジェクトごとのフック設定を前提としない；
  ユーザー設定、プロジェクト指示、起動オプションを区別。
- Gemini/Copilot: 選択された場合はそれぞれの機構を検証。

インストーラーが要求されたスコープを尊重しない場合：

1. 適切な公式オプションを探す。
2. それ以外は、同じアダプターのドキュメント化された手動設定を使用するが、
   プロトコルとパスが互換性を保つ場合に限る。
3. それ以外は、明示的な指示/プレフィックスによるフォールバックを使用。
4. グローバルに静かに切り替えることは絶対にしない。

ローカルの同等フックを追加する前に継承されたグローバルフックを検査する：
互いに置き換えるのではなく累積する可能性がある。
セキュリティフックは保持する。残存するグローバル効果を報告。

## 4. RTK

origin `rtk-ai/rtk`、バージョン、ヘルプ、設定、`rtk gain`を確認。
`gain`の失敗はベースや権限に起因する可能性があり、
それだけでパッケージの不良の証明にはならない。

適切なら既に使用しているマネージャーでインストールまたは更新。
フォーミュラやパッケージのoriginと取得したバージョンを確認。
同時インストールや不要なPATH変更は避ける。
`cargo install rtk`を盲目的に実行しない。

選択したバージョンの`rtk init --help`を参照。
クライアントとスコープでオプションを選択；ドキュメント例の`-g`を
常にコピーしない。

Codex統合が常に単純な指示であるとは限らず、
常にフックを持つわけでもない：RTKのバージョンによる。
初期化オプション間の非互換性も確認。

実際に読み込まれた設定で除外をマージ：

    [hooks]
    exclude_commands = ["graft", "curl", "playwright"]

既存の除外を保持し、その考慮を検証。
この設定がグローバルなら、変更前にその効果を示す。
許可されたスコープ内でドキュメント化された方法で
オプションのテレメトリを無効化。

RTKはシェルコマンドを書き換える唯一のコンポーネント。
セキュリティ、監査、承認フックは引き続き適用される。

ドキュメント化された互換性なしにClaudeフックを他のクライアントにコピーしない。
効果的な書き換えなしに明示的なプレフィックス`rtk`を設定。
二重フックや二重プレフィックスは避ける。

## 5. Graft with LSP

### インストールとプライバシー

パッケージ`@nanonets/graft`の身元、公開バージョン、Node要件を検証。

アプリケーション依存外の適切な場所にインストール。
Graftのインストールにpackage.jsonやプロジェクトロックファイルを変更しない。

最初の起動時とMCPで`DO_NOT_TRACK=1`を適用。
利用可能なら公式のテレメトリ無効化コマンドを使用。

Brain、アカウント、LLM強化、`--deep`は有効化しない。
ネットワークゼロを約束せず、検証も行わない。

`graft init`を自動実行しない。
明示的な配線を優先；インストーラーはリポジトリ外に書き込む可能性がある。

### 真に運用可能なLSP

アプリケーションコードを調査する前に、リポジトリのGraftルールを尊重。
次に有用な言語を特定し、選択したGraftバージョンのLSP統合を参照。

既に存在する互換サーバーを再利用。
必要なサーバーのみを、記録されたバージョンで、可能ならアプリ依存外にインストール。

以下を確認：

- 実行ファイルとそのバージョン；
- Graft/MCPプロセスのPATHでの利用可能性；
- 言語とワークスペースの前提条件；
- このGraftバージョンでのサポート。

ヘルプを読んだ後、以下のオプションがあれば特に使用：

    graft build --lsp --no-ignore --no-gitignore
    graft check
    graft ask "Where are the main entry points and API routes, if any?" --source

これらのコマンドに現在のシェル構文でDO_NOT_TRACKを適用。

オプションの意味を確認：一部のバージョンでは
`--no-ignore`と`--no-gitignore`は除外ファイルの書き込みを防ぐだけで、
「無視されたファイルをインデックスする」意味ではない。

選択したスコープに応じて`/graft/`のGit除外を明示的に管理。
Gitで検証。既に追跡されているファイルを自動で削除しない。
注釈や人間のコンテンツを保持。

`--lsp`付きビルドで終了コード0はLSP使用の証明ではない。
対象の証拠を探す：実際にサーバーが起動、解決結果、強化されたエッジや
ドキュメント化された診断。

言語別に報告：
LSP検証済み / 強化なしで利用可能 / 利用不可 / 非対応。

コンテキストでグラフ全体やwiring.jsonを読み込まない。
自動リフレッシュ後にLSP強化が持続するかも確認；
保証されなければ明示的な再構築が必要と記録。

### MCPと鮮度

クライアントごとに単一の有効なGraftエントリを設定。
実際にサポートされるファイル、スキーマ、スコープを発見。

各サーバーについて、
インストール済みコマンド、MCP引数、DO_NOT_TRACK、PATH、作業ディレクトリを検証。

`.kimi-code/mcp.json`、`.mcp.json`などのファイルが自動で読み込まれるとは限らない：
クライアント機構や必要な起動オプションを確認。

グローバルMCP設定は、対象プロセスが各リポジトリを正しく扱う場合のみ許容。
そうでなければ、MCPはプロジェクトレベルに保持。

毎回の起動で`npx -y ...@latest`を使わない。
絶対パスや秘密情報をバージョン管理しない。
普遍的な変数`${workspaceFolder}`を作らない。

このプロファイルではGraftフックを追加しない。
スマートグレップ、グレップリダイレクト、Graftシェルインターセプトなし。

リフレッシュと意図しない無効化の不在を確認。
リフレッシュ失敗はグラフを新鮮と見なすことを禁ずる。

移行前に古い統合と自動配線メタデータを検査。
特定しバックアップした要素のみ削除。
MCP起動とクエリ後に再出現しないことを確認。

### Graft統計

操作、観察された使用状況、統計収集を分離。

バージョンによっては、`graft stats` はセッションフックに依存します。
これらのフックがない場合、Graftリクエストが成功していても「まだセッションが記録されていません」というメッセージが表示されることがあります。

統計を捏造したり、このメッセージを消すために `graft init` を実行したりしないでください。

ユーザーがネイティブ統計を必要とする場合は、利用可能な計測フックの互換性を明示し、フックなしでのプロファイル進化を明示的に要求してから有効化してください。

## 6. Ponytail lite

クライアントとスコープに対応した公式統合を優先してください。
マニフェスト、イベント、依存関係を確認してください。

以下を区別してください：
プラグインのインストール、アクティベーション、デフォルトモード、現在のモード状態。

実際に読み込まれているソースを検査してください：
設定、`PONYTAIL_DEFAULT_MODE`、永続状態、プラグインデータ。
`defaultMode: lite` は古いフル状態が置き換えられたことを証明しません。

モードが会話間で共有されている場合はそれを示してください。
プロジェクトスコープではグローバルデフォルトを黙って変更しないでください。
文書化されたローカルメカニズムか、指示によるliteポリシーを使用してください。

クライアント別：

- Claude/Codex: 利用可能なスコープでの公式インストールとアクティベーション。
  使用前にサブコマンドを確認してください。
  フックの承認はユーザーに委ねられます。
- Cursor: 公式アダプターまたは指示ルール；累積を避けてください。
  `scripts/cursor-hooks.js install --project` が存在する場合は、
  公式チェックアウトパスを使いターゲットリポジトリのルートからスクリプトを実行してください。
  `--project` がない場合はユーザーの宛先を確認してください。
  生成されたパスを検査してください：絶対パスを含むプロジェクトフックはポータブルではなく、コミットしてはいけません。
- Kimi: 互換性のある公式アダプターを探してください。なければ、AGENTS.mdのliteポリシーに従い、
  役立つ場合のみ最小限のローカルスキルを追加し、その形式と読み込みが確認されている場合に限ります。
  ネイティブコマンドや統計を約束せず、適応として識別してください。
- その他の選択されたクライアント：同じ検証を適用し、Claude/Codexのイベントを自動的に転用しないでください。

アダプターのチェックアウトは識別されたバージョンまたはコミットに固定してください。
変更されたチェックアウトで git pull をしないでください。
ステータスラインや視覚的インジケーターを追加しないでください。

新しいセッションで実際のモードをテストしてください。

## 7. コンパクト共通指示

AGENTS.md内で以下の区切りで囲まれたブロックをマージしてください：

    <!-- agent-stack:start -->
    ...
    <!-- agent-stack:end -->

すべての外部コンテンツと人間による追加を保持してください。
このインストールプロンプトをエージェント指示にコピーしないでください。

ブロックは以下を表現しなければなりません：

### Graft

コードを理解または修正するには、まずアプリケーションの探索を行います：
`graft ask "<precise question>" --source` または実際に公開されているMCP Graftツールを使用します。

指示、スキル、Git、設定、MCPの探索が先行することがあります。
方向付け後、直接有用な部分を読みます。
呼び出し元には利用可能なトレースコマンド/ツールを使用してください。

古いグラフの場合：チェックし、LSPで適応的に再構築し、その後新しいクエリを行います。
検索に失敗した場合：ターゲットを絞った graft grep、その後直接読み取り
または制限付きrgで制限の説明を行います。

提供されたファイル、スタックトレース、設定、または未インデックスの言語は
直接ターゲットを絞った読み取りを可能にします。
グラフに存在しないことはコードや呼び出し元が存在しないことを証明しません。

修正後：graft blast、検証済みGitベース、関連テストを行います。
--nameなし、完全なグラフ読み込みなし。
実際の呼び出し回数とエラーを報告してください。

### RTK

検証済みフック：二重プレフィックスなしで書き換えを許可します。
そうでなければ：互換性のあるコマンドに明示的にプレフィックスを付けます。
GraftをRTK経由で渡さないでください。

完全な出力には：利用可能なら --full を再呼び出し、またはプロキシを使用します。
副作用のあるコマンドを自動的に再実行しないでください。
パイプラインとリダイレクションを保持してください。

検証前に：実際の非圧縮差分、diff --cached、
diff --check と新規ファイルの個別検査を行います。
自動ステージングは行いません。

### Ponytail lite

要求を正しく実装し既存のものを再利用してください。
大幅に簡素な解決策を簡潔に報告してください。
検証、安全性、権限、アクセシビリティ、トランザクション
および必要なテストを保持してください。削除やインライン化前に使用状況を確認してください。

明示的な要求がある場合のみフルを行い、デフォルトでウルトラは行いません。
監査は再設計を引き起こしません。
修正はセキュリティ、パーサー、並行処理、マイグレーションを優先します。

共有モードが会話ローカルであると主張しないでください。
許可されたフルの後、liteに戻ることを確認してください。
オフは既に注入された指示を削除しません。

### ローディング

各クライアントが実際にこれらの指示をどのように読み込むかを確認してください。
文書化された最小限のインポート/アダプターを使用してください。
重複や循環インポートを避けてください。

RTKは唯一のシェル書き換えツールとして残ります。
このプロファイルにGraftフックはありません。

## 8. 更新と修復

同じプロンプトは重複なしで再実行可能でなければなりません。

更新モードでは：

1. スコープの選択と以前に検証された状態を再読込します。
2. インストール済みバージョン、ターゲットバージョン、不整合な変更を比較します。
3. マイグレーション前にバックアップを取ります。
4. 選択されたコンポーネントのみを更新します。
5. 公式メカニズムでプラグイン/アダプターを更新します。
6. 機能を再評価します：古いフォールバックは同じスコープ内で
   現在利用可能なネイティブ統合に置き換えられることがあります。
7. このスタックに属するキーとブロックのみをマイグレーションします。
8. 必要に応じてグラフを再構築しLSPを再チェックします。
9. 必要なMCP/クライアントプロセスを再起動します：
   既存のプロセスがまだ古いバージョンを実行している可能性があります。
10. 変更された統合のチェックとテストを再実行します。

既に準拠しているコンポーネントを不必要に再インストールしないでください。
マシンのパッケージの一般的な更新を起動しないでください。

修復モードでは、実証された非互換性と明示的な更新決定を除きバージョンを維持します。

ターゲットを絞ったロールバックを準備してください：以前のバージョン、バックアップ、
正確なコマンド。バックアップ以降に他の変更があった場合は
ファイル全体を盲目的に復元しないでください。

要求された変更なしの2回目の実行は
フック、MCPサーバー、重複した指示セクションを作成してはいけません。

## 9. チェックと証拠

別々にテストしてください：

- RTKの実行可能かつ明示的な圧縮;
- 自動フックのトリガー、除外、および生のパススルー;
- Graft: 新鮮さ、リポジトリと一致する結果、LSPの強化;
- MCP: 機能的なサーバーかつ各クライアントでの実際の読み込み;
- Ponytail: アクティベーションと効果的なモード;
- 重複の不在と再発した自己配線の不在;
- 設定の最終的な有効性と効果的な範囲。

現在のファイルは読み込みの証明ではありません。
外部のMCPプローブはクライアントでの読み込みの証明ではありません。
明示的なRTKプレフィックスは自動フックの証明ではありません。

利用可能かつ認証済みの各クライアントについて、
リポジトリ内で新しいセッションを開き、通常の保護を行い、以下の中立的なチケットを渡します:

「コードを変更せずに、主なエントリーポイントを特定してください。
APIがある場合は、そのルートがどこにマウントされているかを示し、
ビジネスロジックへの経路をたどってください。ファイル名と行番号を引用してください。」

「use Graft」を追加しないでください。
内部の推論ではなく、見えるツール呼び出しを検査してください。
最小限の証拠を保持し、機密データは編集してください。

承認、ログイン、またはUI操作が欠けている場合:
未テスト / ユーザー操作、成功は決して仮定しないでください。

## 10. 納品物

許可された範囲内で、短いメンテナンスドキュメントを保持してください:

- 操作の選択、クライアント、および範囲;
- 正確なバージョン、起源、および検証日;
- 設定メカニズムと制限;
- Graft/LSPの再構築;
- 更新、検証、およびロールバック手順。

共有インストールの場合は `docs/agent-stack.md` を使用してください。
個人用/グローバルインストールの場合は、マシン固有の情報を
バージョン管理されたファイルから除外してください。
検証のみのモードでは、これらのファイルを作成せずにレポートを納品してください。

決定的なコマンド、その結果、変更されたファイル、
バックアップ、および正確なユーザー操作を報告してください。

最終的なフックを一覧化してください:
クライアント、起源、範囲、イベント、マッチャー、ロール、および編集済みコマンド。

以下で締めくくってください:

Client/version | Effective scope | Present configuration |
MCP loaded | Graft observed on first exploration |
LSP | RTK | Ponytail | Remaining proof/action

明示的な状態を使用してください:
CONFIGURED / LOADED / USAGE OBSERVED / NOT TESTED / BLOCKED / NOT APPLICABLE.

ファイルを分類してください:
レビュー後にコミットするもの / 無視するもの / マシン設定。

個人のパス、シークレット、キャッシュ、グラフ、バックアップ、およびトランスクリプトは
コミット対象のファイルに含めてはいけません。

最終的なGitステータスとこの介入によって導入された変更を表示し、
既存の変更と区別してください。何もコミットしないでください。

タグ