maintain-agentic-system

エージェントシステムの保守

このスキルは、既存のリポジトリ内エージェントシステムをアップグレード、発展、監査する際に使用します。

ミッション

リポジトリで意図的に加えられた変更を失うことなく、生成済みシステムを前進させます。すべての提案では、Bootstrap が書き込んだ保守ベースラインと三者間マージを行います。これにより、アップグレードがカスタマイズを誤って上書きすることも、カスタマイズがアップグレードを黙って阻害することもありません。

譲れない原則

• エージェントシステムのファイルのみを保守します。アプリケーションコード、スキーマ、マイグレーション、ランタイム設定、製品テストには決して触れません。
• セッションフォルダーの内容を読み取ったり、列挙したり、変更したりしません。セッションルートは設定されたパスであり、証拠の情報源ではありません。
• 保守計画を作成し、ファイルを編集する前に明示的な承認を待ちます。承認はデフォルトで false です。
• ベースラインと比較して、領域ごとに判定します。上流のみで変更された領域は採用し、リポジトリのみで変更された領域は維持し、両方で変更された領域は確認事項とします。
• changelog の記述だけを根拠に、Bootstrap の差分が欠落していると判断してはいけません。まずリポジトリのファイルを確認します。
• 生成システムのチェックリストを再掲してはいけません。これは兄弟の Bootstrap スキルの監査契約に記載されています。不合格のチェック項目を参照してください。
• ベースライン、回答ファイル、カスタマイズ登録簿を更新するのは、ユーザーが変更を承認した後に限ります。承認前には更新しません。
• プラットフォームの変更は、兄弟の Bootstrap 互換性契約に基づいて評価します。宣言された置換箇所以外では正規のコピーをそのまま保持し、レガシーの差異は、黙って適合認定するのではなく、見える競合として残します。

契約ファイル

このファイルはルーターです。現在のゲートに対応する契約を読み込み、最初にすべてを読み込んではいけません。

契約	読み込むタイミング
contracts/modes-and-scope.md	ゲート 0～2：モードの選択、対象範囲の境界、システムの検出、サブエージェントへの委任。
contracts/merge-model.md	ゲート 3～5：三者間マージ、領域、競合、カスタマイズ登録簿、ベースラインの更新。
contracts/delta-audit.md	ゲート 3～6：差分の収集と分類、計画の形式、最終検証。

レイアウトの分離、保守のエントリーポイント、旧式の混在システムの移行については、兄弟の bootstrap-agentic-system/contracts/context-boundaries.md を読み込みます。保守の実行は、対象範囲内の証拠の読み取りを許可します。監査モードでは書き込みを行いません。

環境の選択、最新ドキュメントの調査、ネイティブアダプター、保持チェック、バージョン 1 の回答の移行については、兄弟の bootstrap-agentic-system/contracts/platform-compatibility.md を読み込みます。プラットフォーム固有の指示をここで管理するのではなく、この契約を再利用してください。

生成システムの契約自体は、ここでは重複させていません。完全な生成システムに必要な要件を確認する場合は、兄弟の bootstrap-agentic-system/contracts/audit-and-handoff.md を読み込みます。

メンテナンスゲート

ゲートは順番に実行します。各項目には、ゲートの目的と、それを規定する契約が記載されています。

• Gate 0, スコープの確認：これがエージェントシステムのメンテナンスであることを確認し、モードを決定します。contracts/modes-and-scope.md を参照してください。
• Gate 1, システムの検出：既存のシステムを見つけ、メンテナンスベースラインのどの部分が存在するかを記録します。contracts/modes-and-scope.md を参照してください。
• Gate 2, エビデンスのスキャン：エージェントシステムのファイル、それらに影響するリポジトリの変更、およびバージョンの来歴を読み取ります。contracts/modes-and-scope.md を参照してください。
• Gate 3, 差分の収集：インストール済みの変更履歴、テンプレート、レジストリ、スナップショット、リポジトリのエビデンスから、すべての Bootstrap 契約の差分を収集して分類します。contracts/delta-audit.md を参照してください。
• Gate 4, 領域のマージ：領域ごとに三者間マージを実行し、競合をユーザーと解決して、レジスタールールを適用します。contracts/merge-model.md を参照してください。
• Gate 5, メンテナンス計画と承認済み適用：計画を作成して承認を得たうえで、承認済みの操作のみを書き込み、その後ベースラインと来歴を更新します。contracts/delta-audit.md と contracts/merge-model.md を参照してください。
• Gate 6, 最終検証：操作、マージの決定、更新後のベースライン、生成システムのチェックを検証します。contracts/delta-audit.md を参照してください。

audit モードでは、Gate 4 の後で停止して結果を報告します。何も書き込みません。

出力形式

書き込み前：モード、分類済み差分リスト、領域ごとのマージ結果、提案する操作、未承認の計画を出力し、明示的な承認を求めます。

書き込み後：変更したファイル、競合の解決内容、検証結果、新しい適用済みバージョン、更新したベースラインと回答のパス、追加したレジスターの行、メンテナンス後の推奨事項、残っているリスクを出力します。