PJR-M35P 保護機構が gitignore 済みの生成物を設定変更として検知する

1. 概要

agent-config-write が .specdojo/doc-index.json の変更を保護対象の設定改変として検知し、 PJR-MBVM の統合をブロックした。

blocked: agent-config-write: protected configuration changes detected;
paths=.specdojo/doc-index.json; agent must record the required handoff

同ファイルは .gitignore 済みの生成物である。index build が再生成するキャッシュであり、 commit されることもない。

.gitignore:92             .specdojo/doc-index.json
src/exec-worktree.ts:300  // 生成物（docs/**/generated と .specdojo/doc-index.json）は .gitignore 済み

plan が index build を指示すれば必然的に変更されるため、同じブロックが繰り返し発生する。

2. 影響

PJR-MBVM は executor と reporter を完了していたが、統合前で停止した。成果物は worktree に 未コミットのまま残り、--resume による再開を要した。実装内容に問題はなく、保護機構の判定 だけが原因である。

自動記録された申し送りにも「変更理由: agent の記入なし」と残る。agent が意図的に設定を変えた わけではないため、記入すべき意図が存在しない。申し送りとして情報価値がない記録が積まれる。

3. 併発する問題

保護機構が差分を取得しようとして失敗している。

git diff failed: warning: Not a git repository. Use --no-index to compare two paths outside a working tree

差分を取得できず、代わりに対象ファイルの全内容を申し送りへ書き出している。生成物は大きい ため、申し送りが読めなくなる。

# .specdojo/doc-index.json: git 差分を取得できなかったため現在の内容を出力
--- /dev/null
+++ b/.specdojo/doc-index.json

4. 完了条件

• agent-config-write が .gitignore 済みの生成物を保護対象に含めない。
• .specdojo/doc-index.json を再生成する plan を実行しても、統合がブロックされない。
• 保護対象の判定基準が、追跡対象か生成物かを区別できる形で定義されている。
• 差分取得に失敗した場合に、全内容ではなく取得できなかった事実と理由を申し送りへ記録する。
• 上記を検証する単体テストを追加する。

5. 作業内容

No	作業	メモ
1	保護対象の判定から gitignore 済み生成物を除外	既知の生成物と ignore 規則を組み合わせ、snapshot と commit 前再検査で判定を共有した
2	差分取得失敗時の申し送り出力を見直す	全内容の出力をやめ、失敗した Git 操作と理由だけを記録するようにした
3	git diff failed の原因を特定して解消	非 Git 環境等の失敗を構造化して扱い、内容出力への誤フォールバックを解消した
4	単体テストを追加	追跡済み生成物、非生成設定、非 Git 環境での申し送りを検証した

6. 対応結果

• src/exec-agent-protected-config.ts に agentProtectedConfigPaths() を追加し、agent 前後の snapshot と統合前の再検査が同じ保護境界を使うようにした。
• .specdojo/doc-index.json は既知の生成物かつ ignore 規則に一致する場合だけ除外する。git check-ignore --no-index により、過去に追跡されていた worktree でも生成物として識別する。任意の ignore 対象は除外せず、新規設定ファイルによる回避を防ぐ。Git の判定失敗時は保護側へ倒す。
• Git status / diff の失敗を構造化して扱い、失敗時は対象ファイルの全内容を申し送りへ出力せず、取得できなかった事実と Git の失敗理由を記録するようにした。未追跡と確認できた新規設定ファイルだけは、従来どおり提案内容として現在の内容を記録する。
• 単体テストに、追跡済みでも ignore 規則に一致する既知生成物の除外、任意の ignore 済み設定を除外しないこと、非 Git 環境で全内容を転記しないことを追加した。統合テストには、doc index 再生成後も commit が block されないケースを追加した。
• 保護境界と申し送り規則を 実行設定ガイド に反映した。残課題はない。

7. 関連ドキュメント

• prj-0001:pjr-mbvm-grade-exclude-generated: このブロックで統合が止まった項目。