feat(phase277-p2): PHI環境変数統合 8個→3個 - ユーザビリティ向上

Phase 277 P2: PHI関連環境変数の統合・整理

【問題】
- PHI関連環境変数が8個に乱立
- ユーザーが覚える変数が多すぎる
- 保守性が低い（関連設定が分散）

【解決】
1. debug_helper.py 新規作成（SSOT）
   - is_phi_debug_enabled(): 一般デバッグ（3変数統合）
   - is_phi_trace_enabled(): 詳細トレース（2変数統合）
   - is_phi_strict_enabled(): 厳格モード（既存維持）

2. 環境変数統合（8個→3個）
   統合後:
   - NYASH_LLVM_DEBUG_PHI: 一般PHIデバッグ
   - NYASH_LLVM_DEBUG_PHI_TRACE: 詳細トレース
   - NYASH_LLVM_PHI_STRICT: 厳格モード（既存維持）

   統合前（廃止予定）:
   - NYASH_LLVM_PHI_DEBUG → NYASH_LLVM_DEBUG_PHI
   - NYASH_PHI_TYPE_DEBUG → NYASH_LLVM_DEBUG_PHI
   - NYASH_PHI_ORDERING_DEBUG → NYASH_LLVM_DEBUG_PHI
   - NYASH_LLVM_TRACE_PHI → NYASH_LLVM_DEBUG_PHI_TRACE
   - NYASH_LLVM_VMAP_TRACE → NYASH_LLVM_DEBUG_PHI_TRACE

3. 後方互換性対応
   - 旧環境変数使用時に非推奨警告表示
   - Phase 278 で削除予定

【効果】
- ✅ ユーザビリティ向上: 覚える変数 8個→3個（62%削減）
- ✅ 保守性向上: 環境変数チェック 30+箇所→1箇所（SSOT）
- ✅ ドキュメント簡潔化: environment-variables.md 整理
- ✅ SSOT原則適用: debug_helper.py に環境変数ロジック集約

【影響範囲】
- 新規: debug_helper.py (SSOT)
- 修正: 9ファイル（PHI関連Python）
- ドキュメント: environment-variables.md, 10-Now.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

docs/development/current/main/phases/phase-277/README.md

@@ -0,0 +1,91 @@
+# Phase 277: PHI関連改善シリーズ
+
+## 概要
+
+Phase 275/276で完了したFloat型PHI対応・型取得SSOT化の後続改善として、PHI関連の環境変数統合・ドキュメント整備を実施。
+
+---
+
+## サブフェーズ一覧
+
+### Phase 277 P0: PHI型推論ドキュメント整備（予定）
+
+- 目的: Phase 275/276で実装したPHI型推論ロジックのドキュメント化
+- 内容:
+  - MIR型伝播 → LLVM IR型生成のフロー図
+  - type_helper.py の設計ドキュメント
+  - PHI型推論のベストプラクティス
+
+### Phase 277 P1: PHI順序検証強化（予定）
+
+- 目的: PHI命令の配置順序検証を強化
+- 内容:
+  - phi_placement.py の検証ロジック強化
+  - LLVM IR仕様準拠チェック（PHI → 非PHI → terminator）
+  - 順序違反時のエラーメッセージ改善
+
+### Phase 277 P2: PHI関連環境変数の統合・整理 ✅
+
+**完了日**: 2025-12-22
+
+- 目的: PHI関連環境変数を **8個 → 3個** に統合
+- 完了ドキュメント: `P2-COMPLETION.md`
+- 達成内容:
+  - ✅ debug_helper.py 作成（環境変数チェックのSSOT）
+  - ✅ 3つの統合関数実装（is_phi_debug_enabled 他）
+  - ✅ 9ファイル修正完了（wiring.py, tagging.py 他）
+  - ✅ 後方互換性対応（Phase 278で削除予定）
+  - ✅ ドキュメント更新（environment-variables.md）
+- 効果:
+  - ユーザビリティ向上（覚える変数 8個→3個、62%削減）
+  - 保守性向上（環境変数チェックのSSOT化）
+  - ドキュメント簡潔化
+
+---
+
+## 統合後の環境変数（P2完了版）
+
+```bash
+# PHI一般デバッグ（生成・型推論・順序）
+NYASH_LLVM_DEBUG_PHI=1
+
+# PHI詳細トレース（wiring・vmap変化）
+NYASH_LLVM_DEBUG_PHI_TRACE=1
+
+# PHI厳格モード（ゼロフォールバック禁止）
+NYASH_LLVM_PHI_STRICT=1
+```
+
+**詳細**: `docs/reference/environment-variables.md` の「PHI デバッグ関連」セクション
+
+---
+
+## 関連Phase
+
+- **Phase 275**: Float型PHI対応（MIR型伝播 → LLVM IR double生成）
+- **Phase 276**: 型取得SSOT化（type_helper.py）
+- **Phase 278**: 後方互換性削除（旧環境変数サポート削除予定）
+
+---
+
+## ファイル構成
+
+```
+phase-277/
+├── README.md                 # 本ファイル（Phase 277概要）
+├── P2-COMPLETION.md          # P2完了報告
+├── P0-DESIGN.md              # P0設計ドキュメント（予定）
+└── P1-VALIDATION.md          # P1検証強化ドキュメント（予定）
+```
+
+---
+
+## 今後の予定
+
+1. **Phase 277 P0**: PHI型推論ドキュメント整備
+2. **Phase 277 P1**: PHI順序検証強化
+3. **Phase 278**: 後方互換性削除
+
+---
+
+**Phase 277 P2 完了！** 次はP0/P1の計画策定へ。