答え公開済み13 ソース
文書・テスト・AIエージェントの入口をどう整理するか 旧タスクの保全から始める新提案
旧タスクは最新の確認でもBLOCKED、関連ADRもPROPOSEDのまま。凍結して保全することと、完了扱いにすることは別です。 提案の軸は、共通のプロジェクト入口、分野別の仕様、履歴資料、テスト、作業中の一時ファイルを役割ごとに分けること。
公開者GPT Image 2 で画像を生成
研究の答え
重要なポイント
- 旧タスクは最新の確認でもBLOCKED、関連ADRもPROPOSEDのまま。凍結して保全することと、完了扱いにすることは別です。
- 提案の軸は、共通のプロジェクト入口、分野別の仕様、履歴資料、テスト、作業中の一時ファイルを役割ごとに分けること。
- テストは数を減らすことより、回帰の意味や発見・実行の仕組みを保つことを優先。Goの非公開要素を検証するテストは同じパッケージに残す案です。
- Clineの公式説明ではPlanは調査・計画、Actは実行のモードですが、対象バージョンでの設定や実際の動作は別途確認が必要です。[2]
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/bXqIw3XxkXZyuu9gdo7NkRTsoKM2/images/96A3E3DABB4B22049019/9A075E9F648E3535ABBA.png)
AI プロンプト
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"write to file","arguments":{"path":" bmad output/analysis/ANALYSIS 20261022 document test governance.md","content":" 文档、测试与跨宿主入口治理：旧任务对账及新方案裁决\n\n 日期：2026 10 22。\n 交付性质：分析与治理提案；不是实施、冻结、归档或宿主验收回执。\n 旧契. Topic tags: general web, llm, agents, ai, automation. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts wit
「凍結」は「完了」ではない
2026年10月22日付のプロジェクト分析がまず明確にしたのは、過去の整理作業を完了扱いできないという点です。旧タスクは最新の確認でもBLOCKED、関連するアーキテクチャ決定記録（ADR）もPROPOSEDのまま。ホスト環境での受け入れ確認は未完了で、一部のローカル検証についても、実行時の出力ではなく過去の要約しか確認できていません。
そのため、旧タスクを保全して一時停止することはできても、未完了の検証や証拠の不足を消す理由にはなりません。要約は経緯の手がかりにはなりますが、実際のコマンド、終了状態、出力、対象環境を示す記録の代わりにはならない――というのが今回の対帳の基本姿勢です。
目標は、ファイル数より「役割」を整理すること
提案の中心は、ひとつの安定したプロジェクト入口から、必要な情報へ案内する構成です。入口には共通の作業ルールや検証方法を置き、プロジェクト固有の仕様、意思決定の記録、活動中の計画、過去の分析、持続的なテスト、作業中だけ使う一時ファイルは、それぞれの役割に応じて分けます。
これは、特定のフォルダー構成を業界標準として押し付ける話ではありません。提案された配置もあくまで候補で、既存の参照先やホストの読み込み方法を確認してから採用する前提です。とくに、旧タスクの計画書や関連記録を保全し、参照関係を安全に引き継ぐまでは、新しい活動計画を既定の入口に差し替えないとしています。
テストは「少なくする」より、意味を保つ
テストの整理でも、ファイル数を減らすこと自体は成功条件にしません。欠陥の再発防止や契約上の不変条件を確かめるテストは、配置や名前だけを理由に削除しない方針です。既存テストを再利用しつつ、コードとテストを一対一に対応させることも求めません。
Goでは、パッケージ内の非公開要素を検証する白箱テストは、アクセスできる同じパッケージに残すのが候補です。見た目を整えるために内部状態を公開したり、実装を複製したりして、検証を弱めるべきではないとしています。テストを別の場所へ移す場合も、移行前後でテストの発見方法と意味が保たれるかを確かめます。
一方、テストや型検査、静的解析、ビルドなどを、不適切な変更を検出する「下流のフィードバック」として設計する考え方は、AIエージェントの作業にも応用できます。Geoffrey Huntleyの資料は、一般的な「テストを実行する」という指示だけでなく、プロジェクト固有の検証コマンドを入口に明記する方法を説明しています。6 また、テストを仕様書に圧縮する方法は、同氏の文章では別の言語への移植を扱うものです。日常的な回帰テストを削除する根拠とは区別する必要があります。
11
Clineのモード説明だけでは、実環境の検証にならない
Clineの公式説明では、Planはコードベースを調べ、検索し、方針を相談する段階で、ファイルの変更やコマンドの実行は行わないモードとされています。Actは計画に沿って実行する段階です。2
ただし、この説明だけで、特定のインストール版や設定でも同じ制限が機能するとは確認できません。プロジェクト側の分析では、対象バージョン、ルールやスキルの読み込み、実際の権限、ユーザーがActへ切り替えたときの扱いは未検証と整理されています。モード名や設定ファイルが存在することと、ホスト上で期待どおりに動いたことは別です。
そのため提案は、共通のプロジェクト情報を二重に書かず、ホストごとの連携は薄い橋渡しにとどめるものです。対象バージョンを固定したうえで、ルールが読み込まれるか、許可された文書保存ができるか、意図しない書き込みやコマンド実行が拒否されるかを個別に確認します。実際の読み込みが不明な場合は、確認できたように扱わず、明示的に情報を参照する方法へ戻すとしています。
移行は保全、契約の調整、実環境確認の順に
提案された進め方は、まず旧計画を元の内容のまま保全し、関連するADRや報告書への参照を引き継ぐことです。次に、文書の置き場所を動かす前に、パスを参照するルール、検証器、テスト、配布処理を調整します。その後、対象ホストのバージョンと権限を確認し、実際の連携を検証。最後に、個別の文書やテストを範囲ごとに移行する段取りです。
今回の分析自体は、この移行を実施した報告ではありません。ファイルの移動、削除、インストール、テスト実行、ホストでの受け入れ確認は行っておらず、新しい活動計画もまだ保存されていません。結論は、整理のために過去の証拠や回帰テストを急いで捨てず、未完了の作業を見える状態に保ったまま、段階的に責任範囲を分けることです。
Studio Global AI
研究を続けてください
このページにはソースに裏付けされた回答が含まれており、Studio Global 内で続行できます。
人々も尋ねます
「文書・テスト・AIエージェントの入口をどう整理するか 旧タスクの保全から始める新提案」の短い答えは何ですか?
旧タスクは最新の確認でもBLOCKED、関連ADRもPROPOSEDのまま。凍結して保全することと、完了扱いにすることは別です。
最初に検証する重要なポイントは何ですか?
旧タスクは最新の確認でもBLOCKED、関連ADRもPROPOSEDのまま。凍結して保全することと、完了扱いにすることは別です。 提案の軸は、共通のプロジェクト入口、分野別の仕様、履歴資料、テスト、作業中の一時ファイルを役割ごとに分けること。
次の実践では何をすればいいでしょうか？
テストは数を減らすことより、回帰の意味や発見・実行の仕組みを保つことを優先。Goの非公開要素を検証するテストは同じパッケージに残す案です。