Pathrule提案とセルフ監査
古くなったメモリやルールがリフレッシュタスクとしてフラグ付けされる仕組みと、それを自分のAIが自分の管理のもとで修正する方法を説明します。
チームのナレッジは放っておくと古くなります。パスの名前が変わり、マイルストーンはリリースされ、依存関係のバージョン固定はずれていき、ルールはいつの間にか何にもマッチしなくなります。これに対するPathruleの仕組みがリフレッシュタスクです。古くなっていそうなメモリやルールに、平易な言葉で書かれた理由とともにフラグを付け、それを自分のアシスタントが自分の管理のもとで修正します。
重要なのは、リフレッシュタスクはあくまで提案しかしないという点です。Pathruleがメモリ、ルール、スキルを勝手に編集したり削除したりすることはありません。
セルフ監査でチェックする内容
監査は、ずれに気づいた場所、つまり作業そのものの中で行われます。コードを読んでいるアシスタントは、メモリが移動済みのファイルについて書いていることや、ルールが現在のコードの動作と矛盾していることに真っ先に気づきます。通常の作業中にそうした状況に出会うと、アシスタントはpathrule_request_refresh MCPツールでそのエントリにフラグを付け、対象のメモリやルールと、どこがおかしいと考えたかを記録します。よくある理由は次のとおりです。
- ずれ。 エントリの内容が現在のコードと一致しなくなっています。たとえば、参照しているファイルが移動したか、もう存在しない場合です。
- コードとの矛盾。 エントリに書かれていることと、コードが明らかに違う動作をしています。
- 重複。 同じ内容を、別のメモリやルールがよりよい形ですでにカバーしています。
- 適用範囲が狭すぎる。 エントリが、とうに存在しないケースにしか当てはまりません。
- 不明瞭。 エントリが何を求めているのか判断できません。
フラグ付けは冪等です。同じエントリに2回フラグを付けても同じタスクが返されるため、セッションを繰り返しても重複したタスクがたまることはありません。アシスタントには、実際に気づいたずれにだけフラグを付け、わざわざ探しに行かないよう指示されています。
リフレッシュタスクには、ソースコードに関する情報は一切保存されません。保存されるのは対象エントリと理由だけで、あとで修正するアシスタントが自身のファイルツールで現在のコードを読み取ります。
提案の確認
リフレッシュタスクは判断を促すものであり、それ自体が何かを実行するわけではありません。Pathrule Cloudワークスペースでは、ターミナルからタスクを扱えます。
pathrule refresh list
pathrule refresh claim <refresh-id>
pathrule refresh resolve <refresh-id> --status applied
listは現在のワークスペースで保留中のタスクを表示し、claimは1件のタスクの詳細な概要を返してそのタスクを進行中にし、resolveはタスクをappliedまたはrejectedとしてクローズします。アシスタントはMCP経由で、pathrule_list_pending_refreshes、pathrule_get_refresh_brief、pathrule_resolve_refreshを使って同じことを行います。
各タスクについて、アシスタントに修正を適用させる（後述）、自分でエントリを編集する、エントリがまだ正しければタスクをrejectedにする、のいずれかを選べます。
アシスタントによる修正
Pathruleがナレッジを自動で書き換えることはありません。保留中のリフレッシュタスクを順に処理するようアシスタントに依頼すると、アシスタントは次のように進めます。
- 保留中のタスクを一覧表示し、1件を引き受けます。引き受けたタスクは進行中になるため、別のセッションが同時に同じタスクを取ることはありません。
- 自身のファイルアクセスツールで、現在のコードとフラグ付きのエントリを確認します。
- 更新内容を作成し、Pathruleの書き込みツールで書き戻します。更新時にタスクIDを渡すと、タスクはappliedとしてクローズされます。
- そうでない場合は、タスクを明示的にappliedまたはrejectedにします。
最初から最後まで主導権はあなたにあります。修正は自分のアシスタントを通じて行われ、変更は確認可能な通常のバージョン管理された編集です。アシスタントが使うリフレッシュ用ツールについては、MCPツールリファレンスを参照してください。
後戻りできない変更はない
修正は通常のバージョン管理された編集です。すべての変更は履歴が残り、Pathrule Cloudワークスペースでは削除したエントリも完全に削除されるまでワークスペースのアーカイブに残るため、オーナーまたは管理者がWebコンソールの設定から復元できます。VS Codeでは、削除するとすぐにUndoが表示されます。修正が間違っていたとわかった場合でも、ほかの編集と同じように元に戻せます。