禁止ショートカット：エージェントコンテキストパッケージ

禁止ショートカットを一貫して適用するために必要な事実、ルール、境界、および例をAIコーディングエージェントに提供します。採用境界と観測可能な失敗証拠を固定しつつ、環境固有の制限は設定可能なままにします。

パッケージステータス： 参照コンテキストが人間によるレビュー準備完了。契約およびテストシナリオは完了していますが、採用実装がこれらを通過したという主張はしていません。

決定

禁止ショートカットについては、パスおよびタスクでスコープされたバージョン管理されたリポジトリ指示を採用します。動作は一つの権威ある書き込みパス、型付きインターフェース、明示的な状態、および冪等な副作用処理を通じて実装します。この実装ブロックは特にエージェントコンテキストパッケージに焦点を当てています。このパッケージは参照契約であり、採用チームは自環境の証拠から数値制限、プロバイダー、管轄区域、および運用責任者を選択しなければなりません。

スコープ

• この実装ブロックのエージェントコンテキストパッケージに必要な禁止ショートカットのアクター、入力、出力、状態、ポリシーまたはスキーマバージョン、および外部に見える成果物。
• 主および代替インターフェース、バックグラウンド作業、キャッシュ、統合、サポートパス、および同じ境界を行使できる証拠。
• 参照を安全に適用するために必要な採用固有の設定、展開、回復、および検証責任。

このブロックの外

• すべての採用者に対して普遍的なベンダー、フレームワーク、管轄区域、数値閾値、保持期間、またはサービスレベル目標を選択すること。
• パッケージ化されたシナリオが下流の実装で実行されたことや、この参照が法的、セキュリティ、アクセシビリティ認証を付与することを主張すること。

契約

• 指示の優先順位、適用パス、必要なチェック、禁止される変更、および引き渡し時に期待される証拠を宣言する。
• コマンド、バージョン、アーキテクチャ、およびファイル位置はメモリや隣接プロジェクトではなくリポジトリソースから導出する。
• 実行可能な検証は散文の主張と分離し、チェックが実行されなかったまたは完了できなかった場合を記録する。
• エージェントに無関係な変更を保持し、資格情報、破壊的スコープ、または製品権限が欠如している場合は停止することを要求する。
• 境界で入力を一度だけ検証し、下流ロジックで使用される正規化された表現を保持する。
• ビジネスの遷移をアウトボックスレコードとともにまたは原子的に永続化し、消費者は耐久的な操作IDで重複排除を行う。
• 各禁止ショートカットの名前、引き起こす失敗またはリスク、影響を受けるパス、検出方法、安全な代替手段、例外権限、およびレビューまたは期限条件を明示する。
• 可能な限り重要な禁止事項を実行可能なチェックに変換し、エージェントにテスト、ポリシー、所有権、またはデータ整合性を静かに回避するのではなくブロッカーを報告することを要求する。
• エージェントコンテキストパッケージのバリアントについては、この宣言された境界を強制する：禁止ショートカットを一貫して適用するために必要な事実、ルール、境界、および例をAIコーディングエージェントに提供する。

実装ガイダンス

• 追加的なストレージおよびインターフェースの変更を最初に出荷し、観測可能にバックフィルし、互換性の証拠が得られた後に古いパスを廃止する。
• フレームワークやベンダーの詳細を選択する前に、禁止ショートカットの入力、出力、アクター、状態、不変条件、副作用、および証拠をモデル化する。
• 適用される禁止ショートカット契約またはポリシーバージョンを重要な状態とともに保存し、マイグレーション、リプレイ、およびサポートの判断が帰属可能なままにする。
• 制御された展開の背後にパスを導入し、期待される結果と観測された結果を比較し、採用の証拠が完了するまでテスト済みの回復ルートを保持する。

失敗処理と安全策

• 矛盾または古いコンテキストは正確なソースとともにブロッカーとして表面化し、エージェントはプロジェクトの動作を変えるタイブレーカーを自ら作り出さない。
• 無効または矛盾する禁止ショートカット状態は拒否または隔離され、実装は権限を拡大したり効果を重複させる値を推測しない。
• リトライは制限され耐久的なIDを使用し、使い果たした後は検査可能な終端状態に達し、責任ある所有者が存在する。

検証と運用

• 永続化の前後に依存関係の失敗を注入し、リトライが一つの外部に見える結果に収束することを証明する。
• 禁止ショートカットの成功、拒否、検証失敗、依存関係失敗、リトライ使い果たし、および契約バージョンごとの回復を機密ペイロードの詳細なしに監視する。
• ポリシー、スキーマ、依存関係、マイグレーション、または境界の変更後に正負のフィクスチャを再実行し、得られた証拠を保持する。

採用の前提

• 例の名前と値は具体的なフィクスチャであり普遍的なデフォルトではなく、採用者は文書化された証拠と所有権を通じてこれらを置き換える。
• 採用システムは認証済みのID、耐久的な操作またはレコードバージョン、制限されたテレメトリ、および変更のための制御されたパスを提供できる。

このパッケージ内の実行可能に見える例はフィクスチャおよび受け入れ契約です。
構造とメタデータを検証するためにコレクションバリデータを実行し、ターゲットリポジトリでシナリオを翻訳・実行してから実装証拠を記録してください。