에이전트 선택적 탐색 구조 개선과 경고 정리 반영

- claude-code 선택적 탐색 흐름을 참고해 Cowork/Code 시스템 프롬프트에서 folder_map 상시 선행 지시를 완화하고 glob/grep 기반 좁은 탐색을 우선하도록 조정함

- FolderMapTool 기본 depth를 2로, include_files 기본값을 false로 낮추고 MultiReadTool 최대 파일 수를 8개로 줄여 초기 과탐색 폭을 보수적으로 조정함

- AgentLoopExplorationPolicy partial을 추가해 탐색 범위 분류, broad-scan corrective hint, exploration_breadth 성능 로그를 연결함

- AgentLoopService에 탐색 범위 가이드 주입과 실행 중 탐색 폭 추적을 추가하고, 좁은 질문에서 반복적인 folder_map/대량 multi_read를 교정하도록 정리함

- DocxToHtmlConverter nullable 경고를 수정해 Release 빌드 경고 0 / 오류 0 기준을 다시 충족함

- README와 docs/DEVELOPMENT.md에 2026-04-09 10:36 (KST) 기준 개발 이력을 반영함

src/AxCopilot/Views/ChatWindow.PlanApprovalPresentation.cs

@@ -25,6 +25,12 @@ public partial class ChatWindow
                 _planViewerWindow?.LoadPlan(planSummary, steps, tcs);
                 ShowPlanButton(true);
                 AddDecisionButtons(tcs, options);
+                // 플랜 창 자동 표시 (사용자가 직접 BtnPlanViewer 클릭 안 해도 됨)
+                if (_planViewerWindow != null && IsWindowAlive(_planViewerWindow))
+                {
+                    _planViewerWindow.Show();
+                    _planViewerWindow.Activate();
+                }
             });
 
             var completed = await Task.WhenAny(tcs.Task, Task.Delay(TimeSpan.FromMinutes(5)));
@@ -88,61 +94,61 @@ public partial class ChatWindow
 
     private void ShowPlanButton(bool show)
     {
-        if (!show)
+        // 레거시: 이전 세션에서 동적 주입된 MoodIconPanel 칩 정리
+        try
         {
             for (int i = MoodIconPanel.Children.Count - 1; i >= 0; i--)
             {
                 if (MoodIconPanel.Children[i] is Border b && b.Tag?.ToString() == "PlanBtn")
                 {
-                    if (i > 0 && MoodIconPanel.Children[i - 1] is Border sep && sep.Tag?.ToString() == "PlanSep")
-                        MoodIconPanel.Children.RemoveAt(i - 1);
-                    if (i < MoodIconPanel.Children.Count)
-                        MoodIconPanel.Children.RemoveAt(Math.Min(i, MoodIconPanel.Children.Count - 1));
+                    // separator 먼저 제거 (인덱스 시프트 전)
+                    int sepIdx = i - 1;
+                    MoodIconPanel.Children.RemoveAt(i); // PlanBtn 제거
+                    if (sepIdx >= 0 && sepIdx < MoodIconPanel.Children.Count
+                        && MoodIconPanel.Children[sepIdx] is Border sep && sep.Tag?.ToString() == "PlanSep")
+                        MoodIconPanel.Children.RemoveAt(sepIdx);
                     break;
                 }
             }
+        }
+        catch
+        {
+            // 레거시 정리 실패 시에도 버튼 토글은 반드시 실행
+        }
+
+        // StatusBar의 XAML 선언 계획 버튼 토글
+        BtnPlanViewer.Visibility = show ? Visibility.Visible : Visibility.Collapsed;
+    }
+
+    private void BtnPlanViewer_Click(object sender, MouseButtonEventArgs e)
+    {
+        e.Handled = true;
+        if (string.IsNullOrWhiteSpace(_pendingPlanSummary) && _pendingPlanSteps.Count == 0)
             return;
-        }
 
-        foreach (var child in MoodIconPanel.Children)
+        EnsurePlanViewerWindow();
+        if (_planViewerWindow != null && IsWindowAlive(_planViewerWindow))
         {
-            if (child is Border b && b.Tag?.ToString() == "PlanBtn")
-                return;
-        }
-
-        var separator = new Border
-        {
-            Width = 1,
-            Height = 18,
-            Background = TryFindResource("SeparatorColor") as Brush ?? Brushes.Gray,
-            Margin = new Thickness(4, 0, 4, 0),
-            VerticalAlignment = VerticalAlignment.Center,
-            Tag = "PlanSep",
-        };
-        MoodIconPanel.Children.Add(separator);
-
-        var planBtn = CreateFolderBarButton("\uE9D2", "계획", "실행 계획 보기", "#10B981");
-        planBtn.Tag = "PlanBtn";
-        planBtn.MouseLeftButtonUp += (_, e) =>
-        {
-            e.Handled = true;
-            if (string.IsNullOrWhiteSpace(_pendingPlanSummary) && _pendingPlanSteps.Count == 0)
-                return;
-
-            EnsurePlanViewerWindow();
-            if (_planViewerWindow != null && IsWindowAlive(_planViewerWindow))
+            if (string.IsNullOrWhiteSpace(_planViewerWindow.PlanText)
+                || _planViewerWindow.PlanText != (_pendingPlanSummary ?? string.Empty)
+                || !_planViewerWindow.Steps.SequenceEqual(_pendingPlanSteps))
             {
-                if (string.IsNullOrWhiteSpace(_planViewerWindow.PlanText)
-                    || _planViewerWindow.PlanText != (_pendingPlanSummary ?? string.Empty)
-                    || !_planViewerWindow.Steps.SequenceEqual(_pendingPlanSteps))
-                {
-                    _planViewerWindow.LoadPlanPreview(_pendingPlanSummary ?? "", _pendingPlanSteps);
-                }
-                _planViewerWindow.Show();
-                _planViewerWindow.Activate();
+                _planViewerWindow.LoadPlanPreview(_pendingPlanSummary ?? "", _pendingPlanSteps);
             }
-        };
-        MoodIconPanel.Children.Add(planBtn);
+            _planViewerWindow.Show();
+            _planViewerWindow.Activate();
+        }
+    }
+
+    /// <summary>계획 버튼 호버 효과 초기화 (Loaded에서 호출).</summary>
+    private void InitPlanButtonHover()
+    {
+        var hoverBg = TryFindResource("ItemHoverBackground") as Brush
+                      ?? new SolidColorBrush(Color.FromArgb(0x18, 0xFF, 0xFF, 0xFF));
+        var normalBg = TryFindResource("HintBackground") as Brush ?? Brushes.Transparent;
+
+        BtnPlanViewer.MouseEnter += (_, _) => BtnPlanViewer.Background = hoverBg;
+        BtnPlanViewer.MouseLeave += (_, _) => BtnPlanViewer.Background = normalBg;
     }
 
     private void UpdatePlanViewerStep(AgentEvent evt)