AX Agent 코워크·코드 흐름과 컨텍스트 관리를 claude-code 기준으로 대폭 정리

- 코워크·코드 프롬프트, 도구 선택, 문서 생성/검증 흐름을 claude-code 동등 품질 기준으로 재정렬함

- OpenAI/vLLM 경로의 오래된 tool history를 평탄화하고 최근 이력만 구조화해 컨텍스트 직렬화를 경량화함

- AX Agent UI를 테마 기준으로 재구성하고 플랜 승인/오버레이/이벤트 렌더링/명령 입력 상호작용을 개선함

- 파일 후보 제안, 반복 경로 정체 복구, LSP 보강, 문서·PPT 처리 개선, 설정/서비스 인터페이스 정리를 함께 반영함

- README.md 및 docs/DEVELOPMENT.md를 작업 시점별로 갱신함

- 검증: dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify\\ -p:IntermediateOutputPath=obj\\verify\\ (경고 0, 오류 0)

src/AxCopilot/Services/Agent/DocumentAssemblerTool.cs

@@ -135,7 +135,7 @@ public class DocumentAssemblerTool : IAgentTool
             var pageEstimate = Math.Max(1, totalWords / 500);
 
             return ToolResult.Ok(
-                $"✅ 문서 조립 완료: {Path.GetFileName(fullPath)}\n" +
+                $"✅ 문서 조립 완료: {fullPath}\n" +
                 $"  섹션: {sections.Count}개 | 글자: {totalChars:N0} | 단어: ~{totalWords:N0} | 예상 페이지: ~{pageEstimate}\n" +
                 $"{resultMsg}", fullPath);
         }
@@ -241,14 +241,30 @@ public class DocumentAssemblerTool : IAgentTool
             path, DocumentFormat.OpenXml.WordprocessingDocumentType.Document);
 
         var mainPart = doc.AddMainDocumentPart();
+
+        // 기본 스타일 파트 추가 (styles.xml — 없으면 Word에서 글꼴/서식 깨짐)
+        var stylesPart = mainPart.AddNewPart<DocumentFormat.OpenXml.Packaging.StyleDefinitionsPart>();
+        stylesPart.Styles = CreateDefaultDocxStyles();
+        stylesPart.Styles.Save();
+
         mainPart.Document = new DocumentFormat.OpenXml.Wordprocessing.Document();
         var body = mainPart.Document.AppendChild(new DocumentFormat.OpenXml.Wordprocessing.Body());
 
+        // 한글 호환 글꼴 설정 헬퍼
+        static DocumentFormat.OpenXml.Wordprocessing.RunFonts KoreanFonts() => new()
+        {
+            Ascii = "맑은 고딕",
+            HighAnsi = "맑은 고딕",
+            EastAsia = "맑은 고딕",
+            ComplexScript = "맑은 고딕"
+        };
+
         // 제목
         var titlePara = new DocumentFormat.OpenXml.Wordprocessing.Paragraph();
         var titleRun = new DocumentFormat.OpenXml.Wordprocessing.Run();
         titleRun.AppendChild(new DocumentFormat.OpenXml.Wordprocessing.RunProperties
         {
+            RunFonts = KoreanFonts(),
             Bold = new DocumentFormat.OpenXml.Wordprocessing.Bold(),
             FontSize = new DocumentFormat.OpenXml.Wordprocessing.FontSize { Val = "48" }
         });
