risk-classification

リスク分類

概要

4段階モデル（GREEN/YELLOW/RED/CRITICAL）を使用して、エージェントのタスクをインラインでリスク分類します。低リスクの段階では高速なヒューリスティックによるファイルパターン照合を使用し、完全な可逆性スコアリングが必要な高リスクの段階では Skill(attune:war-room-checkpoint) に委任します。

使用する場面

• エージェントにタスクを割り当てる前に、タスクのリスクを評価するとき
• タスク完了時に必要な検証を判断するとき
• タスク間の並列実行が安全かどうかを判断するとき
• タスクのチェックリストにリスクマーカーを追加するとき

使用しない場面

• 単一ファイルの些細な変更（GREEN と見なします）
• 戦略的なアーキテクチャ上の決定（代わりに Skill(attune:war-room) を使用します）
• コード以外のタスク（ドキュメントのみの変更、設定のコメントなど）

4段階のリスクモデル

段階	色	範囲	例	検証
GREEN	安全	単一ファイル、簡単に元に戻せる	テストファイル、ドキュメント、ユーティリティ	不要
YELLOW	注意	モジュールレベル、ユーザーに見える変更	コンポーネント、ルート、ビュー	競合チェックとテスト合格
RED	危険	モジュール横断、セキュリティ／データ	マイグレーション、認証、データベーススキーマ	War-room RS、全テスト、レビュー
CRITICAL	停止	元に戻せない、規制対象	データ削除、本番環境へのデプロイ	War-room RS、人間による承認

ハイブリッドルーティング

Task received
    |
    v
Heuristic classifier (file patterns)
    |
    ├── GREEN/YELLOW → Apply tier, continue
    |
    └── RED/CRITICAL → Invoke Skill(attune:war-room-checkpoint)
                        for reversibility scoring (RS)
                        |
                        └── RS confirms or adjusts tier

ハイブリッド方式を採用する理由：GREEN/YELLOW の分類は高速かつ決定的です（ファイルパターン照合）。RED/CRITICAL のタスクは、誤った場合のコストが高いため、完全な可逆性分析に伴うオーバーヘッドをかける価値があります。

タスクメタデータの拡張

下流で利用できるよう、タスクのメタデータにリスク段階を追加します。

{
  "id": "5",
  "subject": "Add user authentication",
  "metadata": {
    "risk_tier": "YELLOW",
    "risk_reason": "Modifies src/components/LoginForm.tsx (user-visible component)",
    "classified_at": "2026-02-07T22:00:00Z"
  }
}

risk_tier メタデータのないタスクは、後方互換性のため GREEN が既定値になります。

Readiness Levels

4段階の Readiness Levels システムでは、明確なリスク分類と、各段階で必須となる制御を定めています。

レベル	名前	該当する状況	必須の制御
0	定常	影響範囲が小さく、簡単にロールバックできる	基本的な検証、ロールバック手順
1	要注意	ユーザーに見える変更	レビュー、否定的テスト、ロールバックに関する注記
2	高度	セキュリティ／コンプライアンス／データ	敵対的レビュー、リスクチェックリスト
3	重大	元に戻せない、規制対象	人間による確認、2段階検証

各レベルの定義、選択用の判断ツリー、統合ガイダンスについては、modules/readiness-levels.md を参照してください。

段階的な自律性

リスク分類では、変更をどれだけ慎重に検証するかを設定します。自動化段階では、エージェントがどの程度自律的に動作するか、いつ制御を人間に戻す必要があるかを設定します。各リスク段階には既定の自動化段階が割り当てられ（GREEN は A3 の自律実行、CRITICAL は A0 の手動実行）、事前に許可された降格トリガーが、失敗の繰り返し、信頼度の低下、リスクの急増、リポジトリ状態の不一致が発生した際に、同じレベルで再度プロンプトを出すのではなく、エージェントを1段階降格させます。段階の表と降格トリガーについては modules/automation-tiers.md を、そこから設定を読み込む説明／生成モードの選択については imbue:assisted-mastery を参照してください。

モジュールリファレンス

• tier-definitions.md：各段階の詳細な基準、境界、オーバーライドの仕組み
• heuristic-classifier.md：自動分類のためのファイルパターンルール
• verification-gates.md：段階ごとの検証要件と並列実行の安全性マトリクス
• readiness-levels.md：各レベルの必須制御を定める4段階のリスクシステム
• automation-tiers.md：段階ごとの自律性の既定値と降格トリガー

統合パターン

# In your skill's frontmatter
dependencies: [leyline:risk-classification]

タスク生成器向け

タスク形式に [R:TIER] マーカーを追加します。

- [ ] T012 [P] [US1] [R:YELLOW] Create LoginForm component in src/components/LoginForm.tsx

オーケストレーター向け

タスクを割り当てる前に、リスク段階を確認します。

if task.risk_tier in ["RED", "CRITICAL"]:
    invoke Skill(attune:war-room-checkpoint) for RS scoring
    if CRITICAL: require human approval before proceeding

終了基準

• すべてのタスクにリスク段階が割り当てられている（明示的、または既定の GREEN）
• RED/CRITICAL のタスクに war-room-checkpoint の RS スコアが付いている
• 割り当てられた段階の検証ゲートに合格している
• 禁止されている段階の組み合わせで並列実行していない
• 各タスクに自動化段階が設定されており、降格トリガーが発生した場合は理由とともに記録されている