docs: Phase 267 P0 EdgeCFG Branch (BranchStub + emit_frag)

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

@@ -0,0 +1,34 @@
+# Phase 267 — EdgeCFG Branch（BranchStub + emit_frag）
+
+Status: Completed (P0) ✅ / P1 deferred ⏸️  
+SSOT (design): `docs/development/current/main/design/edgecfg-fragments.md`
+
+## ゴール
+- `Frag` に **Branch（条件分岐）**を第一級で追加し、`wires`（Jump/Return）と同様に **MIR terminator へ落とせる**入口を作る
+- 既存の JoinIR/NormalizedShadow/Pattern6/7/8 は触らず、**BasicBlockId 層の test-only PoC**で証明する
+
+## P0（完了）
+### 実装
+- `BranchStub` を追加（フラット構造: from/cond/then/else + edge-args）
+  - `src/mir/builder/control_flow/edgecfg/api/branch_stub.rs`
+- `Frag` に `branches: Vec<BranchStub>` を追加（Branch 専用）
+  - `wires` は Jump/Return 専用のまま維持
+  - `src/mir/builder/control_flow/edgecfg/api/frag.rs`
+- `compose::if_` が header→then/else の `BranchStub` を生成するように更新
+  - `src/mir/builder/control_flow/edgecfg/api/compose.rs`
+- `emit_frag(function, frag)` を追加（SSOT）
+  - `verify_frag_invariants_strict()` を最初に実行
+  - `wires` は `emit_wires()` を内部利用
+  - `branches` は `set_branch_with_edge_args()` で terminator + successors を同期
+  - 1 block = 1 terminator（wire/branch 重複）を Fail-Fast
+  - `src/mir/builder/control_flow/edgecfg/api/emit.rs`
+
+### テスト
+- `emit_frag` の Branch 生成・衝突検出、`compose::if_` の BranchStub 生成を unit test で固定（lib tests PASS）
+
+## P1（見送り）
+- “層を跨がない実適用”の候補調査を行い、現状は抽象化層（emit_conditional/emit_jump 等）へ委譲済みであるため、無理に差し替えず **Phase 268** で体系的に適用する方針
+
+## 次フェーズ（Phase 268）
+- Branch の edge-args（then/else entry params）計算を含めた実戦投入
+- JoinIR/NormalizedShadow/Pattern6/7/8 側へ段階的に適用（層境界を守る）