@@ -267,6 +283,7 @@ public class DocumentAssemblerTool : IAgentTool
             var headRun = new DocumentFormat.OpenXml.Wordprocessing.Run();
             headRun.AppendChild(new DocumentFormat.OpenXml.Wordprocessing.RunProperties
             {
+                RunFonts = KoreanFonts(),
                 Bold = new DocumentFormat.OpenXml.Wordprocessing.Bold(),
                 FontSize = new DocumentFormat.OpenXml.Wordprocessing.FontSize { Val = level <= 1 ? "32" : "28" },
                 Color = new DocumentFormat.OpenXml.Wordprocessing.Color { Val = "2B579A" },
@@ -281,6 +298,11 @@ public class DocumentAssemblerTool : IAgentTool
             {
                 var para = new DocumentFormat.OpenXml.Wordprocessing.Paragraph();
                 var run = new DocumentFormat.OpenXml.Wordprocessing.Run();
+                run.AppendChild(new DocumentFormat.OpenXml.Wordprocessing.RunProperties
+                {
+                    RunFonts = KoreanFonts(),
+                    FontSize = new DocumentFormat.OpenXml.Wordprocessing.FontSize { Val = "22" }
+                });
                 run.AppendChild(new DocumentFormat.OpenXml.Wordprocessing.Text(line.Trim())
                 {
                     Space = DocumentFormat.OpenXml.SpaceProcessingModeValues.Preserve
@@ -293,9 +315,59 @@ public class DocumentAssemblerTool : IAgentTool
             body.AppendChild(new DocumentFormat.OpenXml.Wordprocessing.Paragraph());
         }
 
+        // ★ SectionProperties는 반드시 body의 마지막 자식이어야 함 (OOXML 규격)
+        // 첫 번째에 넣으면 Word가 무시하거나 문서가 깨짐
+        body.AppendChild(new DocumentFormat.OpenXml.Wordprocessing.SectionProperties(
+            new DocumentFormat.OpenXml.Wordprocessing.PageSize { Width = 11906, Height = 16838 },
+            new DocumentFormat.OpenXml.Wordprocessing.PageMargin { Top = 1440, Right = 1440, Bottom = 1440, Left = 1440,
+                Header = 720, Footer = 720, Gutter = 0 }
+        ));
+
+        mainPart.Document.Save();
         return "  ✓ DOCX 조립 완료";
     }
 
+    /// <summary>DOCX 기본 스타일 정의 생성 (한글 글꼴 기본 설정 포함).</summary>
+    private static DocumentFormat.OpenXml.Wordprocessing.Styles CreateDefaultDocxStyles()
+    {
+        var styles = new DocumentFormat.OpenXml.Wordprocessing.Styles();
+
+        // 문서 기본 글꼴 설정
+        var docDefaults = new DocumentFormat.OpenXml.Wordprocessing.DocDefaults(
+            new DocumentFormat.OpenXml.Wordprocessing.RunPropertiesDefault(
+                new DocumentFormat.OpenXml.Wordprocessing.RunPropertiesBaseStyle(
+                    new DocumentFormat.OpenXml.Wordprocessing.RunFonts
+                    {
+                        Ascii = "맑은 고딕",
+                        HighAnsi = "맑은 고딕",
+                        EastAsia = "맑은 고딕",
+                        ComplexScript = "맑은 고딕"
+                    },
+                    new DocumentFormat.OpenXml.Wordprocessing.FontSize { Val = "22" },
+                    new DocumentFormat.OpenXml.Wordprocessing.Languages { Val = "ko-KR", EastAsia = "ko-KR" }
+                )
+            ),
+            new DocumentFormat.OpenXml.Wordprocessing.ParagraphPropertiesDefault(
+                new DocumentFormat.OpenXml.Wordprocessing.ParagraphPropertiesBaseStyle(
+                    new DocumentFormat.OpenXml.Wordprocessing.SpacingBetweenLines { After = "160", Line = "259", LineRule = DocumentFormat.OpenXml.Wordprocessing.LineSpacingRuleValues.Auto }
+                )
+            )
+        );
+        styles.AppendChild(docDefaults);
+
+        // Normal 스타일
+        var normalStyle = new DocumentFormat.OpenXml.Wordprocessing.Style
+        {
+            Type = DocumentFormat.OpenXml.Wordprocessing.StyleValues.Paragraph,
+            StyleId = "Normal",
+            Default = true
+        };
+        normalStyle.AppendChild(new DocumentFormat.OpenXml.Wordprocessing.StyleName { Val = "Normal" });
+        styles.AppendChild(normalStyle);
+
+        return styles;
+    }
+
     private string AssembleMarkdown(string path, string title, List<(string Heading, string Content, int Level)> sections)
     {
         var sb = new StringBuilder();