AX-Copilot-Codex/docs/DEVELOPMENT.md

업데이트: 2026-04-15 20:19 (KST)
- AX Agent 반복 상한을 500으로 확장했습니다. `src/AxCopilot/ViewModels/SettingsViewModel.cs`의 `MaxAgentIterations` 클램프를 `1~500`으로 올리고, `src/AxCopilot/Views/SettingsWindow.xaml`의 슬라이더/힌트 문구도 같은 범위로 맞췄습니다.
- `src/AxCopilot/Views/ChatWindow.xaml`, `src/AxCopilot/Views/ChatWindow.OverlaySettingsPresentation.cs`, `src/AxCopilot/Views/AgentSettingsWindow.xaml.cs`도 함께 수정해 Code 탭 오버레이와 별도 에이전트 설정창이 여전히 100 또는 200에 묶이지 않도록 범위를 통일했습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_max_agent_iterations_500\\ -p:IntermediateOutputPath=obj\\verify_max_agent_iterations_500\\` 경고 0 / 오류 0

업데이트: 2026-04-15 17:41 (KST)
- 워크스페이스 저장/복원 경로를 확장했습니다. `src/AxCopilot/Core/AppWorkspaceStateHelper.cs`는 파일 탐색기 현재 폴더 경로와 메모장 열린 파일 경로를 best-effort로 저장하고, `src/AxCopilot/Core/ProcessCommandLineHelper.cs`는 브라우저/메모장 공용 프로세스 명령줄 파싱을 담당합니다.
- `src/AxCopilot/Core/ContextManager.cs`는 브라우저 외에도 탐색기/메모장 상태가 저장된 창을 새로 실행해 해당 경로/파일을 다시 열 수 있게 했고, 복원 중 새 창을 연속 실행할 때는 CPU 사용률·메모리 사용률·이미 실행한 창 수를 반영한 적응형 지연을 넣어 저사양 PC에서 복원 폭주를 줄이도록 했습니다.
- `src/AxCopilot/Models/AppSettings.cs`, `src/AxCopilot/ViewModels/SettingsViewModel.cs`, `src/AxCopilot/Views/SettingsWindow.xaml`에는 워크스페이스 복원 속도 제어 설정(`복원 속도 자동 조절`, `복원 기본 간격`, `복원 최대 간격`)을 추가했습니다.
- `src/AxCopilot.Tests/Core/ContextManagerTests.cs`, `src/AxCopilot.Tests/Services/SettingsServiceTests.cs`에 탐색기/메모장 launch plan, 상태 직렬화, 복원 지연 계산 회귀 테스트를 추가했습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_workspace_app_restore\\ -p:IntermediateOutputPath=obj\\verify_workspace_app_restore\\` 경고 0 / 오류 0
- 검증: `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "WorkspaceHandlerTests|ContextManagerTests|SettingsServiceTests" -p:OutputPath=bin\\verify_workspace_app_restore_tests\\ -p:IntermediateOutputPath=obj\\verify_workspace_app_restore_tests\\` 통과 54
?낅뜲?댄듃: 2026-04-14 19:50 (KST)
?낅뜲?댄듃: 2026-04-15 12:51 (KST)
- ?낅뜲?댄듃: 2026-04-15 18:20 (KST)
- README, 濡쒕뱶留? ?ㅽ뻾 怨꾪쉷 臾몄꽌?먯꽌 鍮꾧탳쨌紐⑥궗 ?쒗쁽??以꾩씠怨?AX 湲곗? 媛쒕컻 怨꾪쉷怨?寃利?湲곕줉 以묒떖?쇰줈 臾몄꽌紐낃낵 ?ㅻ챸???뺣━?덉뒿?덈떎.
- ?낅뜲?댄듃: 2026-04-15 16:49 (KST)
- ?곗쿂 `~` ?뚰겕?ㅽ럹?댁뒪 蹂듭썝 寃쎈줈瑜??ш??좏븯怨? 媛숈? `exe`??泥?踰덉㎏ 李??섎굹瑜?紐⑤뱺 ?ㅻ깄?룹뿉 ?ъ궗?⑺븯??蹂듭썝 留ㅼ묶 寃고븿???섏젙?덉뒿?덈떎. 湲곗〈 `src/AxCopilot/Core/ContextManager.cs`??媛??ㅻ깄?룸쭏??`exe`留?鍮꾧탳??HWND瑜?李얠븯湲??뚮Ц?? Chrome/Edge泥섎읆 ?щ윭 李쎌씠 ???덉쓣 ????李쎈쭔 諛섎났 ?대룞?섎ŉ 諛곗튂媛 臾대꼫吏湲??ъ썱?듬땲??
- `src/AxCopilot/Core/ContextManager.cs`???대┛ 李??꾨낫瑜??섏쭛????`exe + ?쒕ぉ 留ㅼ묶 ?먯닔 + ?대? ?ъ슜???몃뱾 ?쒖쇅` 湲곗??쇰줈 李쎌쓣 諛곗젙?섎룄濡?諛붽엥?듬땲?? exact title??理쒖슦?좎쑝濡??먭퀬, 釉뚮씪?곗? suffix ?쒓굅/?좏겙 鍮꾧탳瑜??듯빐 鍮꾩듂???쒕ぉ??蹂댁“?곸쑝濡?留ㅼ묶?⑸땲?? ?대? ?ㅻⅨ ?ㅻ깄?룹뿉 諛곗젙???몃뱾? ?ㅼ떆 ?곗? ?딆븘 multi-window 蹂듭썝 ?덉쭏???믪??듬땲??
- `src/AxCopilot/Handlers/WorkspaceHandler.cs`??臾몄꽌?먮쭔 ?덉뿀??`~restore <?대쫫>`怨?`~list`瑜??ㅼ젣 ?몃뱾?ъ뿉?쒕룄 吏?먰븯?꾨줉 蹂댁셿?덉뒿?덈떎. ?꾨줈??紐⑸줉? 理쒓렐 ?앹꽦 ?쒖쑝濡??뺣젹?섍퀬 媛???ぉ??怨㏓컮濡?restore action??媛吏?꾨줉 ?뺣━?덉뒿?덈떎.
- ?뚯뒪?? `src/AxCopilot.Tests/Handlers/WorkspaceHandlerTests.cs`, `src/AxCopilot.Tests/Core/ContextManagerTests.cs`
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_workspace_restore_review\\ -p:IntermediateOutputPath=obj\\verify_workspace_restore_review\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "WorkspaceHandlerTests|ContextManagerTests" -p:OutputPath=bin\\verify_workspace_restore_review_tests\\ -p:IntermediateOutputPath=obj\\verify_workspace_restore_review_tests\\` ?듦낵 6
- ?낅뜲?댄듃: 2026-04-15 16:12 (KST)
- 沅뚰븳 寃쎈줈 ?댁꽍怨??몄뀡 ?뱀씤 ?ъ궗?⑹쓣 workspace-aware 湲곗??쇰줈 ?뺣━?덉뒿?덈떎. ?곷? 寃쎈줈 `index.html` 媛숈? ??곸씠 沅뚰븳 ?앹뾽/?щ궡 紐⑤뱶 ?몃? 寃쎈줈 ?먯젙?먯꽌 ?꾨줈?몄뒪 ?꾩옱 ?대뜑(`dist`) 湲곗??쇰줈 ?섎せ ?덈?寃쎈줈?붾릺硫댁꽌, ?앹뾽 ?쒖떆媛 ??댁?怨?`?대쾲 ?ㅽ뻾 ?숈븞 ?덉슜`??raw/absolute 寃쎈줈 遺덉씪移섎줈 ?ъ궗?⑸릺吏 ?딅뜕 臾몄젣瑜??섏젙?덉뒿?덈떎.
- `src/AxCopilot/Services/Agent/IAgentTool.cs`??`ResolvePathForWorkspaceCheck(...)`瑜?異붽???`IsPathAllowed(...)`, `IsOutsideWorkspace(...)`媛 ?곷? 寃쎈줈瑜??꾩옱 `WorkFolder` 湲곗??쇰줈 ?덈?寃쎈줈?뷀븳 ???먯젙?섎룄濡?蹂寃쏀뻽?듬땲?? ?щ궡 紐⑤뱶?먯꽌???뚰겕?ㅽ럹?댁뒪 ?섏쐞 ?곷? 寃쎈줈???몃? 寃쎈줈濡??ㅽ뙋?섏? ?딆뒿?덈떎.
- `src/AxCopilot/Views/ChatWindow.xaml.cs`??沅뚰븳 肄쒕갚?먯꽌 `RuntimeWorkFolderOverride` ?먮뒗 ?꾩옱 ??붿쓽 `WorkFolder`瑜??ъ슜?????寃쎈줈瑜?癒쇱? ?뺢퇋?뷀븯怨? ?먮룞 ?뱀씤 ?ъ궗?? ?몃? 寃쎈줈 notice, 沅뚰븳 ?앹뾽 ?쒖떆, ?몄뀡 洹쒖튃 ??μ뿉 紐⑤몢 媛숈? ?덈?寃쎈줈瑜??ъ슜?섎룄濡??뺣━?덉뒿?덈떎.
- ?뚯뒪?? `src/AxCopilot.Tests/Services/OperationModePolicyTests.cs`??`AgentContext_CheckToolPermissionAsync_InternalMode_BypassPermissions_AllowsRelativeWorkspacePathWithoutPrompt` 異붽?
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_permission_workspace_path\\ -p:IntermediateOutputPath=obj\\verify_permission_workspace_path\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "OperationModePolicyTests|AgentLoopE2ETests" -p:OutputPath=bin\\verify_permission_workspace_path_tests\\ -p:IntermediateOutputPath=obj\\verify_permission_workspace_path_tests\\` ?듦낵 34
- ?낅뜲?댄듃: 2026-04-15 15:56 (KST)
- AX Agent ?곷떒 ?쇱씠釉?吏꾪뻾 移대뱶 蹂듭썝 媛?쒕? 異붽??덉뒿?덈떎. `src/AxCopilot/Views/ChatWindow.LiveProgressPresentation.cs`??`EnsureAgentLiveCardVisible(...)`瑜?留뚮뱾怨? Cowork/Code ?ㅽ뻾 以??쇱씠釉?移대뱶媛 ?꾩쭅 ?앹꽦?섏? ?딆븯嫄곕굹 transcript ?ш뎄?깆쑝濡?鍮좎죱????利됱떆 ?ъ깮???щ?李⑸릺?꾨줉 ?덉뒿?덈떎.
- `src/AxCopilot/Views/ChatWindow.xaml.cs`??agent event ?섏떊怨?live hint ?쒖옉 ??eligible ??씠硫???helper瑜?癒쇱? ?몄텧????live card ?곹깭瑜?媛깆떊?섎룄濡?諛붽엥?듬땲?? 硫붿씤 猷⑦봽2 ?댄썑 ?대깽?몃뒗 ?ㅻ뒗??梨꾪똿李?諛붾줈 ???쇱씠釉?移대뱶留??щ씪吏???뚭?瑜?留됰뒗 紐⑹쟻?낅땲??
- `src/AxCopilot/Views/ChatWindow.V2Rendering.cs`??遺遺??꾩껜 transcript ?щ젋?붾쭅 以?`_v2LiveContainer` 議댁옱 ?щ?留?蹂댁? ?딄퀬 `_isStreaming` ?곹깭硫?helper瑜??듯빐 ?쇱씠釉?移대뱶瑜??먮룞 蹂듭썝?⑸땲??
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_live_card_guard\\ -p:IntermediateOutputPath=obj\\verify_live_card_guard\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatWindowSlashPolicyTests" -p:OutputPath=bin\\verify_live_card_guard_tests\\ -p:IntermediateOutputPath=obj\\verify_live_card_guard_tests\\` ?듦낵 49
- AX Agent 吏꾪뻾 ?대젰 ?뺤젣瑜??꾪빐 `src/AxCopilot/Services/Agent/AgentProgressSummarySanitizer.cs`瑜?異붽??덉뒿?덈떎. ?ㅽ듃由щ컢 以묎컙 preview, `Thinking` ?붿빟, `[?댁쟾 ?꾧뎄 ?몄텧: ...]` transcript 瑗щ━, ?レ옄/?愿꾪샇 媛숈? ??덉쭏 議곌컖 臾몄옄?댁쓣 怨듯넻 洹쒖튃?쇰줈 ?뺣━?⑸땲??
- `src/AxCopilot/Services/Agent/AgentLoopService.cs`???ㅽ듃由щ컢 `TextDelta` preview emit怨??쇰컲 `Thinking` emit ?꾩뿉 ?뺤젣湲곕? ?곸슜?⑸땲?? ?뺤젣 ??鍮꾩뼱踰꾨┛ summary???대깽???먯껜瑜?留뚮뱾吏 ?딆븘, 以묎컙 ?묐떟??`1`, `[`, `file_read]` 媛숈? ?뚰렪??timeline/history???볦씠吏 ?딆뒿?덈떎.
- `src/AxCopilot/Views/ChatWindow.V2LiveProgressPresentation.cs`, `src/AxCopilot/Views/ChatWindow.V2AgentEventPresentation.cs`, `src/AxCopilot/Views/ChatWindow.AgentEventRendering.cs`???뚮뜑留?吏곸쟾?먮룄 媛숈? ?뺤젣 濡쒖쭅???ъ슜?⑸땲?? 湲곗〈 ?몄뀡???ㅻ옒??low-signal thinking event媛 ?ㅼ떆 洹몃젮吏??뚮룄 鍮덉빟???⑤Ц???④린怨?process feed?먮뒗 `吏꾪뻾 ?댁슜 ?뺣━`濡??대갚?⑸땲??
- ?뚯뒪?? `src/AxCopilot.Tests/Services/AgentProgressSummarySanitizerTests.cs` 異붽?, `src/AxCopilot.Tests/Services/AgentLoopResponseClassificationServiceTests.cs` ?뺤옣
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_agent_progress_cleanup\\ -p:IntermediateOutputPath=obj\\verify_agent_progress_cleanup\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentProgressSummarySanitizerTests|AgentLoopResponseClassificationServiceTests|AgentStatusNarrativeCatalogTests|AgentLoopIterationPreparationServiceTests|AgentToolResultBudgetTests|ChatStorageServiceTests" -p:OutputPath=bin\\verify_agent_progress_cleanup_tests\\ -p:IntermediateOutputPath=obj\\verify_agent_progress_cleanup_tests\\` ?듦낵 22

?낅뜲?댄듃: 2026-04-14 21:25 (KST)
- 臾몄꽌 ?앹꽦 怨좊룄??2李⑤? 諛섏쁺?덉뒿?덈떎. `src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs`瑜?異붽???HTML/DOCX/XLSX ?곗텧臾쇱뿉 ???濡쒖뺄 ?덉쭏 ?먯닔? 蹂댁셿 ?ъ씤?몃? 怨꾩궛?섍퀬, `HtmlSkill`, `DocxSkill`, `ExcelSkill`??媛숈? 由щ럭 紐⑤뜽??怨듭쑀?섎룄濡?留욎톬?듬땲??
- `src/AxCopilot/Services/Agent/DocxSkill.cs`??`template_path`, `cover_subtitle`, `cover_meta`, `toc`瑜?吏?먰븯?꾨줉 ?뺤옣?덉뒿?덈떎. DOCX ?쒗뵆由?蹂듭젣 ??蹂몃Ц???ш뎄?깊븯怨? 而ㅻ쾭 ?섏씠吏? TOC ?꾨뱶瑜??쎌엯????structured review 寃곌낵瑜??④퍡 諛섑솚?⑸땲??
- `src/AxCopilot/Services/Agent/ExcelSkill.cs`??executive summary sheet??detail sheet 留곹겕瑜??먮룞 ?앹꽦?섍퀬, KPI/highlights/actions 援ъ“瑜?workbook quality review? ?곌껐?섎룄濡?蹂닿컯?덉뒿?덈떎.
- `src/AxCopilot/Services/Agent/HtmlSkill.cs`??濡쒖뺄 ?덉쭏 由щ럭瑜?寃곌낵 ?붿빟???ы븿?섎룄濡?諛붽엥怨? 臾몄꽌??踰덈뱾 ?ㅽ궗濡?`executive-brief`, `kpi-workbook`, `board-report-html`??異붽??덉뒿?덈떎.
- ?뚯뒪?? `ArtifactQualityReviewServiceTests`, `DocxSkillTemplateFeaturesTests`, `ExcelSkillExecutiveSummaryLinkTests` 異붽?
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_phase2\\ -p:IntermediateOutputPath=obj\\verify_doc_phase2\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ArtifactQualityReviewServiceTests|DocxSkillTemplateFeaturesTests|ExcelSkillExecutiveSummaryLinkTests|DocumentAssemblerSemanticTests|DocumentPlannerBusinessDocumentTests|HtmlSkillConsultingSectionsTests|ExcelSkillSummarySheetTests" -p:OutputPath=bin\\verify_doc_phase2_tests\\ -p:IntermediateOutputPath=obj\\verify_doc_phase2_tests\\` ?듦낵 9

?낅뜲?댄듃: 2026-04-14 22:52 (KST)
- 臾몄꽌 ?щ㎎ 怨좊룄?붿? PPTX ?뺤옣 ?ъ씤?몃? ?④퍡 諛섏쁺?덉뒿?덈떎. `src/AxCopilot/Services/Agent/ExcelSkill.cs`??`conditional_formats`瑜?吏?먰빐 ?됱긽 ?ㅼ??쇨낵 ?곗씠??諛?議곌굔遺?쒖떇??OpenXML濡?吏곸젒 ?앹꽦?섍퀬, workbook quality review?먮룄 議곌굔遺?쒖떇 媛쒖닔瑜?諛섏쁺?⑸땲??
- `src/AxCopilot/Services/Agent/DocxSkill.cs`??`style_map`??吏?먰븯?꾨줉 ?뺤옣?덉뒿?덈떎. ?쒗뵆由우뿉 ?뺤쓽???쒕ぉ/?ㅻ뵫/蹂몃Ц ?ㅽ??쇱쓣 ?ㅼ젣 臾몃떒??`ParagraphStyleId`濡??곌껐???щ궡 ?쒗뵆由?湲곕컲 臾몄꽌 ?덉쭏???믪??듬땲??
- `src/AxCopilot/Services/Agent/HtmlSkill.cs`??`print_header`, `print_footer`瑜?諛쏆븘 ?몄뇙???ㅻ뜑/?명꽣 ?꾨젅?꾩쓣 ?뚮뜑留곹븯怨? `src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs`??HTML/DOCX/XLSX ?덉쭏 由щ럭 臾몄옄?닿낵 ?먯젙 濡쒖쭅??怨듯넻 ?뺤떇?쇰줈 ?뺣━?덉뒿?덈떎.
- PPTX??`src/AxCopilot/Services/Agent/PptxTemplatePackRegistry.cs`瑜??덈줈 異붽???`strategy`, `board`, `pmo`, `finance`, `sales`, `operating_model` ?쒗뵆由??⑹쓣 ?뺤쓽?덉뒿?덈떎. `src/AxCopilot/Services/Agent/PptxSkill.cs`??`template_pack` ?뚮씪誘명꽣? objective/audience 湲곕컲 pack suggestion??諛쏆븘 ?댄썑 紐⑹쟻??deck 怨좊룄?붾? ?댁뼱媛湲??ъ슫 援ъ“媛 ?먯뒿?덈떎.
- ?뚯뒪?? `ArtifactQualityReviewServiceTests`, `ExcelSkillDataValidationTests`, `ExcelSkillConditionalFormattingTests`, `DocxSkillStyleMapTests`, `HtmlSkillPrintFrameTests`, `PptxSkillTemplatePackTests`
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_next_doc_ppt\\ -p:IntermediateOutputPath=obj\\verify_next_doc_ppt\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ArtifactQualityReviewServiceTests|ExcelSkillDataValidationTests|ExcelSkillConditionalFormattingTests|ExcelSkillExecutiveSummaryLinkTests|ExcelSkillSummarySheetTests|DocxSkillTemplateFeaturesTests|DocxSkillStyleMapTests|HtmlSkillConsultingSectionsTests|HtmlSkillPrintFrameTests|DocumentAssemblerDocxFeaturesTests|PptxSkillConsultingDeckTests|PptxSkillAutoRepairTests|PptxSkillTemplatePackTests" -p:OutputPath=bin\\verify_next_doc_ppt_tests\\ -p:IntermediateOutputPath=obj\\verify_next_doc_ppt_tests\\` ?듦낵 15

?낅뜲?댄듃: 2026-04-15 10:34 (KST)
- Agent loop 諛섎났 吏꾩엯遺瑜?遺꾨━?덉뒿?덈떎. `src/AxCopilot/Services/Agent/AgentLoopIterationPreparationService.cs`瑜?異붽???queued command ?ъ쁺, tool_result ?湲??붿빟 ?앹꽦, `AgentQueryContextBuilder.Build()` ?몄텧??怨듯넻 以鍮??④퀎濡?臾띔퀬, `AgentLoopService.RunAsync()`??orchestration????吏묒쨷?섎룄濡??뺣━?덉뒿?덈떎.
- `src/AxCopilot/Services/Agent/AgentMessageInvariantHelper.cs`??tool result preview ?ㅻ깄?룹쓣 `ExplicitByToolResultId`, `ExplicitByFingerprint`, `SyntheticByToolResultId`濡?遺꾨━?⑸땲?? ??λ맂 preview媛 ?덉쑝硫?洹멸쾬???곗꽑 ?곌퀬, ?ㅻⅨ ?몄뀡?먯꽌 `tool_use_id`媛 諛붾?寃쎌슦?먮뒗 fingerprint ?щ컮?몃뵫???듯빐 ?덉젙?곸씤 preview瑜?蹂듭썝?섎ŉ, 留덉?留됱뿉留?synthetic preview瑜??ъ슜?⑸땲??
- `src/AxCopilot/Services/Agent/AgentToolResultBudget.cs`??source query view媛 ?덉쓣 ??source 湲곗? snapshot??癒쇱? 留뚮뱾怨? query view?먮뒗 洹?寃곌낵瑜??ъ궗?⑺븯?꾨줉 ?쒖꽌瑜?議곗젙?덉뒿?덈떎. ?대줈??source 履?explicit preview媛 local synthetic preview??媛?ㅼ?吏 ?딄퀬, 泥?異뺤빟 寃곌낵??source message???ㅼ떆 ??λ맗?덈떎.
- ?뚯뒪?? `src/AxCopilot.Tests/Services/AgentLoopIterationPreparationServiceTests.cs`, `src/AxCopilot.Tests/Services/AgentMessageInvariantHelperTests.cs`, `src/AxCopilot.Tests/Services/AgentToolResultBudgetTests.cs`
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_loop_pipeline\\ -p:IntermediateOutputPath=obj\\verify_loop_pipeline\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentQueuedCommandProjectorTests|AgentLoopIterationPreparationServiceTests|AgentMessageInvariantHelperTests|AgentToolResultBudgetTests|AgentQueryContextBuilderTests|ChatStorageServiceTests" -p:OutputPath=bin\\verify_loop_pipeline_tests\\ -p:IntermediateOutputPath=obj\\verify_loop_pipeline_tests\\` ?듦낵 14

?낅뜲?댄듃: 2026-04-15 10:57 (KST)
- Agent loop 留덇컧 ?뺣━濡?`src/AxCopilot/Services/Agent/AgentLoopNoToolResponseRecoveryService.cs`瑜?異붽??덉뒿?덈떎. `RunAsync()` ?덉뿉 ?욎뿬 ?덈뜕 `?꾧뎄 誘명샇異?猷⑦봽`? `怨꾪쉷留??몄슦怨??꾧뎄瑜??몄텧?섏? ?딅뒗 寃쎌슦`??蹂듦뎄 硫붿떆吏/?ъ떆??洹쒖튃/?대깽???붿빟??蹂꾨룄 ?쒕퉬?ㅻ줈 遺꾨━??orchestration 蹂몃Ц?????묎쾶 ?좎??⑸땲??
- `src/AxCopilot/Services/Agent/AgentLoopService.cs`????helper瑜??몄텧??assistant ?띿뒪??蹂댁〈, recovery user message 異붽?, retry counter 媛깆떊, event emit留??섑뻾?⑸땲?? ?대줈??蹂듦뎄 洹쒖튃 蹂寃????쒕퉬???뚯뒪?몃쭔?쇰줈 ?뚭?瑜??↔린 ?ъ썙議뚯뒿?덈떎.
- ?뚯뒪?? `src/AxCopilot.Tests/Services/AgentLoopNoToolResponseRecoveryServiceTests.cs`
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_closeout\\ -p:IntermediateOutputPath=obj\\verify_closeout\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentLoopNoToolResponseRecoveryServiceTests|AgentLoopIterationPreparationServiceTests|AgentLoopLlmRequestPreparationServiceTests|AgentQueuedCommandProjectorTests|AgentMessageInvariantHelperTests|AgentToolResultBudgetTests|AgentQueryContextBuilderTests|ChatStorageServiceTests|HtmlSkillGoldenReportTests|PptxSkillGoldenDeckTests|DocxSkillGoldenDocumentTests|ExcelSkillGoldenWorkbookTests" -p:OutputPath=bin\\verify_closeout_tests\\ -p:IntermediateOutputPath=obj\\verify_closeout_tests\\` ?듦낵 27

?낅뜲?댄듃: 2026-04-15 12:14 (KST)
- ?ъ슜?먯뿉寃?蹂댁씠??AX Agent 吏꾪뻾 ?곹깭 臾멸뎄瑜?richer narrative濡?怨좊룄?뷀뻽?듬땲?? `src/AxCopilot/Services/Agent/AgentStatusNarrativeCatalog.cs`瑜?異붽???agent event瑜?`??Cowork/Code) + ?꾧뎄 移댄뀒怨좊━ + ????뚰듃 + transcript row presentation` 湲곗??쇰줈 ?댁꽍?섍퀬, ?꾩옱 ?곹깭 硫붿떆吏/?곸꽭 ?ㅻ챸/phase label/meta瑜??쒓납?먯꽌 ?앹꽦?⑸땲??
- `src/AxCopilot/Views/ChatWindow.xaml.cs`??live pulse ?곹깭 ?낅뜲?댄듃??narrative 移댄깉濡쒓렇瑜??곸슜?섍퀬, `src/AxCopilot/Views/ChatWindow.AgentStatusPresentation.cs`??珥덇린 以鍮??곹깭? idle ?곹깭瑜?媛숈? narrative ?뚯뒪濡??뚮뜑留곹븯?꾨줉 蹂寃쏀뻽?듬땲?? `src/AxCopilot/Views/ChatWindow.AgentEventRendering.cs`??readable process feed summary? phase label/meta瑜??숈씪 移댄깉濡쒓렇??留욎떠 ?꾧뎄紐?以묒떖 臾멸뎄 ????섎룄 以묒떖 臾멸뎄瑜??ъ궗?⑺빀?덈떎.
- ?대줈??Cowork/Code?먯꽌 蹂댁씠???꾩옱 ?곹깭? ?대젰 ?붿빟??`?앷컖?섎뒗 以?, `?묒뾽 ?ㅽ뻾 以? 媛숈? ?쇰컲 臾멸뎄?먯꽌 `愿??肄붾뱶 踰붿쐞 ?뺤씤`, `蹂寃??곸슜`, `?ㅽ뻾 寃곌낵 遺꾩꽍`, `臾몄꽌 ?곗텧臾?援ъ꽦`, `沅뚰븳 ?뺤씤 ?湲?, `而⑦뀓?ㅽ듃 ?뺣━`泥섎읆 ??援ъ껜?곸씤 臾몄옣?쇰줈 諛붾앸땲??
- ?뚯뒪?? `src/AxCopilot.Tests/Services/AgentStatusNarrativeCatalogTests.cs`
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_status_narrative\\ -p:IntermediateOutputPath=obj\\verify_status_narrative\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentStatusNarrativeCatalogTests|AgentLoopIterationPreparationServiceTests|AgentToolResultBudgetTests|ChatStorageServiceTests|AgentMessageInvariantHelperTests" -p:OutputPath=bin\\verify_status_narrative_tests\\ -p:IntermediateOutputPath=obj\\verify_status_narrative_tests\\` ?듦낵 15

?낅뜲?댄듃: 2026-04-15 17:26 (KST)
- ?곗쿂 `~` ?뚰겕?ㅽ럹?댁뒪??釉뚮씪?곗? ?몄뀡 蹂듭썝 寃쎈줈瑜?異붽??덉뒿?덈떎. `src/AxCopilot/Core/BrowserWorkspaceStateHelper.cs`媛 Chromium 怨꾩뿴怨?Firefox???ㅽ뻾 ?꾨줈???몄옄, ?꾩옱 ??URL 紐⑸줉, ?쒖꽦 ???몃뜳?ㅻ? ?섏쭛?섍퀬, `src/AxCopilot/Core/ContextManager.cs`媛 釉뚮씪?곗? ?곹깭媛 ??λ맂 李쎌? 遺遺??쒕ぉ 留ㅼ묶?쇰줈 湲곗〈 李쎌쓣 ?ъ궗?⑺븯吏 ?딄퀬 ??李쎌쓣 ?꾩썙 ?숈씪??URL ?명듃瑜?蹂듭썝?????꾩튂/?ш린? ?쒖꽦 ??쓣 留욎땅?덈떎.
- ?ㅼ젙 ?좉????④퍡 ?곌껐?덉뒿?덈떎. `src/AxCopilot/Models/AppSettings.cs`??`Launcher.EnableBrowserSessionRestore` 湲곕낯媛?`true`瑜?異붽??섍퀬, `src/AxCopilot/ViewModels/SettingsViewModel.cs`? `src/AxCopilot/Views/SettingsWindow.xaml`??`釉뚮씪?곗? ?곹깭 蹂듭썝` ??ぉ???몄텧?????꾪솚 湲곕컲 罹≪쿂瑜??ъ슜?먭? ?쒖뼱?????덇쾶 ?덉뒿?덈떎.
- ?뚯뒪?몃뒗 `src/AxCopilot.Tests/Core/ContextManagerTests.cs`??釉뚮씪?곗? ?ㅽ뻾 ?몄옄/??李??ㅽ뻾 ?뺤콉 耳?댁뒪瑜? `src/AxCopilot.Tests/Services/SettingsServiceTests.cs`??湲곕낯媛?吏곷젹???쇱슫?쒗듃由?耳?댁뒪瑜?異붽??덉뒿?덈떎.
- 寃利?
- `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_browser_restore\\ -p:IntermediateOutputPath=obj\\verify_browser_restore\\` ??寃쎄퀬 0 / ?ㅻ쪟 0
- `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ContextManagerTests|SettingsServiceTests" -p:OutputPath=bin\\verify_browser_restore_tests\\ -p:IntermediateOutputPath=obj\\verify_browser_restore_tests\\` ??42媛??듦낵
- `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "WorkspaceHandlerTests|ContextManagerTests|SettingsServiceTests" -p:OutputPath=bin\\verify_browser_restore_workspace_tests\\ -p:IntermediateOutputPath=obj\\verify_browser_restore_workspace_tests\\` ??44媛??듦낵

?낅뜲?댄듃: 2026-04-14 19:50 (KST)
?낅뜲?댄듃: 2026-04-15 15:45 (KST)
- Cowork PPT ?앹꽦 寃쎈줈瑜??뱀젙 ?낆쥌 ?꾩슜 archetype???꾨땲??怨듯넻 ?덉쭏 猷⑦봽濡?媛뺥솕?덉뒿?덈떎. `src/AxCopilot/Views/ChatWindow.SystemPromptBuilder.cs`? `src/AxCopilot/Services/Agent/AgentLoopExplorationPolicy.cs`??presentation/deck ?붿껌?먯꽌 `document_plan`??臾댁“嫄??좏뻾?섏? ?딄퀬, 怨꾪쉷 ?붿껌??紐낆떆?섏? ?딆쑝硫?`pptx_create`瑜??곗꽑?섎룄濡??덈궡?⑸땲??
- `src/AxCopilot/Services/Agent/DeckPlanningService.cs`??`RefineForQuality(...)`瑜?異붽??덉뒿?덈떎. ??猷⑦봽??executive summary, recommendation, comparison, roadmap, chart, KPI dashboard ?щ씪?대뱶瑜??ㅼ떆 ?먭???summary takeaways, verdict/trade-off, timeline/owner/detail, KPI trend/note, chart takeaway, appendix evidence瑜??먮룞?쇰줈 蹂닿컯?⑸땲??
- `src/AxCopilot/Services/Agent/PptxSkill.cs`??珥덇린 `DeckQualityReviewService.ReviewDeck(...)` 寃곌낵媛 ?쏀븷 ????踰???蹂댁젙??deck??留뚮뱾怨? ?ㅼ젣濡??먯닔/寃쎄퀬媛 媛쒖꽑??寃쎌슦?먮쭔 refined deck??理쒖쥌 ?뚮뜑留곸뿉 ?ъ슜?⑸땲?? 寃곌낵?곸쑝濡?weak deck? ??踰????먮룞?쇰줈 ?ㅻ벉?댁쭊 ??export?⑸땲??
- ?뚯뒪?? `src/AxCopilot.Tests/Services/DeckPlanningServiceTests.cs`, `src/AxCopilot.Tests/Services/PptxSkillAutoRepairTests.cs`
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_ppt_generic_quality\\ -p:IntermediateOutputPath=obj\\verify_ppt_generic_quality\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "DeckPlanningServiceTests|PptxSkillAutoRepairTests|PptxSkillGoldenDeckTests|DeckQualityReviewServiceTests" -p:OutputPath=bin\\verify_ppt_generic_quality_tests\\ -p:IntermediateOutputPath=obj\\verify_ppt_generic_quality_tests\\` ?듦낵 14
- Agent loop/queue/context ?덉쭏??蹂닿컯?덉뒿?덈떎. `src/AxCopilot/Services/Agent/AgentCommandQueue.cs`濡??ㅽ뻾 以?異붽? ?낅젰???곗꽑?쒖쐞? interrupt ?щ?源뚯? ?ы븿??愿由ы븯怨? `AgentLoopService`???대? ?덉쟾?섍쾶 諛섏쁺?⑸땲??
- `AgentToolResultBudget`, `AgentQueryContextBuilder`, `ChatModels`??tool result preview瑜?硫붿떆吏??罹먯떆??湲??몄뀡怨??ъ쭏臾몄뿉?쒕룄 媛숈? 異뺤빟 寃곌낵瑜??ъ궗?⑺븯?꾨줉 ?뺣━?덉뒿?덈떎.
- 肄붾뱶 ??쓽 ?댁옣 ?몄뼱 吏?먯쓣 `src/AxCopilot/Services/CodeLanguageCatalog.cs`濡??듯빀?덇퀬, ?ㅼ젙??肄붾뱶 ??뿉 吏???몄뼱(LSP)? 肄붾뱶 ??湲곕낯 吏???몄뼱瑜?紐낆떆?곸쑝濡??쒖떆?⑸땲??
- `PptxSkill`??`executive_summary`, `recommendation`, `roadmap`, `comparison`, `kpi_dashboard` ?덉씠?꾩썐??異붽??덇퀬, `DocumentPlannerTool`? 諛쒗몴 ?먮즺 怨꾪쉷??`Executive Summary -> Situation & Imperative -> Key Findings -> Options & Recommendation -> Implementation Roadmap -> Impact & Ask` 援ъ“濡??앹꽦?⑸땲?? `pptx-creator.skill.md`??AX native `pptx_create` 以묒떖?쇰줈 ?ъ옉?깊뻽?듬땲??
- ?뚯뒪?? `CodeLanguageCatalogTests`, `AgentCommandQueueTests`, `AgentToolResultBudgetTests`, `DocumentPlannerPresentationTests`, `PptxSkillConsultingDeckTests` 異붽? 諛?湲곗〈 `WorkspaceContextGeneratorTests.cs(76)` nullable 寃쎄퀬 ?섏젙
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_impl\\ -p:IntermediateOutputPath=obj\\verify_impl\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "CodeLanguageCatalogTests|AgentCommandQueueTests|AgentToolResultBudgetTests|DocumentPlannerPresentationTests|PptxSkillConsultingDeckTests" -p:OutputPath=bin\\verify_impl_tests\\ -p:IntermediateOutputPath=obj\\verify_impl_tests\\` ?듦낵 15

---
# AX Copilot - 揶쏆뮆而??얜챷苑?

> 筌ㅼ뮇伊???낅쑓??꾨뱜: 2026-04-14 19:13 (KST) 夷?甕곌쑴??0.7.3

## ??낅쑓??꾨뱜 嚥≪뮄??

- ??낅쑓??꾨뱜: 2026-04-14 19:13 (KST)
- `湲곗? 援ъ“` 疫꿸퀣? Phase 4????곷선??獄쏆꼷???됰뮸??덈뼄. `src/AxCopilot/Services/Agent/McpSkillCatalog.cs`???곕떽???MCP ??뺤쒔 筌롫???怨쀬뵠?怨? `mcp` source scope??synthetic skill嚥?癰궰??묐릭?? `ToolRegistry.RegisterMcpToolsAsync()` ??꾩뜎 snapshot??揶쏄퉮???롫즲嚥??怨뚭퍙??됰뮸??덈뼄.
- `src/AxCopilot/Services/Agent/SkillService.cs`??source policy??`managed/user/additional/project/plugin/mcp/legacy` ??μ맄嚥??癒?뼊??롫즲嚥??類ㅼ삢??뉙? source ?怨쀪퐨??뽰맄 疫꿸퀡而?dedupe?? inline shell trust boundary????ｍ뜞 ?怨몄뒠??몃빍?? plugin-only mode揶쎛 ?녹뮇議???됱몵筌?managed/plugin/bundled筌??醫???랁???롢돢筌왖 source????ｍ돥??덈뼄.
- ?????筌뤿굝議???밴쉐?? `src/AxCopilot/Views/SlashCommandCatalog.cs`?? `src/AxCopilot/Views/ChatWindow.xaml.cs`?癒?퐣 ????源딅뻥??щ빍?? builtin command?? skill???⑤벏??priority嚥???밴쉐???겸뫖猷????????됵쭕??紐꾪뀱??랁? builtin `/review` 揶쏆늿? ??됰튋 筌뤿굝議??project skill癰귣?????됱젟?怨몄몵嚥??怨쀪퐨??몃빍??
- ??쇱젟/UI??`src/AxCopilot/Views/SettingsWindow.xaml`, `src/AxCopilot/Views/AgentSettingsWindow.xaml`, `src/AxCopilot/Views/AgentSettingsWindow.xaml.cs`, `src/AxCopilot/Views/SkillGalleryWindow.xaml.cs`???怨뚭퍙??됰뮸??덈뼄. MCP ??쎄텢 source ?醫?, plugin-only mode, source癰?inline shell ??됱뒠 甕곕뗄?? MCP 燁삳똾?믤⑥쥓??獄쏄퀣?, synthetic skill?????뵬 ??る?筌△뫀?????ｍ뜞 獄쏆꼷???됰뮸??덈뼄.
- ???뮞?紐껊뮉 `src/AxCopilot.Tests/Services/SkillServiceRuntimePolicyTests.cs`, `src/AxCopilot.Tests/Services/McpSkillCatalogTests.cs`, `src/AxCopilot.Tests/Views/SlashCommandCatalogTests.cs`???곕떽???됰뮸??덈뼄.
- 野꺜筌? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_phase4\\ -p:IntermediateOutputPath=obj\\verify_phase4\\` 野껋럡??0 / ??살첒 0
- 野꺜筌? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "SkillServiceRuntimePolicyTests|SlashCommandCatalogTests|McpSkillCatalogTests" -p:OutputPath=bin\\verify_phase4_tests\\ -p:IntermediateOutputPath=obj\\verify_phase4_tests\\` ???궢 17
- 筌〓㈇?? ???뮞????슢諭?餓?疫꿸퀣?????뵬 `src/AxCopilot.Tests/Services/WorkspaceContextGeneratorTests.cs(76)`??nullable 野껋럡??1椰꾨똻? ?醫???몃빍??

- ??낅쑓??꾨뱜: 2026-04-14 17:46 (KST)
- ?袁㏓럡 ??已??類λ????얜챷?ｇ몴?餓κ쑴?졿묾??袁る퉸 `src/AxCopilot/Services/Agent/AgentToolCatalog.cs`???곕떽???됰뮸??덈뼄. canonical id, legacy alias, ???紐꾪뀱, ??쇱젟 燁삳똾?믤⑥쥓?? 癰귣쵎??read-only ?브쑬履잏몴???볥궔?癒?퐣 ?온?귐뗫릭?袁⑥쨯 ?類ｂ봺??됰뮸??덈뼄.
- `ToolRegistry`, `AgentLoopService`, `AgentLoopParallelExecution`, `IAgentTool`, `AgentHookRunner`, `SkillService`揶쎛 筌뤴뫀紐?揶쏆늿? 燁삳똾源됪에?볥젃???????롫즲嚥??怨뚭퍙??됰뮸??덈뼄. ??곷퓠 ?怨뺤뵬 `git/lsp/zip/project_rule/snippet_run` 揶쏆늿? ??됱읈 ??已???怨??袁⑸퓠???癒?짗 ?類?뇣?遺얜쭢??덈뼄.
- ?????쇱젟 ?怨뺣짗????ｍ뜞 獄쏆꼷???됰뮸??덈뼄. `AgentSettingsWindow`?? `SettingsWindow`???袁㏓럡 燁삳?諭? ???紐꾩춿疫? ??쑵????袁㏓럡 ???? ?袁㏓럡 亦낅슦釉????關??canonical ??已?疫꿸퀣???곗쨮 ??덉삂??렽?疫꿸퀣?????觀而?? alias ?紐낆넎??곗쨮 ??る땾??몃빍??
- ??쎄텢 ?온????살구?? ?袁⑹삺 ?닌듼??筌띿쉳苡??袁れ넅??됰뮸??덈뼄. 疫꿸퀡????쎄텢 ????? ?곕떽? ???묊몴???ｍ뜞 嚥≪뮆諭??롫뮉 ?癒?カ, 筌욊낯???紐꾪뀱 ??쎄텢???怨????類ㅼ퐠 ?怨뚭퍙 ??쎄텢??揶쏆늿??癰귣똻肉т틠?곕뮉 獄쎻뫚堉??곗쨮 ??쇱젟/??遊??얜㈇?꾤몴?癰귣똻???됰뮸??덈뼄.
- 野꺜筌? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_toolcat\\ -p:IntermediateOutputPath=obj\\verify_toolcat\\` 野껋럡??0 / ??살첒 0
- 野꺜筌? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter AgentToolCatalogTests -p:OutputPath=bin\\verify_toolcat_tests\\ -p:IntermediateOutputPath=obj\\verify_toolcat_tests\\` ???궢 8
- 筌〓㈇?? ???뮞????슢諭?餓?疫꿸퀣?????뵬 `src/AxCopilot.Tests/Services/WorkspaceContextGeneratorTests.cs`??nullable 野껋럡??1椰꾨똻????ｍ뜞 ??뽯뻻??뤿???곌돌, ??苡?癰궰野껋럩肉????野껋럡?х몴??곕떽????????녿릭??щ빍??

---

## 1. ?袁⑥쨮??븍뱜 揶쏆뮇??

AX Copilot?? Windows????밴텦???怨쀬퓗 + AI ?癒?뵠?袁る뱜 ?怨쀫뮞?????源놁뿯??덈뼄.
- **?怨쀬퓗**: Alfred/Raycast ?????깆벥 ??? 野꺜?? 筌뤿굝議???쎈뻬, ?袁⑹졐
- **?癒?뵠?袁る뱜**: LLM 疫꿸퀡而????酉???꾨뗀諭??얜챷苑??臾믩씜 ?癒?짗??(?袁㏓럡 ?紐꾪뀱 ?룐뫂遊?
- **??獄?*: ??뽯뮞???귐딅꺖?? ???계퉪?諭? ??쎄쾿?깃퀣爰?????쥓???臾롫젏

---

## 2. 疫꿸퀣????쎄문

| ????| 揶?|
|------|-----|
| ?袁⑥쟿?袁⑹뜖??| .NET 8 (net8.0-windows10.0.17763.0) |
| UI | WPF + Windows Forms (??륁뵠?됰슢??? |
| ?紐꾨선 | C# 12 |
| ???쉘 | MVVM, ??源??疫꿸퀡而? ?源?????뺥돩??|
| ???뮞??| xUnit 2.9 + FluentAssertions 6.12 |
| ??슢諭?| dotnet CLI, PublishSingleFile |

### 雅뚯눘??NuGet ???텕筌왖

| ???텕筌왖 | ??몃즲 |
|--------|------|
| DocumentFormat.OpenXml 3.2.0 | DOCX/XLSX/PPTX ??밴쉐 |
| Markdig 0.37.0 | Markdown ??HTML ???쐭筌?|
| Microsoft.Data.Sqlite 8.0 | SQLite (???????關?? |
| Microsoft.Web.WebView2 | HTML 沃섎챶?곮퉪?용┛, 揶쎛??諭??됯퀣堉?|
| QRCoder 1.6.0 | QR ?꾨뗀諭???밴쉐 |
| System.Security.Cryptography.ProtectedData | DPAPI ?酉???|
| UglyToad.PdfPig | PDF ??꾨┛ |

---

## 3. ?遺억펷???닌듼?

```
src/
????? AxCopilot/              # 筌롫뗄??WPF ??(v0.7.3)
??  ????? Assets/             # ?袁⑹뵠?? ?袁ⓥ봺??JSON, ?酉??遺얜쭆 揶쎛??諭? 筌띾뜆?よ굜酉??
??  ????? Core/               # FuzzyEngine, CommandResolver, InputListener, PluginHost
??  ????? Handlers/           # 136揶???슦???筌뤿굝議??紐껊굶????  ????? Models/             # AppSettings, ChatModels, McpSettings
??  ????? Security/           # AntiTamper (?遺얠쒔椰??遺용벰???뵬???癒?)
??  ????? Services/           # 60揶???뺥돩????  ??  ?遺??? Agent/          # ?癒?뵠?袁る뱜 ?룐뫂遊?+ 114揶??袁㏓럡
??  ????? Themes/             # 9揶????춳 (Dark, Light, OLED, Nord, Monokai ??
??  ????? ViewModels/         # LauncherViewModel, SettingsViewModel, StatisticsViewModel
??  ?遺??? Views/              # 30揶?XAML ??덈즲??????? AxCopilot.SDK/          # ???쑎域밸챷??SDK (IActionHandler ?紐낃숲??륁뵠??
????? AxCopilot.Installer/    # Windows Forms ??쇳뒄 ?袁⑥쨮域밸챶??(.NET Framework 4.8)
????? AxCopilot.Tests/        # xUnit ??μ맄/???? ???뮞???遺??? AxKeyEncryptor/         # API ??DPAPI ?酉????醫뤿뼢?귐뗫뼒
```

---

## 4. ????뽰삂 ?癒?カ (App.xaml.cs)

```
OnStartup()
  ??? AntiTamper ?遺얠쒔椰?揶쏅Ŋ? (Release ??슢諭?
  ??? ??μ뵬 ?紐꾨뮞??곷뮞 獒뺛끋????類ㅼ뵥
  ??? SettingsService ?λ뜃由??+ ??쇱젟 嚥≪뮆諭?
  ??? ChatStorageService 癰귣떯? ?類ㅼ퐠 ??쎈뻬 (筌띾슢利??????類ｂ봺)
  ??? L10n ?紐꾨선 ?λ뜃由??  ??? ??뺥돩???λ뜃由??  ??  ??? AgentMemoryService
  ??  ??? ChatSessionStateService
  ??  ??? AppStateService
  ??  ??? IndexService (獄쏄퉫???깆뒲?????뵬 ?紐껊쑔??
  ??  ??? FuzzyEngine + CommandResolver
  ??  ??? ContextManager
  ??  ??? SessionTrackingService
  ??  ??? WorktimeReminderService
  ??  ?遺? ClipboardHistoryService
  ??? ??슦????紐껊굶???源낆쨯 (136揶?
  ??? SchedulerService + PluginHost ?λ뜃由??  ??? InputListener ??뽰삂 (疫꼲嚥≪뮆苡????텕)
  ?遺? ?怨쀬퓗/??쇱젟/?紐껋쟿????덈즲????밴쉐
```

---

## 5. ???뼎 ?袁り텕??우퓗

### 5.1 ?怨쀬퓗 (Launcher)

**野꺜?????뵠?袁⑥뵬??*: ???????낆젾 ??`CommandResolver` (?臾먮あ??筌띲끉臾? ??`FuzzyEngine` (??? 野꺜?? ??野껉퀗???類ｌ졊 ??UI ???쐭筌?
- `FuzzyEngine`: ???뵬 ?紐껊쑔??疫꿸퀡而???? 筌띲끉臾? ?癒?땾 ??뽰맄
- `CommandResolver`: ?紐껊굶????깆뒭??(?臾먮あ??`@`, `!`, `#`, `~`, `>`, `$` ??
- `IndexService`: 獄쏄퉫???깆뒲?????뵬 ?紐껊쑔??(`.git`, `node_modules` ????뽰뇚)

**?袁⑹졐**: ?源낅뮟 筌뤴뫀??? ????袁⑥쨮, 筌롫뗀?? ?醫롫뎁, 筌?꼶??? 獄쏄퀬苑ｇ뵳?
### 5.2 ?癒?뵠?袁る뱜 (Agent Loop)

```
?????筌롫뗄?놅쭪?
  ??LlmService.StreamAsync() (LLM API ?紐꾪뀱)
  ???臾먮뼗 ??쎈뱜?귐됱빪 ??뤿뻿
  ???袁㏓럡 ?紐꾪뀱 揶쏅Ŋ? ??
      ??ToolRegistry?癒?퐣 ?袁㏓럡 鈺곌퀬??
      ??亦낅슦釉??類ㅼ뵥 (AskPermissionCallback)
      ???袁㏓럡 ??쎈뻬
      ??野껉퀗?든몴??뚢뫂???쎈뱜???곕떽?
      ??LLM ???뉒빊?(獄쏆꼶??
  ??筌ㅼ뮇伊???용뮞???臾먮뼗 獄쏆꼹??
```

**???뼎 ?????*:
- `AgentLoopService` ???룐뫂遊??遺우춭 (獄쏆꼶?? ??깅뻻?類?/??而? ??源??獄쏆뮉六?
- `AxAgentExecutionEngine` ???袁㏓럡 ??쎈뻬 鈺곌퀣??
- `AgentLoopParallelExecution` ??癰귣쵎???袁㏓럡 ??쎈뻬
- `AgentLoopTransitions` / `.Execution` ???怨밴묶 ?袁⑹뵠 嚥≪뮇彛?
- `ToolRegistry` ???袁㏓럡 ?源낆쨯/鈺곌퀬??
- `ContextCondenser` ???뚢뫂???쎈뱜 ?類ㅽ뀧 (?醫뤾쿃 ?온??

**?袁㏓럡 燁삳똾?믤⑥쥓??* (114揶?:
| 燁삳똾?믤⑥쥓??| ??됰뻻 |
|---------|------|
| ???뵬 I/O | FileReadTool, FileEditTool, FileManageTool, FileWriteTool |
| 野꺜??| GlobTool, GrepTool, CodeSearchTool, FileSearchTool |
| ?얜챷苑?| DocumentReaderTool, ExcelSkill, DocxSkill, PptxSkill, CsvSkill, HtmlSkill |
| ?꾨뗀諭?| BuildRunTool, SnippetRunnerTool, CodeReviewTool, TestLoopTool, LspTool |
| ?怨쀬뵠??| JsonTool, XmlTool, SqlTool, DataPivotTool, RegexTool |
| ??뽯뮞??| ProcessTool, EnvTool, ZipTool, ClipboardTool |
| ?④쑵???곕뗄??| TodoWriteTool, TaskTrackerTool, CheckpointTool, PlaybookTool |
| ?????| UserAskTool, SuggestActionsTool, NotifyTool |
| MCP | McpTool, McpListResourcesTool, McpReadResourceTool |

**?????袁㏓럡 ?袁り숲筌?* (`ToolRegistry.ToolTabOverrides`):

`IAgentTool.TabCategory` ?癒?뮉 `ToolTabOverrides` ?類ㅻ??댿봺嚥??袁㏓럡?????롦에??브쑬履??몃빍??
`GetActiveToolsForTab(activeTab)` 筌롫뗄苑??? ?袁⑹삺 ??肉?筌띿쉶???袁㏓럡筌?LLM???袁⑸꽊??뤿연 ?醫뤾쿃????됰튋??몃빍??

| ??| ??뽮쉐 ?袁㏓럡 甕곕뗄??| ??살구 |
|------|--------------|------|
| **Chat** | 0揶?| ??뽯땾 ???? ?袁㏓럡 ??곸뵠 LLM筌??臾먮뼗 |
| **Cowork** | ~50揶?| ???뵬/野꺜??+ ?얜챷苑??밴쉐(xlsx, docx, pptx...) + ?怨쀬뵠???醫뤿뼢 |
| **Code** | ~50揶?| ???뵬/野꺜??+ 揶쏆뮆而?git, build, lsp...) + ??뽯뮞????곌쾿?紐꺿봺 + ?醫뤿뼢 |

- Chat ???醫뤾쿃 ??됰튋: ~14,400?醫뤾쿃 ??0 (?袁㏓럡 ?類ㅼ벥 ?袁⑹읈 ??볤탢)
- Cowork/Code: ?대Ŋ媛???뽰뇚嚥?揶?~3,600?醫뤾쿃 ?곕떽? ??됰튋

### 5.3 LLM ??뺥돩??
**筌왖???⑤벀???*:
| ??뺥돩??| ??살구 |
|--------|------|
| `claude` / `sigmoid` | Anthropic Claude (Sigmoid API 野껋럩?) |
| `gemini` | Google Gemini API |
| `vllm` | OpenAI ?紐낆넎 vLLM (IBM CP4D 筌왖????釉? |
| `ollama` | 嚥≪뮇類?Ollama 筌뤴뫀??|

**筌뤴뫀????깆뒭??*: `ModelRouterService`?????립 ??살쒔??깆뵠????쎄문 ??????餓?筌뤴뫀????뺥돩??? ??덉읅??곗쨮 ?袁れ넎 揶쎛??
**?醫뤾쿃 ?온??*: `TokenEstimator`嚥??뚢뫂???쎈뱜 疫뀀챷???곕뗄?? ??살쒔???쨮????`ContextCondenser`揶쎛 ?癒?짗 ?類ㅽ뀧
- `EstimateBaseOverhead(systemPromptLength, toolCount)`: ??뽯뮞???袁⑨세?袁る뱜 + ?袁㏓럡 ?類ㅼ벥 ??살쒔??삳굡 ?곕뗄??
- `_tool_use_blocks` 筌롫뗄?놅쭪? 0.6x, `tool_result` 筌롫뗄?놅쭪? 0.7x ?醫롮뵥 ?怨몄뒠
- ?뚢뫂???쎈뱜 ???????뽯뻻????뽯뮞???袁⑨세?袁る뱜 + ?袁㏓럡 ??살쒔??삳굡 ??釉?

### 5.4 ???????關??

- `ChatStorageService`: SQLite 疫꿸퀡而??????怨몃꺗??- `ChatSessionStateService`: 筌롫뗀?덄뵳????紐꾨??怨밴묶 ?온??- `ChatConversation`: 筌롫뗄?놅쭪? 筌뤴뫖以?+ ??쎈뻬 ??源?????袁⑥뵬??+ `Archived` ?袁⑸춦???????삋域?
---

## 6. UI ?④쑴留?

### 雅뚯눘????덈즲??
| ??덈즲??| ??釉?|
|--------|------|
| `LauncherWindow` | 筌롫뗄???怨쀬퓗 (野꺜?? ?袁⑹졐, 野껉퀗??筌뤴뫖以? |
| `ChatWindow` | AI ?癒?뵠?袁る뱜 ????(筌?쑵??Cowork/?꾨뗀諭??? |
| `DockBarWindow` | ??獄?(??뽯뮞???귐딅꺖?? ??쥓???臾롫젏) |
| `SettingsWindow` | ??쇱젟 ?온??|
| `AgentSettingsWindow` | ?癒?뵠?袁る뱜 ?袁⑹뒠 ??쇱젟 |
| `AgentStatsDashboardWindow` | ?癒?뵠?袁る뱜 ????????뺣궖??|
| `SkillEditorWindow` | ??쎄텢 ?紐꾩춿疫?|
| `SkillGalleryWindow` | ??쎄텢 揶쎼끇??뵳?|
| `TrayMenuWindow` | ??뽯뮞???紐껋쟿??筌롫뗀??|
| `PreviewWindow` | ?얜챷苑?沃섎챶?곮퉪?용┛ (WebView2) |

### ChatWindow ?브쑵釉??닌듼?

`ChatWindow.xaml.cs`??partial class嚥?疫꿸퀡?ヨ퉪??브쑵釉?

| ???뵬 | ??釉?|
|------|------|
| `ChatWindow.xaml.cs` | 筌롫뗄???????쎈뱜??됱뵠?? ??쎈뱜?귐됱빪, ??낆젾 筌ｌ꼶??|
| `ChatWindow.AgentEventProcessor.cs` | ?癒?뵠?袁る뱜 ??源????뤿뻿/??깆뒭??|
| `ChatWindow.AgentEventRendering.cs` | ?癒?뵠?袁る뱜 ??源??獄쏄퀡瑗?燁삳?諭????쐭筌?(SessionStart/UserPromptSubmit ???) |
| `ChatWindow.AgentStatusPresentation.cs` | ?癒?뵠?袁る뱜 ??쇰뻻揶??怨밴묶 ??뽯뻻 |
| `ChatWindow.ComposerQueuePresentation.cs` | ?臾믨쉐疫???UI |
| `ChatWindow.ContextUsagePresentation.cs` | ?뚢뫂???쎈뱜 ?????筌???밸씜 |
| `ChatWindow.ConversationFilterPresentation.cs` | ?????袁り숲筌?|
| `ChatWindow.ConversationListPresentation.cs` | ?????뺤뺍 ????筌뤴뫖以?|
| `ChatWindow.ConversationManagementPresentation.cs` | ??????밴쉐/?????온??|
| `ChatWindow.FileBrowserPresentation.cs` | ???뵬 ?됰슢??怨? UI |
| `ChatWindow.FooterPresentation.cs` | ??롫뼊 獄?(???? 亦낅슦釉? |
| `ChatWindow.GitBranchPresentation.cs` | Git ?됰슢?뽫㎉???뽯뻻/?袁れ넎 |
| `ChatWindow.LiveProgressPresentation.cs` | ??쇰뻻揶?筌욊쑵六??怨밴묶 |
| `ChatWindow.MessageBubblePresentation.cs` | 筌롫뗄?놅쭪? 甕곌쑬?????쐭筌?|
| `ChatWindow.MessageInteractions.cs` | 筌롫뗄?놅쭪? 癰귣벊沅??紐꾩춿/?????|
| `ChatWindow.PermissionPresentation.cs` | 亦낅슦釉???밸씜/獄쏄퀡瑗?UI |
| `ChatWindow.PlanApprovalPresentation.cs` | ?④쑵???諭??燁삳?諭?|
| `ChatWindow.PopupPresentation.cs` | ?⑤벏????밸씜 ?닌딄쉐 |
| `ChatWindow.PreviewPresentation.cs` | ???뵬 沃섎챶?곮퉪?용┛ ??|
| `ChatWindow.SelectionPopupPresentation.cs` | ??곌쾿?紐꺿봺 ?醫뤾문 ??밸씜 |
| `ChatWindow.SidebarInteractionPresentation.cs` | ?????뺤뺍 ?怨뱀깈?臾믪뒠 |
| `ChatWindow.StatusPresentation.cs` | ?怨밴묶 獄쏄퀣?/??쎈뱜??|
| `ChatWindow.SurfaceVisualPresentation.cs` | ??볦퍟 ??ｋ궢 (疫꼲嚥≪뮇?? ?袁⑸뮞 ?? |
| `ChatWindow.TaskSummary.cs` | ?臾믩씜 ?遺용튋 燁삳?諭?|
| `ChatWindow.TimelinePresentation.cs` | ???袁⑥뵬???類ｌ졊, 筌?Ŋ?? ??源???袁り숲筌?|
| `ChatWindow.TopicPresetPresentation.cs` | 雅뚯눘???袁ⓥ봺??UI |
| `ChatWindow.TranscriptHost.cs` | ?紐껋삏??쎄쾿?깆????紐꾨뮞???뚢뫂???瑗?|
| `ChatWindow.TranscriptPolicy.cs` | ?紐껋삏??쎄쾿?깆?????뽯뻻 ?類ㅼ퐠 |
| `ChatWindow.TranscriptRenderExecution.cs` | ?紐껋삏??쎄쾿?깆??????쐭 ??쎈뻬 |
| `ChatWindow.TranscriptRenderPlanner.cs` | ?紐껋삏??쎄쾿?깆??????쐭 ?④쑵??|
| `ChatWindow.TranscriptRendering.cs` | ?紐껋삏??쎄쾿?깆??????쐭筌?|
| `ChatWindow.TranscriptVirtualization.cs` | ?紐껋삏??쎄쾿?깆???揶쎛?怨뱀넅 (??域뱀뮆?????? |
| `ChatWindow.SystemPromptBuilder.cs` | ??뽯뮞???袁⑨세?袁る뱜 ??덉읅 鈺곌퀡??(???袁ⓥ봺???뚢뫂???쎈뱜 雅뚯눘?? |
| `ChatWindow.OverlaySettingsPresentation.cs` | ?紐껋뵬????쇱젟 ??밸씜 (筌뤴뫀?? ??쥓???る? |
| `ChatWindow.UserAskPresentation.cs` | ?????筌욌뜄揆 ?紐껋뵬??燁삳?諭?|
| `ChatWindow.VisualInteractionHelpers.cs` | ??볦퍟 ?怨뱀깈?臾믪뒠 ????|

### ???춳 ??뽯뮞??
9揶????춳 XAML ?귐딅꺖???類ㅻ??댿봺: `Dark`, `Light`, `OLED`, `Nord`, `Monokai`, `Catppuccin`, `Sepia`, `Alfred`, `AlfredLight`

?怨??????춳 ?袁れ넎: `SettingsService.Settings.Launcher.Theme` 癰궰野????귐딅꺖???類ㅻ??댿봺 ?대Ŋ猿?

---

## 7. ??쇱젟 ?닌듼?(AppSettings)

### 筌ㅼ뮇湲????쇱젟

| ??욧쉐 | 疫꿸퀡??첎?| ??살구 |
|------|--------|------|
| `AiEnabled` | true | AI 疫꿸퀡????뽮쉐??|
| `OperationMode` | "internal" | ??곸겫 筌뤴뫀諭?(internal/external) |
| `Hotkey` | "Alt+Space" | ?怨쀬퓗 ??ν뀧??|
| `CleanupPeriodDays` | 30 | ????癰귣떯? 疫꿸퀗而?(?? |
| `InternalModeEnabled` | true | ??沅?筌뤴뫀諭???? |

### LauncherSettings (餓λ쵐爰?

| 域밸챶竊?| 雅뚯눘????욧쉐 |
|------|----------|
| ??뽯뻻 | `Theme`, `Opacity`, `Position`, `Width`, `MaxResults` |
| 疫꼲嚥≪뮇??| `EnableRainbowGlow`, `EnableSelectionGlow`, `ShowLauncherBorder` |
| ?袁⑹졐 | `ShowWidgetPerf`, `ShowWidgetPomo`, `ShowWidgetNote`, `ShowWidgetWeather`, `ShowWidgetCalendar`, `ShowWidgetBattery` |
| ??獄?| `DockBarItems`, `DockBarAutoShow`, `DockBarOpacity`, `DockBarRainbowGlow` |
| 疫꿸퀡??| `EnableFavorites`, `EnableRecent`, `EnableActionMode`, `EnableClipboardAutoCategory` |

### LlmSettings (餓λ쵐爰?

?癒?뵠?袁る뱜??LLM ?怨뚭퍙 ??쇱젟: ??뺥돩???醫뤾문, 筌뤴뫀?? API ??(DPAPI ?酉???, ?遺얜굡????? ??ㅻ즲, 筌ㅼ뮆? ?醫뤾쿃 ??
| ??욧쉐 | 疫꿸퀡??첎?| ??살구 |
|------|--------|------|
| `UseAutomaticProfileTemperature` | true | ?源낆쨯 筌뤴뫀???袁⑥쨮???뵬???癒?짗 temperature ?類ㅼ퐠 |
| `EnableDetailedLog` | false | ??곌쾿???쨮???怨멸쉭 嚥≪뮄??(LLM ?遺욧퍕/?臾먮뼗, ?袁㏓럡 ???? |
| `DetailedLogRetentionDays` | 3 | ?怨멸쉭 嚥≪뮄??癰귣떯? 疫꿸퀗而?(?? |
| `EnableRawLlmLog` | false | LLM ?遺욧퍕/?臾먮뼗 ?癒??疫꿸퀡以?(?遺얠쒔繹먮굞?? |

### RegisteredModel ??쎈뻬 ?袁⑥쨮???뵬

筌뤴뫀?썼퉪?`ExecutionProfile`嚥??袁㏓럡 ?紐꾪뀱 揶쏅베猷? ????? 筌롫뗀?덄뵳??類ㅽ뀧 雅뚯눘???깆뱽 鈺곌퀣??

| ?袁⑥쨮???뵬 | ??살구 |
|---------|------|
| `balanced` | 疫꿸퀡??域뱀쥚??筌뤴뫀諭?|
| `tool_call_strict` | ?袁㏓럡 ?紐꾪뀱 揶쏅벡???袁㏐봄 筌뤴뫀諭?|
| `reasoning_first` | ?곕뗀以??怨쀪퐨 筌뤴뫀諭?|
| `fast_readonly` | ??쥓????꾨┛ ?袁⑹뒠 筌뤴뫀諭?|
| `document_heavy` | ?얜챷苑?筌ｌ꼶??筌욌쵐夷?筌뤴뫀諭?|

---

## 8. ???쑎域밸챷????뽯뮞??
### SDK (AxCopilot.SDK)

```csharp
public interface IActionHandler
{
    string? Prefix { get; }        // ?臾먮あ??(null??????? 野꺜??곗춸)
    PluginMetadata Metadata { get; }
    Task<IEnumerable<LauncherItem>> GetItemsAsync(string query, CancellationToken ct);
    Task ExecuteAsync(LauncherItem item, CancellationToken ct);
}
```

### 揶쏆뮆而?獄쎻뫖苡?

1. `AxCopilot.SDK` 筌〓챷???뤿연 `IActionHandler` ?닌뗭겱
2. ??슢諭??`.dll`??`settings.json`??`Plugins` 獄쏄퀣肉??野껋럥以??源낆쨯
3. `PluginHost`揶쎛 ????뽰삂 ????덉읅 嚥≪뮆諭?

---

## 9. ??슢諭?獄???쎈뻬

### 揶쏆뮆而???슢諭?

```bash
dotnet build src/AxCopilot/AxCopilot.csproj
```

### ??쥓????슢諭?(?酉?????쇳뒄?袁⑥쨮域밸챶????몄셽)

```bash
./build-quick.sh
```

筌롫뗄???源낆춸 self-contained ??μ뵬 ???뵬嚥???슢諭??몃빍?? AxKeyEncryptor/Installer/??뺣즴?遺? 椰꾨?瑗?怨쀫선 ??쥓??揶쏆뮆而?獄쏆꼶????怨밸???몃빍??

### ?깅??????슢諭?(??μ뵬 ???뵬)

```bash
dotnet publish src/AxCopilot/AxCopilot.csproj -c Release -r win-x64 --self-contained
```

?깅??????슢諭?????
- `PublishSingleFile`: ??μ뵬 ??쎈뻬 ???뵬
- `EnableCompressionInSingleFile`: ?類ㅽ뀧 ?怨몄뒠
- `PublishReadyToRun`: AOT ?袁ⓥ봺?뚮똾???- `DebugType=none`: ?遺얠쒔域???????볤탢
- `TrimMode=partial`: IL ?紐꺿봺獄?
### ???뮞??
```bash
dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj
```

---

## 10. 甕곌쑴???온??
- `AxCopilot.csproj`??`<Version>` ??볥젃 ??롪돌筌?癰궰野껋?釉?쭖????袁⑷퍥??獄쏆꼷??
- ??쇱젟 ??쎄텕筌?甕곌쑴??? `SettingsService.cs` ??`CurrentSettingsVersion`?癒?퐣 癰귢쑬猷??온??- 筌띾뜆?졿뉩紐껋쟿??곷? `SettingsService`揶쎛 ??곸읈 甕곌쑴????쇱젟 ???뵬???癒?짗 ??껊젃??됱뵠??
---

## 11. 癰귣똻釉?

| ????| ?닌뗭겱 |
|------|------|
| API ??????| DPAPI ?酉???(System.Security.Cryptography.ProtectedData) |
| ???온???袁㏓럡 | AxKeyEncryptor (癰귢쑬猷??醫뤿뼢?귐뗫뼒) |
| ??딅뼒 ????| ?遺얠쒔椰??遺용벰???뵬??揶쏅Ŋ? (Release ??슢諭? `Security/AntiTamper.cs`) |
| Unsafe ?꾨뗀諭?| `AllowUnsafeBlocks=true` (ScreenCaptureHandler ??????怨쀪텦?? |

---

## 12. ?源낅뮟 筌ㅼ뮇?????곷열

### ?醫륁몧 CPU 筌ㅼ뮇???(2026-04-09)

| ????| 癰궰野???| 癰궰野???|
|------|---------|---------|
| PerformanceMonitorService ??彛?| 2??| 5??|
| ?袁⑹졐 ??????| 1??| 3??|
| ??됱뵥癰귣똻??疫꼲嚥≪뮇????????| 150ms | 300ms |
| ServerStatusService ??| 15??| 60??|

### ??쎈뱜?귐됱빪 ???쐭筌?筌ㅼ뮇???(2026-04-09)

- **TypingTimer**: 50ms ??80ms, `string.Concat` ??`char[]` 甕곌쑵????沅??- **CursorTimer**: ?袁⑷퍥 ?얜챷?????源????筌띾뜆?筌??얜챷?꾬쭕??대Ŋ猿?
- **StringBuilder.ToString()**: 30ms 筌ㅼ뮇??揶쏄쑨爰??怨뺤쨮??筌?- **RenderMessages**: ??쎈뱜?귐됱빪 餓??븍뜇釉?酉釉??袁⑷퍥 ????遺얠춦 獄쎻뫗? (鈺곌퀗由?獄쏆꼹??
- **???袁⑥뵬????源??*: ?臾볦뿺 筌뤴뫀諭?癒?퐣 ?怨쀫꺗 ??덉뵬 ToolCall 癰귣쵑鍮

### ?怨?????됱젟????륁젟 (2026-04-09)

| ???뵬 | ??륁젟 ??곸뒠 |
|------|----------|
| `CsvSkill.cs` | JSON 獄쏄퀣肉?筌??遺용꺖 `ValueKind` 野꺜筌??곕떽? |
| `HtmlSkill.cs` | gradient `Split(',')` 野껉퀗??`Length >= 2` 揶쎛???곕떽? |
| `ChatWindow.xaml.cs` | `ParseGenericAction` ??獄쏄퀣肉?揶쎛?? `ShowDropActionMenu` null 揶쎛?? `GetAgentLoop` `.FirstOrDefault()` ?袁れ넎 |
| `ChatWindow.GitBranchPresentation.cs` | async void ?紐껊굶??try/catch 癰귣똾??|
| `ChatWindow.xaml.cs` (BtnGitBranch_Click) | async void ?紐껊굶??try/catch 癰귣똾??|

### UI ??살쟿???봔??筌ㅼ뮇???2筌?(2026-04-09)

| ????| 癰궰野???| 癰궰野???| ??ｋ궢 |
|------|---------|---------|------|
| ??쎄쾿嚥??醫딅빍筌롫뗄???| 筌띲끇苡???16ms ????????밴쉐 | ??沅??32ms ??????1揶?| GC ?類ｌ젾 + ???????袁⑹읅 ??곷꺖 |
| ?????뺤뺍 ?醫딅빍筌롫뗄???| 筌띲끇苡???10ms ????????밴쉐 | ??沅??32ms ??????1揶?| ??덉뵬 |
| Git ?됰슢?뽫㎉?UI | `Dispatcher.Invoke` (?됰뗀以?? | `Dispatcher.InvokeAsync` (??고닜嚥≪뮉沅? | UI ??살쟿??筌△뫀????곷꺖 |
| ?醫뤾쿃 ???????| 筌?250ms PathGeometry ??源??| 1% 沃섎챶彛?癰궰???????쐭筌???몄셽 | ?븍뜇釉?酉釉???됱뵠?袁⑹뜍 ?怨쀪텦 ??볤탢 |
| ????野꺜????????| 140ms | 300ms | ?λ뜄??7????3??|
| ?癒?뵠?袁る뱜 ??源????????| 140ms (??쎈뱜?귐됱빪: 300/420) | 200ms (??쎈뱜?귐됱빪: 350/500) | ??源??筌ｌ꼶????뜄猷??袁れ넅 |
| 獄쏆꼷?????됱뵠?袁⑹뜍 ??????| 120ms | 250ms | ?귐딄텢??곸グ ?遺얠뺍??곷뮞 揶쏅벤??|
| ????筌뤴뫖以?LINQ | Where?? + Count?? = ?귐딅뮞??5????쀬돳 | Where 1??癰귣쵑鍮 + ??μ뵬 ?룐뫂遊?燁삳똻???| ?醫딅뼣/??쀬돳 ????揶쏅Ŋ??|

### ?닌듼??筌롫뗀?덄뵳???됱젟????륁젟 (2026-04-09)

| ?얜챷??| ?袁⑺뒄 | ??륁젟 |
|------|------|------|
| Events ?뚎됱젂???얜똾釉??源놁삢 | `AgentLoopService.cs` | 500揶??λ뜃??????살삋????源???癒?짗 ??볤탢 |
| ???뵬 ?됰슢??怨? ???????ヂ??| `ChatWindow.FileBrowserPresentation.cs` | 筌띲끇苡???????????밴쉐 ????沅?????쉘 |
| ??롡봺?믪눛??筌?Ŋ??沃섎챷?숂뵳?| `ChatWindow.TranscriptVirtualization.cs` | 癰귣똻? ??뺣즲 240??20, 1.5獄??λ뜃?????類ｂ봺 |
| WorkflowAnalyzer UI ?됰뗀以??| `WorkflowAnalyzerWindow.xaml.cs` | `Dispatcher.Invoke` ??`InvokeAsync` |

### ?닌듼???귐뗫솯?醫딆춦 P1 (2026-04-09)

| ????| ???뵬 | 癰궰野?|
|------|------|------|
| ?紐낃쾿?귐됱컲?????쐭 hiddenCount ??됱젟??| `ChatWindow.TranscriptRenderPlanner.cs` | ??쎈뱜?귐됱빪 餓?hiddenCount 揶쏅Ŋ??筌△뫀????prefix ???븍뜆?ょ㎉?롮쨮 ?紐낅립 ?袁⑷퍥 ???????媛?獄쎻뫗? |
| ??쑨??????쐭 筌△뫀??| `ChatWindow.TranscriptRendering.cs` | 筌ㅼ뮇?????? ?怨밴묶?癒?퐣 RenderMessages 筌앸맩??獄쏆꼹?????븍뜇釉?酉釉?UI ???꾤빊???볤탢 |
| ConversationList ??源???袁⑹뿫 | `ChatWindow.ConversationListPresentation.cs` | ?????5揶????뼄 ?紐껊굶????ConversationPanel????μ뵬 ?袁⑹뿫 ?紐껊굶??(Tag 疫꿸퀡而??브쑨由?. ???袁れ넎 ??250揶??紐껊굶???袁⑹읅 ??곷꺖 |
| TopicPreset ??源???袁⑹뿫 | `ChatWindow.TopicPresetPresentation.cs` | 燁삳?諭??3揶????뼄 ?紐껊굶????TopicButtonPanel????μ뵬 ?袁⑹뿫 ?紐껊굶?? ???袁れ넎 ??45揶??紐껊굶???袁⑹읅 ??곷꺖 |
| ?⑤벏??VisualTree ????| `ChatWindow.VisualInteractionHelpers.cs` | `FindAncestorWithTag<T>`, `FindAncestor<T>` ?醫뤿뼢 ?곕떽? |

### ?닌듼???귐뗫솯?醫딆춦 P2 (2026-04-09)

| ????| ???뵬 | 癰궰野?|
|------|------|------|
| _agentLiveContainer ?紐낃쾿?귐됱컲????됱뒠 | `TranscriptRenderPlanner.cs`, `TranscriptRenderExecution.cs` | ??깆뵠???뚢뫂???瑗ョ몴?expectedChildCount????釉? ?紐낃쾿?귐됱컲?????袁⑸뻻 ?브쑬????沅????`hasExternalChildren` 筌△뫀????곷꺖 |
| ??쎈뱜?귐됱빪 append-only ???쐭 | `TranscriptRenderExecution.cs`, `TranscriptRendering.cs` | prefix ??쑨???怨좎돳??롫뮉 `TryApplyStreamingAppendRender` ?곕떽? ??stable ???봔?브쑴彛???온?④쑬彛??類ㅼ뵥, ?????됵쭕??곕떽? |
| Permission ??源???袁⑹뿫 | `ChatWindow.PermissionPresentation.cs` | ??곕뼣 4揶????뼄 ??PermissionItems????μ뵬 ?袁⑹뿫 ?紐껊굶??+ `PermissionItemTag` |
| Preview ????源???袁⑹뿫 | `ChatWindow.PreviewPresentation.cs` | ????7揶????뼄 ??PreviewTabPanel????μ뵬 ?袁⑹뿫 ?紐껊굶??+ `PreviewTabTag` |
| GitBranch ??源???袁⑹뿫 | `ChatWindow.GitBranchPresentation.cs`, `SelectionPopupPresentation.cs` | `CreateFlatPopupRow`/`CreatePopupMenuRow` ??깆벥 ???뼄 ??GitBranchItems????μ뵬 ?袁⑹뿫 + `PopupRowTag` |

### ?닌듼???귐뗫솯?醫딆춦 P3 (2026-04-09)

| ????| ???뵬 | 癰궰野?|
|------|------|------|
| FileBrowser 筌뤿굞?????곸젫 | `ChatWindow.FileBrowserPresentation.cs` | TreeViewItem ???뼄?誘⑹구筌?筌롫뗄苑??`FileTreeItem_Expanded/DoubleClick/RightClick`) ?袁れ넎. `BuildFileTree()` ??`DetachFileTreeHandlers()` ??? ?紐꾪뀱嚥?Clear ???紐껊굶????곸젫. ?紐꺿봺 ???꾤빊類ｋ뼣 300揶??紐껊굶???袁⑹읅 ??곷꺖 |

> ?袁⑷퍥 ?④쑵???袁⑥┷. `docs/STRUCTURAL_REFACTORING_PLAN.md` 筌〓챷??

### ?怨쀬퓗 夷??癒?뵠?袁る뱜 ?귐딅꺖????됱젟????륁젟 (2026-04-09)

| ????| ???뵬 | 癰궰野?|
|------|------|------|
| LauncherWindow ??源???袁⑸땾 | `LauncherWindow.xaml.cs` | `vm.CloseRequested`, `vm.PropertyChanged`, `app.IndexService.IndexRebuilt` ?紐껊굶??? ?袁⑤굡 ??????`OnClosed`?癒?퐣 `-=` ??곸젫. ViewModel癰귣???Window揶쎛 ?믪눘? ???쁽 ??GC ?袁⑸땾 獄쎻뫗? |
| ChatWindow ???????類ｂ봺 | `ChatWindow.xaml.cs` | `Closed` ?紐껊굶??肉??袁⑥뵭??8揶???????筌뤿굞???`Stop()` ?곕떽? + `StopAgentEventProcessor()` ?紐꾪뀱 |
| Events ??살쟿????됱읈 | `AgentLoopService.cs` | Dispatcher ??곸뱽 ??`Events` ?臾롫젏??`lock(Events)` ?곕떽? ????덈뻻 EmitEvent ?紐꾪뀱 ??IndexOutOfRange ?????獄쎻뫗? |
| NotifyTool ???????袁⑹읅 | `NotifyTool.cs` | ???뵝??`new DispatcherTimer` ??`DoubleAnimation.Completed` ?꾩뮆媛??곗쨮 ??筌? 100揶????뵝 ??100揶?????????덈뻻 鈺곕똻????곷꺖 |
| LauncherWindow ?醫롫뮞????????| `LauncherWindow.xaml.cs` | `ShowToast()` 筌??紐꾪뀱 `new DispatcherTimer` ????沅?????쉘 + 筌뤿굝梨?筌롫뗄苑??`ToastTimer_Tick`) |
| LauncherWindow ???????類ｂ봺 | `LauncherWindow.xaml.cs` | `OnClosed`??`_toastTimer?.Stop()`, `_indexStatusTimer?.Stop()` ?곕떽? |

### Hot path 夷??귐딅꺖???곕떽? 筌ㅼ뮇???(2026-04-09)

| ????| ???뵬 | 癰궰野?|
|------|------|------|
| GetRuntimeActiveTools 筌?Ŋ??| `AgentLoopService.cs` | 獄쏆꼶???1~4???紐꾪뀱 ??`cachedActiveTools` 嚥≪뮇類?癰궰??롮쨮 1??筌?Ŋ?? foreach ??`activeToolNames` ?④쑴沅???룐뫂遊?獄쏅쉼?앮에??紐꾩뵠??쎈뱜 |
| SubAgentTool ?띯뫁???袁る솁 | `SubAgentTool.cs` | `CancellationTokenSource.CreateLinkedTokenSource(ct)` ?怨뺣짗. Task.Run + loop.RunAsync???醫뤾쿃 ?袁⑤뼎. ?봔筌?餓λ쵐? ???癒?뻼 筌앸맩???띯뫁??|
| ?袁⑹뵠???醫딅빍筌롫뗄?????? ??뽯선 | `LauncherWindow.xaml.cs` | `sb.Completed`?癒?퐣 筌앸맩????? ??`_iconAnimationDelayTimer` 8????뺤쟿?? ?醫딅뼣 ??뜄猷?75% 揶쏅Ŋ?? ????????뺤쟿???띯뫁????筌앸맩???袁れ넎 |
| JsonSerializerOptions ?⑤벊? | `AgentLoopService.cs` | `s_jsonOpts` ?類ㅼ읅 ?袁⑤굡 ?곕떽?, 4揶?`JsonSerializer.Serialize` ?紐꾪뀱???怨몄뒠. L4096 `System.Text.Json.` ?臾먮あ???類?뇣??|

### ?낅Т???곗뒪?ы넲 UI 媛쒖꽑 (2026-04-09)

| ????| ???뵬 | ??륁젟 ??곸뒠 |
|------|------|----------|
| 沃섎챶?곮퉪?용┛ Split Button | `ChatWindow.xaml` | 疫꿸퀣??`BtnPreviewToggle` (Ellipse ??+ "?袁ⓥ봺??) ??`[??沃섎챶?곮퉪?용┛ | ??` Split Button??곗쨮 ?대Ŋ猿? ?ル슣瑜??醫?, ?怨쀫? ?怨뺥닏嚥???뺚댘??쇱뒲 |
| 沃섎챶?곮퉪?용┛ ??뺚댘??쇱뒲 | `ChatWindow.PreviewPresentation.cs` | `ShowPreviewTabDropdown()` ????????筌뤴뫖以???밸씜, ???뵬 ?類ㅼ삢?癒???袁⑹뵠?? ??뽮쉐 ????륁뵠??깆뵠??|
| PreviewDot ??PreviewIcon | `ChatWindow.PreviewPresentation.cs` | `PreviewDot.Fill` 4????`PreviewIcon.Foreground` (AccentColor/SecondaryText) ?袁れ넎 |
| ?怨뺥닏嚥???녿┛??| `ChatWindow.PreviewPresentation.cs` | `UpdatePreviewChevronState()` ??`_previewTabs.Count` 疫꿸퀡而?IsHitTestVisible/Opacity ??뽯선 |
| ?④쑵??甕곌쑵????猷?| `ChatWindow.xaml` | MoodIconPanel ??덉읅 雅뚯눘????StatusBar XAML ?醫롫섧 ?遺용꺖 `BtnPlanViewer`嚥???猷?|
| ShowPlanButton ?귐뗫솯?醫딆춦 | `ChatWindow.PlanApprovalPresentation.cs` | ??덉읅 Add/Remove ??`Visibility` ?醫? ??λ떄??+ ??뉕탢???類ｂ봺 ?醫? |

### UX 揶쏆뮇苑?獄??????袁㏓럡 ?袁り숲筌?(2026-04-09)

| ????| ???뵬 | ??륁젟 ??곸뒠 |
|------|------|----------|
| ?????袁㏓럡 ?袁り숲筌?| `IAgentTool.cs`, `ToolRegistry.cs`, `AgentLoopService.cs` | `TabCategory` ??욧쉐 + `ToolTabOverrides` ?類ㅻ??댿봺嚥?Chat/Cowork/Code ?????袁㏓럡 ?브쑬履? Chat=0揶? Cowork=?얜챷苑??怨쀬뵠?? Code=揶쏆뮆而???뽯뮞??|
| FolderMapTool 疫꿸퀡??첎?癰궰野?| `FolderMapTool.cs` | `include_files` 疫꿸퀡??첎?`false` ??`true`. Description????????쀫립 揶쎛??諭??곕떽? |
| ?癒?뵠?袁る뱜 ??源????? | `AgentEventRendering.cs`, `TimelinePresentation.cs` | `SessionStart`/`UserPromptSubmit` ??? ??源?????袁⑥뵬????쑵紐??|
| ?????筌롫뗄?놅쭪? ???쐭筌?| `ChatWindow.xaml.cs` | ?袁⑸꽊 ??`InvalidateTimelineCache()` + `preserveViewport:false`嚥?筌앸맩????뽯뻻 癰귣똻??|
| ?袁⑸춦????疫꿸퀡??| `ChatModels.cs`, `ConversationManagementPresentation.cs`, `ConversationFilterPresentation.cs`, `ConversationListPresentation.cs` | `Archived` ??욧쉐, ?뚢뫂???쎈뱜 筌롫뗀???袁⑸춦?????醫?, ?????뺤뺍 ?袁り숲 甕곌쑵??|
| ?뚣끉??? ??????쎄쾿嚥▲끇而?| `ChatWindow.xaml` | 6px ????ScrollBar + Thumb ??깆뒲?? ScrollViewer 筌띾뜆?????살쒔 fade in/out ?醫딅빍筌롫뗄???|
| ??쎈뱜?귐됱빪 筌롫??껆뵳???됱뵠??| `ChatWindow.xaml`, `StatusPresentation.cs` | ??낆젾 獄쏅벡???袁⑸퓠 `StreamMetricsLabel` (野껋럡???볦퍢 夷????醫뤾쿃 ?? ??쇰뻻揶???뽯뻻 |
| ?袁ⓥ봺??燁삳?諭???????됱젟??| `ChatWindow.xaml`, `ChatWindow.xaml.cs` | WrapPanel `Background="Transparent"` + Dispatcher ?怨쀪퐨??뽰맄 `Loaded`嚥??怨밸샨 |
| ?뚢뫂???쎈뱜 ?醫뤾쿃 ?類μ넇??| `TokenEstimator.cs`, `ContextUsagePresentation.cs`, `ILlmService.cs` | ??뽯뮞???袁⑨세?袁る뱜 + ?袁㏓럡 ??살쒔??삳굡 ?곕뗄?? `_tool_use_blocks`/`tool_result` ?醫롮뵥 |
| UI ?袁ⓥ봺筌?獄쎻뫗? | `ChatWindow.xaml.cs` | `SaveLastConversations()`/`PersistConversationSnapshot()` ?????쐭筌???`Task.Run()` ??쑬猷욄묾???쎈뻬 |
| ??쥓????슢諭???쎄쾿?깆???| `build-quick.sh` | ?酉?????뺣즴????쇳뒄?袁⑥쨮域밸챶??椰꾨?瑗?怨뺣뮉 揶쏆뮆而????슢諭???쎄쾿?깆???|

### ?癒?뵠?袁る뱜 ?룐뫂遊??얜챷苑???밴쉐 ?癒?カ ??륁젟 (2026-04-09)

| ???뵬 | ??륁젟 ??곸뒠 |
|------|----------|
| `AgentLoopTransitions.Documents.cs` | `TryHandleTerminalDocumentCompletionTransitionAsync`?癒?퐣 `document_plan` ??곸뵠 獄쏅뗀以??얜챷苑??袁㏓럡 ?紐꾪뀱 ??鈺곌퀗由??ル굝利?獄쎻뫗? ??LLM???곕떽? 獄쏆꼶???곗쨮 ??곸뒠??癰귣떯而??????덈즲嚥???됱뒠 |
| `HtmlSkill.cs` | `MarkdownToHtml`?癒?퐣 LLM????뚯뿯??`<br>` ??볥젃揶쎛 ??곷뮞?냈??꾨늄??롫뮉 甕곌쑨????륁젟 ????곷뮞?냈??꾨늄 ?????쟿??곷뮞???遺얠쨮 癰귣똻????癰귣벊??|

### Cowork ?얜챷苑?沃섎챷源??夷???쎄쾿嚥?夷??袁⑸꽊 ??10??筌롫뜆????륁젟 (2026-04-09)

#### ?얜챷苑???밴쉐 ?癒?퉳 ?類ㅼ퐠 ??륁젟

| ???뵬 | ??륁젟 ??곸뒠 |
|------|----------|
| `AgentLoopExplorationPolicy.cs` | `ExplorationScope.DirectCreation` ?醫됲뇣 ??쇳맜???곕떽?. `HasDocumentCreationIntent()`嚥?"?臾믨쉐??곸㉭/筌띾슢諭??곸㉭/??μ㉭" ????밴쉐 ??덇텢 + ?얜챷苑?癰귣떯?????????쇱뜖??揶쏅Ŋ? |
| `AgentLoopExplorationPolicy.cs` | `DirectCreation` ??쇳맜?袁⑸퓠??glob/grep/folder_map ?癒?퉳 筌△뫀????`document_plan ??docx_create/html_create` 獄쏅뗀以???猷?|
| `AgentLoopExplorationPolicy.cs` | `FilterExplorationToolsForCurrentIteration`?癒?퐣 ?얜챷苑???밴쉐 ?袁㏓럡??筌ㅼ뮇?????뽰맄嚥?獄쏄퀣??|
| `AgentLoopExplorationPolicy.cs` | `ShouldInjectExplorationCorrection`?癒?퐣 DirectCreation ???癒?퉳 ?袁㏓럡 1???紐꾪뀱筌띾슣?앮에?筌앸맩???대Ŋ??雅뚯눘??|
| `TaskTypePolicy.cs` | docs 揶쎛?????? ??밴쉐 vs ??꾨┛嚥??브쑨由?????밴쉐 ??"獄쏆꼶諭????쇱젫 ???뵬??筌띾슢諭???? 筌뤿굞??|
| `AgentLoopService.cs` | DirectCreation ??쇳맜????源??筌롫뗄?놅쭪?: "?얜챷苑???밴쉐 筌뤴뫀諭?夷?獄쏅뗀以??얜챷苑뚨몴?筌띾슢諭??餓? |

#### ??쎄쾿嚥?甕곌쑨????륁젟

| ???뵬 | ??륁젟 ??곸뒠 |
|------|----------|
| `ChatWindow.xaml.cs` | 筌롫뗄?놅쭪? ?袁⑸꽊/??????뚣끇????뚮똾?????`RenderMessages(preserveViewport: true)` + `ForceScrollToEnd()` 鈺곌퀬鍮 ??`RenderMessages(preserveViewport: false)`嚥?癰궰野? viewport 癰귣벊?앮?ForceScrollToEnd 野껋?鍮 ??볤탢 |

**?癒?뵥**: `preserveViewport: true`?????쐭筌?????곸읈 ??쎄쾿嚥??袁⑺뒄??癰귣벊???롫뮉 ?꾨뗀諭띄몴?`DispatcherPriority.Background`嚥???됰튋. `ForceScrollToEnd()`??揶쏆늿? ?怨쀪퐨??뽰맄嚥???롫뼊 ??쎄쾿嚥▲끉????됰튋??뤿연 ???꾨뗀諭뜹첎? 野껋?鍮, ??쎄쾿嚥▲끉????롫뼊??곗쨮 ??揶쎛???얜챷??獄쏆뮇源?

#### ?袁⑸꽊 ??10??筌롫뜆????륁젟 (Critical Performance Fix)

| ???뵬 | ??륁젟 ??곸뒠 |
|------|----------|
| `ChatWindow.AgentStatusPresentation.cs` | `BuildFeedbackContext()` ??`_storage.LoadAllMeta()` (筌뤴뫀諭?.axchat ???뵬 癰귣벏??? + `_storage.Load()` x20??? 筌??袁⑸꽊筌띾뜄????녿┛ ??쎈뻬 ??1??筌?Ŋ??+ ?袁⑹삺 ??????곕굡獄쏄퉭彛?筌앸맩??獄쏆꼷??+ ?袁⑷퍥 揶쏄퉮??? 獄쏄퉫???깆뒲??|
| `ChatWindow.xaml.cs` | `Dispatcher.Invoke()` (??녿┛ ?됰뗀以?? ??`Dispatcher.InvokeAsync()` (??쑬猷욄묾?. background task?癒?퐣 UI ??살쟿???됰뗀以????볤탢 |
| `ChatWindow.xaml.cs` | `PrepareExecutionForConversation()` (??뽯뮞???袁⑨세?袁る뱜 ??슢諭? ?袁⑥쨮??븍뱜 域뱀뮇??筌롫뗀?덄뵳???곕굡獄??遺용뮞??I/O) ??`await Task.Run()`??곗쨮 獄쏄퉫???깆뒲????쎈뻬. UI ??살쟿??筌앸맩????媛?|

**?癒?뵥 ?브쑴苑?*: `BuildFeedbackContext()`揶쎛 `LoadAllMeta()` (筌뤴뫀諭?`.axchat` ???뵬 癰귣벏??遺뗫；??? + `Load()` x20 (20揶??????袁⑷퍥 嚥≪뮆諭띠쮯癰귣벏??? ??UI ??살쟿??뽯퓠????녿┛ ??쎈뻬. ????30揶???곴맒????5~10???됰뗀以??獄쏆뮇源?

### ??쎈뱜?귐됱빪 餓?UI 甕곌쑬苡??????揶쏆뮇苑?(2026-04-09)

?낅Т???곗뒪?ы넲 UI? 鍮꾧탳?덉쓣 ??WPF transcript媛 怨쇳븯寃??ㅼ떆 洹몃젮吏??臾몄젣瑜?遺꾩꽍?섍퀬 ?섏젙?덉뒿?덈떎.

**域뱀눖???癒?뵥**: React virtual DOM?? 癰궰野껋럥留??봔?브쑬彛?diff/patch???筌? WPF??筌????쐭筌띾뜄???袁⑷퍥 ??볦퍟???紐꺿봺?????댘 ????源??

| ?癒?뵥 | ???뵬 | ??륁젟 |
|------|------|------|
| `ItemsSource = null/??肉겼칰? ???袁⑷퍥 ??볦퍟???紐꺿봺 ???댘 + VirtualizingStackPanel ?뚢뫂???瑗???源??| `TranscriptRenderExecution.cs` | ??쎈뱜?귐됱빪 餓λ쵐肉??ItemsSource ?브쑬????肉겼칰?椰꾨?瑗?? ??ObservableCollection 筌욊낯??癰궰野껋럩?앮에???됱뵠?袁⑹뜍 ??λ뮞 筌ㅼ뮇???|
| ??깆뵠??筌욊쑵六?燁삳?諭?筌띲끇苡???源??????삳쐭/?닌됲뀋????쎈??袁⑷퍥??0?봔????쇰뻻 ??밴쉐 + ?醫딅빍筌롫뗄????????| `AgentEventRendering.cs` | `_liveProgressCard` 筌?Ŋ??+ `UpdateLiveProgressStepsInPlace()` ??燁삳?諭?1????밴쉐 ??????쎈?쭕??곕떽?, 疫꿸퀣????쎈?? ?怨쀭뒄 ????|
| ???쐭 ??????揶쏄쑨爰?1.5~2.2????WPF ?袁⑷퍥 ?????뽯퓠 ??쑵鍮???댭??⑤벀爰??| `ChatWindow.xaml.cs` | lightweight: 2.2s??s, normal: 1.5s??s ?????쐭 揶??겸뫖?????? ?類ｋ궖 |
| 筌????쐭筌띾뜄??3揶??醫딅빍筌롫뗄???Opacity + ScaleX + ScaleY) ?????| `AgentEventRendering.cs` | ??깆뵠??燁삳?諭?in-place ??낅쑓??꾨뱜嚥?疫꿸퀣???醫딅빍筌롫뗄???癰귣똻?? ????쎈?癒?춸 ?醫딅빍筌롫뗄????怨몄뒠 |

**??쑨??*:

| ????| ??륁젟 ??(WPF) | ??륁젟 ??| ?낅Т???곗뒪?ы넲 UI (React) |
|------|-------------|---------|----------------------|
| ??낅쑓??꾨뱜 ?袁⑥셽 | ?袁⑷퍥 ?紐꺿봺 ???댘?誘れ삺??밴쉐 | 4??ｍ? StreamingAppend ??Incremental ??**DiffRender** ??FullRender | Virtual DOM diff |
| ???쐭 揶쏄쑨爰?| 1.5~2.2??| 3~4??| ~16ms (requestAnimationFrame) |
| ?遺용꺖 ??沅??| Clear?誘れ삺??밴쉐 | 筌?Ŋ??誘れ삺????+ ??疫꿸퀡而?diff | Recycled/Memoized |
| ?醫딅빍筌롫뗄???| 筌띲끇苡??????(3揶??遺용꺖) | 1???怨몄뒠 ??癰귣똻??| CSS transform (GPU) |

---

### 12-3. Virtual DOM Diff ???쐭 (`TryApplyDiffRender`)

React??reconciliation????덉뵬???癒?봺??WPF???怨몄뒠????疫꿸퀡而?diff ???쐭??낅빍??

**???쐭 筌ｋ똻??(?怨쀪퐨??뽰맄 ??:**
```
StreamingAppend ??Incremental(prefix-match) ??DiffRender(key-based) ??FullRender
```

| ??ｍ?| 鈺곌퀗援?| ??덉삂 |
|------|------|------|
| StreamingAppend | ??쎈뱜?귐됱빪 餓?+ 疫꿸퀣??stable ??? ?봔?브쑴彛??| ????살춸 append |
| Incremental | prefix揶쎛 ?袁⑹읈 ??깊뒄 | ?쀑됤봺 ?봔?브쑬彛??곕떽? |
| **DiffRender** | hiddenCount ??덉뵬 + ??筌욌쵑鍮 癰궰????됱벉 | old?癒?춸 ??덈뮉 ????????뀀꼥?? + new?癒?춸 ??덈뮉 ???곕떽? |
| FullRender | ??3揶?筌뤴뫀紐???쎈솭 | ?袁⑷퍥 Clear?誘れ삺??밴쉐 |

**???뼎 ???х뵳?弛?**
1. `oldKeys` ??index ?類ㅻ??댿봺 / `newKeys` ??HashSet ?닌딇뀧
2. ??깆뵠???뚢뫂???瑗??袁⑸뻻 ?브쑬??
3. `oldKeys` ??쇰퓠???????쀬돳??렽?`newKeySet`????용뮉 ??????볤탢 (?紐껊쑔????됱젟??
4. `renderPlan.VisibleTimeline`?癒?퐣 `oldKeyIndex`????용뮉 ???됵쭕?`Render()`
5. ??깆뵠???뚢뫂???瑗???沅??
**???뵬:** `ChatWindow.TranscriptRenderExecution.cs`, `ChatWindow.TranscriptRendering.cs` (筌ｋ똻????뚯뿯)

---

### 12-4. LSP ?꾨뗀諭??紐낅쏁뵳?????袁㏓럡 ?類ㅼ삢

`lsp_code_intel` ?袁㏓럡??6揶???る?癒?퐣 9揶쏆뮆以??類ㅼ삢??뤿연 ?닌듼???꾨뗀諭??癒?퉳??????揶쏅벤???됰뮸??덈뼄.

| ??る?| ??몃즲 | ?醫됲뇣 |
|------|------|------|
| `goto_definition` | ?????類ㅼ벥 ?袁⑺뒄 | |
| `find_references` | ?????????袁⑺뒄 | |
| `hover` | ?????얜챷苑??類ｋ궖 | ??|
| `goto_implementation` | ?紐낃숲??륁뵠???곕뗄湲??닌뗭겱 ?袁⑺뒄 | ??|
| `symbols` | ???뵬 ??????筌뤴뫖以?| |
| `workspace_symbols` | ??곌쾿??쎈읂??곷뮞 ?袁⑷퍥 ????野꺜??| ??|
| `prepare_call_hierarchy` | ?紐꾪뀱 ?④쑴留?疫꿸퀣? ????| ??|
| `incoming_calls` | ?怨몄맄 ?紐꾪뀱??| ??|
| `outgoing_calls` | ??륁맄 ?紐꾪뀱 ????| ??|

**雅뚯눘??癰궰野?**
- `line`/`character` ??낆젾: 1-based 疫꿸퀡? ??????癒?퐣 0-based ?癒?짗 癰궰??(`NormalizePosition`)
- `query` ???뵬沃섎챸苑??곕떽? (workspace_symbols??
- 野껉퀗??????뵬 ?? ?????袁⑺뒄, 筌?野껉퀗???遺용튋 ??釉?
- LSP ?袁⑥쨮?醫롰맫: `textDocument/implementation`, `textDocument/hover`, `workspace/symbol`, `textDocument/prepareCallHierarchy`, `callHierarchy/incomingCalls`, `callHierarchy/outgoingCalls`

**???뵬:** `LspTool.cs`, `LspClientService.cs`

---

### 12-5. IBM/Qwen ?袁㏓럡 ??????꿸퉪??
IBM watsonx + Qwen 獄쏄퀬猷?類ㅻ퓠??`tool_calls`/`role=tool` ????野꺜??? ?袁㏐봄???얜챷?ｇ몴???욧퍙??몃빍??

**癰궰野???**
```
assistant { tool_calls: [...] }  ?? tool { tool_call_id, content }
```

**癰궰野???(??꿸퉪 transcript):**
```
assistant: "??용뮞??n<tool_call>\n{name,arguments}\n</tool_call>"
user: "[Tool Result: tool_name] (id=xxx)\ncontent"
```

**???뼎 筌롫뗄苑??**
- `BuildIbmAssistantTranscript()` ??tool_use ?됰뗀以???`<tool_call>` ??볥젃 筌욊낮???- `BuildIbmToolResultTranscript()` ??tool_result ??`[Tool Result]` ??삳쐭 + ??곸뒠
- `TryExtractTextContent()` ??string/array/nested ?類κ묶 筌뤴뫀紐???용뮞???곕뗄??
- `TryParseContentArrayToolBlock()` ??content 獄쏄퀣肉???tool_use/tool_call ?됰뗀以????뼓

**???뵬:** `LlmService.ToolUse.cs`

---

### 12-6. ?袁㏓럡 ?紐꾪뀱 ??뽮퐣 ?類ｌ졊 獄??袁⑨세?袁る뱜 ?袁れ넅

**?袁㏓럡 ??뽮퐣 (`ToolRegistry.OrderToolsForExposure`):**

| 甕곌쑵沅?| ?袁㏓럡 |
|------|------|
| 0 (筌ㅼ뮇??? | file_read, file_edit, glob, grep, lsp_code_intel, build_run, document_plan, ??밴쉐 ?袁㏓럡 ??|
| 1 | document_review, format_convert, tool_search, code_search |
| 2 | mcp_*, spawn_agent, wait_agents |
| 3 | task_* |

**?袁⑨세?袁る뱜 ?袁れ넅 (SystemPromptBuilder):**
- "Tools First, Always" ??"Tools First When Needed"
- `tool_search`: ?袁⑤궖?癒?퐣 獄쏅뗀以??醫뤾문 揶쎛?館釉?쭖?筌욊낯???紐꾪뀱, 筌뤴뫂??????춸 ????
- `spawn_agent`: 癰귣쵎??鈺곌퀣沅쀥첎? ??쇱젫嚥??袁????????춸 ????
- `document_review`: ???얜챷苑?筌뤿굞????遺욧퍕 ??뽯퓠筌?亦낅슣??
- Code ?癒?퉳: ?類ㅼ벥/筌〓챷???닌뗭겱/?紐꾪뀱?온????`lsp_code_intel` ?怨쀪퐨

**???뵬:** `ToolRegistry.cs`, `ChatWindow.SystemPromptBuilder.cs`, `AgentLoopService.cs`, `TaskTypePolicy.cs`, `AgentLoopExplorationPolicy.cs`

---

## 13. ?遺얠젂?醫듼봺癰?揶쎛??諭?

| ?遺얠젂?醫듼봺 | ??륁젟 ??雅뚯눘???鍮?|
|---------|----------------|
| `Core/` | `FuzzyEngine` ?癒?땾 ?⑤벊??癰궰野???野꺜????됱춳??筌욊낯???怨밸샨 |
| `Handlers/` | ???紐껊굶???곕떽? ??`App.xaml.cs`???源낆쨯 ?袁⑹뒄 |
| `Services/Agent/` | ???袁㏓럡 ?곕떽? ??`ToolRegistry`???源낆쨯 + ??쎄텢 ???뵬(`.skill.md`) ?臾믨쉐 + `ToolTabOverrides`????燁삳똾?믤⑥쥓??筌왖??|
| `Themes/` | ?귐딅꺖????癰궰野???筌뤴뫀諭????춳????덉뵬??띿쓺 ?怨몄뒠 ?袁⑹뒄 |
| `Models/AppSettings.cs` | ??욧쉐 ?곕떽? ??`SettingsService` 筌띾뜆?졿뉩紐껋쟿??곷??⑥쥓??|
| `Views/ChatWindow.*` | partial class ?브쑵釉????온??疫꿸퀡??? ???????뵬?癒?퐣 ??륁젟 |

---

### 12-7. PPT ?⑥쥚萸뱄쭪???쀫탣????뽯뮞??
`template` ???뵬沃섎챸苑ｆ에?8揶??⑥쥚萸뱄쭪??臾믩뻼????깃맒/??됱뵠?袁⑹뜍???????????됰뮸??덈뼄.

**?袁⑹삺 ?닌뗭겱 (獄쎻뫖苡?1 ????곸삢 筌롫???怨쀬뵠??:**
- 揶???쀫탣?깆슦?????춳 ??깃맒??`FullThemes` ?類ㅻ??댿봺????롫굡?꾨뗀逾?(0KB ?곕떽?)
- ?癒?궚 .pptx ??곸뵠????덉뵬 ??깃맒+??됱뵠?袁⑹뜍??곗쨮 PPT ??밴쉐 揶쎛??- ?癒?궚 .pptx揶쎛 `Assets/ppt/` ?癒?뮉 `%APPDATA%/AXCopilot/templates/ppt/`????됱몵筌?筌띾뜆???癰귣벊???⑥쥚萸뱄쭪? ?癒?짗 ??껊젃??됱뵠??
| ??쀫탣????已?| ?癒?궚 ???뵬 | ??깃맒 ?諭彛?|
|------------|----------|----------|
| `basic100` | BASIC100 疫꿸퀣? ??쀫탣??V1.pptx (67MB) | 筌뤴뫀???됰뗀竊?(#2572EF) |
| `core100` | CORE100 疫꿸퀣???쀫탣??V1.pptx (141MB) | ???됰뗀竊?(#266DF1) |
| `frame_blue` | ?袁⑥쟿?袁⑤탵?癒?뵥 ?됰뗀竊?(19MB) | ?袁⑥쟿???됰뗀竊?(#126BF6) + 燁삳?諭?|
| `mr_ppt_01` | 沃섎챷?????노돗??01 (18MB) | ??쎄쾿 ??쇱뵠??+ ?됰뗀竊?(#0049F0) |
| `mr_ppt_02` | 沃섎챷?????노돗??02 (24MB) | ?됰뗀竊?+ 域밸챶???燁삳?諭?(#2269F7) |
| `mr_ppt_03` | 沃섎챷?????노돗??03 (5.5MB) | ??쇱뵠??+ ?ⓥ뫀諭?(#F4BB05) |
| `mr_ppt_04` | 沃섎챷?????노돗??04 (8.8MB) | ???紐껊탵??+ ??쇰춦???앯뙴?(#0583F2) |
| `mr_ppt_05` | 沃섎챷?????노돗??05 (16MB) | 筌뤴뫀???됰뗀??+ ?됰뗀竊?(#007AF9) |

**?館???닌뗭겱 ????**

#### 獄쎻뫖苡?2 ???癒?짗 ??쇱뒲嚥≪뮆諭?(亦낅슣??
```
筌?????????沅?NAS/??뺤쒔?癒?퐣 ??쀫탣???癒?짗 ??쇱뒲嚥≪뮆諭???%APPDATA%/AXCopilot/templates/ppt/ 筌?Ŋ??

?닌뗭겱 ?????
- AppSettings??TemplateServerUrl ??쇱젟 ?곕떽? (?? https://nas.internal/ax-templates/)
- ResolveTemplatePath?癒?퐣 ???뵬 沃섎챶而삣칰?????쇱뒲嚥≪뮆諭??紐꺿봺椰?- ??쇱뒲嚥≪뮆諭?筌욊쑵六양몴?UI (ChatWindow ?癒?뮉 ??쇱젟 ?遺얇늺)
- ??쎈늄??깆뵥 ??媛? ??곸삢 筌롫???怨쀬뵠??獄쎻뫖苡?1)嚥??癒?짗 ?袁れ넎
- 甕곌쑴???온?? ??뺤쒔??manifest.json ??嚥≪뮇類?筌?Ŋ??甕곌쑴?얏???쑨??

??됯맒 ?臾믩씜?? 餓?(??쇱뒲嚥≪뮆諭???뺥돩??+ UI + ??쇱젟)
???뵬: PptxSkill.cs, AppSettings.cs, SettingsService.cs
```

#### 獄쎻뫖苡?3 ????슢諭????釉?
```
csproj??Content嚥??源낆쨯??뤿연 獄쏄퀬猷????텕筌왖????釉?

?닌뗭겱:
1. AxCopilot.csproj???袁⑥삋 ?곕떽?:
   <Content Include="Assets\ppt\*.pptx">
     <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
   </Content>

2. ??쇳뒄???뵬 ??몄쎗 ?怨밸샨: +~200MB (?類ㅽ뀧 ??
   - ?袁⑹삺 ??쇳뒄???뵬 ~107MB ??~307MB ??됯맒

3. ?醫뤾문????釉?(??몄쎗 ??됰븧):
   - 野껋럥????쀫탣?깆슜彛???釉?(mr_ppt_03: 5.5MB, mr_ppt_04: 8.8MB ??
   - ??????쀫탣??(core100: 141MB)?? 獄쎻뫖苡?2嚥???쇱뒲嚥≪뮆諭?

   <Content Include="Assets\ppt\沃섎챷???" Condition="Exists('Assets\ppt\')">
     <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
   </Content>

雅뚯눘?? build.bat??payload.zip ?類ㅽ뀧 ??ｍ?癒?퐣 ?癒?짗 ??釉??```

---

## 14. 筌왖?館???癒?뵠?袁る뱜 ?⑥쥓猷??(oh-my-openagent 筌〓챷??

> ?怨멸쉭 ?④쑵?? `docs/AGENT_ROADMAP.md` 8??筌〓챷??

### 筌앸맩??揶쏆뮆而?(P1~P5)

| ??뽰맄 | 疫꿸퀡??| ???뼎 ???뵬 | ??살구 |
|------|------|----------|------|
| P1 | **IntentGate** (??롫즲 ?브쑬履잍묾? | `IntentGateService.cs`(?醫됲뇣) | ???????낆젾 ???臾믩씜 ?醫륁굨 ?癒?짗 ?브쑬履???筌ㅼ뮇????쎈뻬 ?袁⑥쨮???뵬(temperature/tool 亦낅슦釉?獄쏆꼶???怨밸립) ?癒?짗 ?怨몄뒠. 疫꿸퀣??`ClassifyTaskType` + `IntentDetector` ???? ?類ㅼ삢 |
| P2 | **燁삳똾?믤⑥쥓????뺥닏?癒?뵠?袁る뱜 ?袁⑥쨮???뵬** | `SubAgentProfile.cs`(?醫됲뇣), `SubAgentTool.cs` | ??μ뵬 筌뤴뫀??+ ??삘뀲 system prompt/tool 亦낅슦釉?temperature 鈺곌퀬鍮??곗쨮 揶쎛??筌렺?怨쀫퓠??곸읈?? researcher/coder/writer/reviewer/planner 5揶??袁⑥쨮???뵬 |
| P3 | **?袁⑹읅 ??덈뮸** | `SessionLearningCollector.cs`(?醫됲뇣) | ?紐꾨???獄쏆뮄猿??鍮???슢諭??癒?쑎, ???뵬 ?닌듼? ???쉘)???癒?짗 ??륁춿??뤿연 ?袁⑸꺗 獄쏆꼶????뚢뫂???쎈뱜嚥?雅뚯눘?? 獄쏆꼶????쇰땾 獄쎻뫗? |
| P4 | **??곌쾿??쎈읂??곷뮞 ?뚢뫂???쎈뱜 ?癒?짗 ??밴쉐** | `WorkspaceContextGenerator.cs`(?醫됲뇣) | ?臾믩씜 ?????닌듼?疫꿸퀣???쎄문??`.ax-context.md`嚥??癒?짗 ??밴쉐. ??뺥닏?癒?뵠?袁る뱜 ?뚢뫂???쎈뱜 ??μ몛??|
| P5 | **癰귣쵎????뺥닏?癒?뵠?袁る뱜 ?類ㅼ삢** | `SpawnAgentsTool.cs`(?醫됲뇣) | ??????뺥닏?癒?뵠?袁る뱜????甕곕뜆肉???밴쉐/??쎈뻬. IntentGate ?怨뺣짗??곗쨮 癰귣벏鍮 ?遺욧퍕 ?癒?짗 ?브쑵鍮?|

### ?곕???揶쏆뮆而?(P6~P7)

| ??뽰맄 | 疫꿸퀡??| ?醫뤿뻬 鈺곌퀗援?| ??살구 |
|------|------|----------|------|
| P6 | **??媛?筌ｋ똻??* | P1 + P2 | ??쎈뻬 ??쎈솭 ????삘뀲 ?袁⑥쨮???뵬/?袁⑥셽??곗쨮 ?癒?짗 ?????(筌ㅼ뮆? 2?? |
| P7 | **筌뤴뫀???源껉봄 筌띲끉臾?* | P1 + 筌렺?怨뺛걟??| ?臾믩씜 ?醫륁굨癰?筌ㅼ뮇??筌뤴뫀???癒?짗 ?醫뤾문 (RegisteredModel.strengths 筌띲끉臾? |

### ?닌뗭겱 ??뤵??온??
```
P1 (IntentGate) ?????????????????P2 (燁삳똾?믤⑥쥓???袁⑥쨮???뵬) ??????P5 (癰귣쵎???類ㅼ삢)
                      ???????P3 (?袁⑹읅 ??덈뮸) [??끸뵲]
                      ?遺?????P4 (??곌쾿??쎈읂??곷뮞 ?뚢뫂???쎈뱜) [??끸뵲]
P1 + P2 ?袁⑥┷ ????????P6 (??媛?筌ｋ똻??
P1 + 筌렺?怨뺛걟??????????P7 (筌뤴뫀???源껉봄 筌띲끉臾?
```

---

## 15. 癰귣벊??筌ｋ똾寃?????
UI ?遺우쁽????域뱀뮆???귐뗫솯?醫딆춦 ???袁る퓮 ?臾믩씜 ??疫꿸퀡以????됱읈 癰귣벊??筌왖?癒?뿯??덈뼄.

| ?醫롮? | ?뚣끇而???곷뻻 | ??살구 | 癰귣벊??筌뤿굝議?|
|------|-----------|------|-----------|
| 2026-04-13 | `4d1d160` | UI ?遺우쁽??揶쏆뮇苑?筌욊낯???????춳 ?대Ŋ?? IBM 筌욊쑬??嚥≪뮄?? ?됯퀣堉?筌뤿굞臾?癰궰野??袁⑥┷ (704 tests pass) | `git checkout 4d1d160 -- src/AxCopilot/` |

> **?袁⑷퍥 嚥▲끇媛?*: `git revert <?뚣끇而?` ?癒?뮉 `git reset --hard 4d1d160` (雅뚯눘?? ??꾩뜎 ?臾믩씜 筌뤴뫀紐????뼄)
> **?봔??癰귣벊??*: `git checkout 4d1d160 -- <???뵬野껋럥以?` 嚥??諭?????뵬筌???롫즼?귐덈┛

---

## 16. ?온???얜챷苑?

| ?얜챷苑?| ??곸뒠 |
|------|------|
| `docs/AGENT_ROADMAP.md` | ?癒?뵠?袁る뱜 疫꿸퀡??嚥≪뮆諭띰쭕?(筌왖?館???⑥쥓猷??P1~P7 ?怨멸쉭 ??釉? |
| `docs/LAUNCHER_ROADMAP.md` | ?怨쀬퓗 疫꿸퀡??嚥≪뮆諭띰쭕?|
| `docs/AX_AGENT_QUALITY_PLAN.md` | AX Agent ?덉쭏 寃뚯씠??怨꾪쉷 |
| `docs/TOOL_COVERAGE_REPORT.md` | ?袁㏓럡 ?紐낆넎???귐뗫７??|
| `docs/AX_AGENT_UI_CHECKLIST.md` | ?癒?뵠?袁る뱜 UI 筌ｋ똾寃뺟뵳????|
| `docs/UI_UX_CHECKLIST.md` | UI/UX 筌ｋ똾寃뺟뵳????|
> ??낅쑓??꾨뱜: 2026-04-14 18:08 (KST)
> - ??쎄텢 ??뽯뮞??Phase 2 1~6甕곕뜆??獄쏆꼷???됰뮸??덈뼄. `SkillService`???袁⑥쨮??븍뱜 `.claude/skills` ??? 嚥≪뮆諭? namespaced `SKILL.md`, 甕곕뜄諭???쎄텢 雅뚯눘?? `$ARGUMENTS`/named args/??쎄텢 ????癰궰??燁살꼹?? inline shell block ??쎈뻬繹먮슣? 筌왖?癒곕릭?袁⑥쨯 ?類ㅼ삢??됰뮸??덈뼄.
> - `ChatWindow` ?怨???野껋럥以????ｍ뜞 ?類ｂ봺??됰뮸??덈뼄. ??????紐꾪뀱?? `BuildSlashInvocationAsync`?????퉸 ?뚮똾???곕쭆 ??쎄텢 ?袁⑨세?袁る뱜???????랁? ??곗뺘 ???遺얜뮉 `when_to_use`/`paths`/`user-invocable` 筌롫???怨쀬뵠?怨? 獄쏅?源??곗쨮 ?醫뤾문???癒?짗 ??쎄텢 揶쎛??諭띄몴?癰귣똻????뽯뮞???袁⑨세?袁る뱜嚥??븐늿???덈뼄.
> - ??쇱젟/UI ?怨뚭퍙??????쎄텢 筌뤴뫀??疫꿸퀣???곗쨮 筌띿쉸???щ빍?? Agent ??쇱젟, ??곗뺘 ??쇱젟, ??살쒔??됱뵠, ??쎄텢 ?온?귐딆쁽 ?袁㏓럡??甕곕뜄諭??袁⑥쨮??븍뱜/???????쎄텢 ?브쑬履?? ?袁⑥쨮??븍뱜 `.claude/skills` 野껋럥以덄몴?獄쏆꼷?????살구???귐딅뮞?紐? ?닌딄쉐??몃빍??
> - ?袁㏓럡 ?紐꾪뀱 ??ｍ??`AgentLoopService.GetRuntimeActiveTools()`?癒?퐣 blanket deny 亦낅슦釉???믪눘? ?怨몄뒠??롫즲嚥?癰귣떯而??됰뮸??덈뼄. ???쉘 疫꿸퀡而?域뱀뮇??? call-time 野꺜??? ?醫???랁? ??λ떄 deny ?袁㏓럡??筌뤴뫀???紐꾪뀱 ???袁り숲筌띻낯?앮에??類ｂ봺??됰뮸??덈뼄.
> - 野꺜筌? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_phase2\\ -p:IntermediateOutputPath=obj\\verify_phase2\\` 野껋럡??0 / ??살첒 0
> - 野꺜筌? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentToolCatalogTests|SkillServiceRuntimePolicyTests" -p:OutputPath=bin\\verify_phase2_tests\\ -p:IntermediateOutputPath=obj\\verify_phase2_tests\\` ???궢 16
> - 筌〓㈇?? ???뮞???袁⑥쨮??븍뱜??疫꿸퀣??nullable 野껋럡??`src/AxCopilot.Tests/Services/WorkspaceContextGeneratorTests.cs(76)` 1椰꾨똻? ?醫???몃빍??
> ??낅쑓??꾨뱜: 2026-04-14 18:22 (KST)
> - ??쎄텢 ???뮞 ?類ㅼ삢 Phase 3??獄쏆꼷???됰뮸??덈뼄. `SkillService`???怨몄맄 ?遺얠젂?怨뺚봺繹먮슣? ??釉???袁⑥쨮??븍뱜 `.claude/skills` ?癒?퉳, ???쑎域밸챷????쎄텢 ?????癒?퉳, ?곕떽? ?⑤벊??????筌뤴뫖以? `.claude/commands` markdown command??legacy skill嚥?癰궰??묐릭??野껋럥以덄몴???ｍ뜞 筌왖?癒곕???덈뼄.
> - ???뵬????쎄텢?? body??筌앸맩??筌롫뗀?덄뵳?肉????곻쭪? ??꾪??袁⑹뒄 ??뽰젎?癒?춸 ??덈뮉 lazy prompt body 筌?Ŋ?녺몴??곕떽???됰뮸??덈뼄. `SkillManagerTool`, `SkillEditorWindow`, `SkillGalleryWindow`????野껋럥以덄몴????퉸 ??쇱젫 癰귣챶揆????뽯뻻??몃빍??
> - ?紐꾩쁽 筌뤴뫀????類ㅼ삢??됰뮸??덈뼄. `arguments`?? `argument-hint`????ｍ뜞 ??곴퐤??named placeholder 燁살꼹???揶쏅벤???뉙? ?紐꾩쁽揶쎛 ?봔鈺곌퉲釉?쭖?usage 揶쎛??諭띄몴??袁⑨세?袁る뱜 ??롫퓠 ?븐늿肉???쎈뻬 ??됱춳??癰귣똻???몃빍??
> - ?袁㏓럡 deny ?袁り숲??`AgentToolCatalog` ?⑤벏??筌롫뗄苑??뺤쨮 ??猷???怨??袁㏓궢 ??쇱젟 UI揶쎛 揶쏆늿? blanket deny 域뱀뮇????⑤벊???롫즲嚥??類ｂ봺??됰뮸??덈뼄.
> - ??쇱젟 ???關肉??`additionalSkillFolders`???곕떽???뉙? ??곗뺘 ??쇱젟/AX Agent ??쇱젟 UI??餓???μ맄 ??낆젾 ?袁⑤굡???節뚮선 ?????⑤벊????쎄텢 ???묊몴??怨뚭퍙??????뉗쓺 ??됰뮸??덈뼄.
> - 野꺜筌? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_phase3\\ -p:IntermediateOutputPath=obj\\verify_phase3\\` 野껋럡??0 / ??살첒 0
> - 野꺜筌? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentToolCatalogTests|SkillServiceRuntimePolicyTests" -p:OutputPath=bin\\verify_phase3_tests\\ -p:IntermediateOutputPath=obj\\verify_phase3_tests\\` ???궢 18
> - 筌〓㈇?? ???뮞???袁⑥쨮??븍뱜??疫꿸퀣??nullable 野껋럡??`src/AxCopilot.Tests/Services/WorkspaceContextGeneratorTests.cs(76)` 1椰꾨똻? ?醫???몃빍??
> ??낅쑓??꾨뱜: 2026-04-14 18:33 (KST)
> - ??쎄텢 ?類ㅼ퐠 ??뽯선???곕떽???됰뮸??덈뼄. `LlmSettings`??`enableProjectSkillDiscovery`, `enablePluginSkillDiscovery`, `enableLegacyCommandSkills`, `enableSkillInlineShell`, `skillInlineShellTimeoutSeconds`, `skillInlineShellMaxOutputChars`???곕떽???랁???곗뺘 ??쇱젟/AX Agent ??쇱젟 UI???怨뚭퍙??됰뮸??덈뼄.
> - ??쎄텢 嚥≪뮆諭???볥젃??됱퓗????곸젫 ???뮞 ?遺얠젂?怨뺚봺 筌뤴뫖以됭굢??袁⑤빍????쇱젫 ??쎄텢 ???뵬 ??? 筌ㅼ뮄????륁젟 ??볦퍟????ｍ뜞 獄쏆꼷???몃빍?? 揶쏆늿? ?????닌딄쉐????????뵬 ??곸뒠??獄쏅뗀???늺 ??쇱벉 嚥≪뮆諭??遺욧퍕?癒?퐣 ??源??곕쭢??덈뼄.
> - inline shell ??쎈뻬疫꿸퀡????쇱젟 疫꿸퀡而???쑵??源딆넅, timeout, ?곗뮆??疫뀀챷????쀫립???怨몄뒠??롫즲嚥?癰귣떯而??됰뮸??덈뼄. ??쑵????怨밴묶????볦퍢 ?λ뜃????袁⑨세?袁る뱜 ??됰퓠????명?揶쎛?館釉???덇땀 ?얜챷???以?獄쏆꼹???몃빍??
> - `SkillEditorWindow`?? `SkillGalleryWindow`??lazy prompt body 野껋럥以덄몴??????롫즲嚥?筌띿쉸?ф? ??쇱젟 癰궰野???`ReloadFromCurrentSettings()`?????퉸 ?袁⑹삺 ??쎄텢 ???뮞????쇰뻻 ??덈즲嚥??類ｂ봺??됰뮸??덈뼄.
> - 野꺜筌? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_phase4b\\ -p:IntermediateOutputPath=obj\\verify_phase4b\\` 野껋럡??0 / ??살첒 0
> - 野꺜筌? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentToolCatalogTests|SkillServiceRuntimePolicyTests" -p:OutputPath=bin\\verify_phase4b_tests\\ -p:IntermediateOutputPath=obj\\verify_phase4b_tests\\` ???궢 18
> - 筌〓㈇?? ???뮞???袁⑥쨮??븍뱜??疫꿸퀣??nullable 野껋럡??`src/AxCopilot.Tests/Services/WorkspaceContextGeneratorTests.cs(76)` 1椰꾨똻? ?醫???몃빍??

- ??낅쑓??꾨뱜: 2026-04-14 18:37 (KST)
- 湲곗? 援ъ“ 嚥≪뮇類???산퉬?猷뱀뱽 ??쇰뻻 ?類ㅼ뵥???筌? ?袁⑹삺 ??산퉬?猷밸퓠??PPT/?얜챷苑??袁⑹뒠 甕곕뜄諭???쎄텢????뺤죫??? ??녿릭??щ빍?? ????AX揶쎛 疫꿸퀡????釉??랁???덈뮉 ?얜챷苑??managed skill ?紐낅뱜??餓λ쵐???곗쨮 獄쏄퀬猷??癒?텦 ??됱춳????삳쾳??됰뮸??덈뼄.
- pptx-creator, docx-creator, report-writer, prd-generator, meeting-minutes, weekly-report, markdown-to-doc??when_to_use?? argument-hint 筌롫?????곕떽???proactive skill ?醫뤾문????????紐꾪뀱 揶쎛??諭띄몴?癰귣떯而??됰뮸??덈뼄.
- ??곗뺘 ??쇱젟??AX Agent ??쇱젟????쎄텢 筌뤴뫖以?? managed ??쇳맜?袁? 癰귢쑬猷?疫꿸퀡????볥궗 ??쎄텢 域밸챶竊??곗쨮 ?브쑬???뉙? ??쎄텢 揶쎼끇??뵳?猷?疫꿸퀡????볥궗 / ?袁⑥쨮??븍뱜 / ???쑎域밸챷??/ ?????/ ?⑥쥒???袁り숲?? 獄쏄퀣????????롫즲嚥??類ｂ봺??됰뮸??덈뼄.
- ??癰궰野껋럩?앮에??얜챷苑뚯쮯?袁⑥쟿?醫뤿??곷???쎄텢?? ??슢諭??곗뮆??skills ???묊몴????퉸 疫꿸퀡??獄쏄퀬猷??롢늺??뺣즲, UI?癒?퐣 ???????쎄텢???닌됲뀋???怨밴묶嚥??類ㅼ뵥??????됰뮸??덈뼄.
- 野꺜筌? dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_docskills\\ -p:IntermediateOutputPath=obj\\verify_docskills\\ 野껋럡??0 / ??살첒 0

- ??낅쑓??꾨뱜: 2026-04-14 18:45 (KST)
- AX Agent ??? ??쇱젟????쎄텢 ????덇땀 ?됰뗀以???뚣끉??? ??곌볼???곕떽???됰뮸??덈뼄. ??곸젫 .claude/skills/.../SKILL.md ?袁⑥쨮??븍뱜 ?紐낆넎 野껋럥以덂첎? ??쎄텢 ??筌??遺얇늺?癒?퐣 獄쏅뗀以?癰귣똻肉? ??곌쾿??쎈읂??곷뮞??揶쏆늿? ?닌듼쒎첎? ??됱몵筌?AX揶쎛 ??ｍ뜞 ??덈뮉??삳뮉 ?癒?뱽 UI?癒?퐣???類ㅼ뵥??????됰뮸??덈뼄.
- 野꺜筌? dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_skilllabel\\ -p:IntermediateOutputPath=obj\\verify_skilllabel\\ 野껋럡??0 / ??살첒 0

- ??낅쑓??꾨뱜: 2026-04-14 19:02 (KST)
- ?꾨뗄????꾨뗀諭???臾믩씜 ?????醫뤾문 ??UI揶쎛 2~3??筌롫뜆????癒?カ???癒??? ????癰궰野?筌욊낱????쎈뻬??롫쐲 ??쎄텢 ???뮞 ??源??깆뱽 UI ??살쟿??獄쏅쉼?앮에??브쑬???됰뮸??덈뼄. ??곸젫 ?臾믩씜 ????癰궰野? ???袁れ넎, ????癰귣벊?????袁⑹뒄????쎄텢 ??以??뺣뮉 獄쏄퉫???깆뒲??뽯퓠????묐뻬??랁? 鈺곌퀗援붼겫? ??쎄텢 ??뽮쉐?遺얠춸 UI????쇰뻻 獄쏆꼷???몃빍??
- 筌ｂ뫀? ???뵬 ?곕떽?/??볤탢筌ｌ꼶???臾믩씜 ???묈첎? 獄쏅뗀??? ??낅뮉 野껋럥以??疫꿸퀣????쎄텢 筌욌쵑鍮筌?疫꿸퀣???곗쨮 鈺곌퀗援붼겫? ??쎄텢??揶쏄퉮???롫즲嚥??브쑬????븍뜇釉?酉釉???源??곕즲 餓κ쑴???щ빍??
- 野꺜筌? dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_folderpick\\ -p:IntermediateOutputPath=obj\\verify_folderpick\\ 野껋럡??0 / ??살첒 0

- ??낅쑓??꾨뱜: 2026-04-14 19:16 (KST)
- ?브쑴苑??嚥≪뮄??????獄쎻뫗???嚥▲끇彛??類κ묶嚥??類ｂ봺??됰뮸??덈뼄. app, perf, audit, workflow 嚥≪뮄????醫롮?癰????뵬???醫???롫┷ 揶????뵬??筌ㅼ뮆? 1MB????? ??낅즲嚥???살삋????곸뒠?봔??獄쎛??沅∽쭖???嚥≪뮄?뉒몴???곷선 ?븐늿???덈뼄.
- ?⑤벏???醫뤿뼢 RollingTextLogStore???곕떽???랁?LogService, AgentPerformanceLogService, AuditLogService, WorkflowLogService????ｍ뜞 ?怨몄뒠??됰뮸??덈뼄.
- ?⑤벏??嚥≪뮄???源낅뮟 嚥≪뮄??揶쏅Ŋ沅?嚥≪뮄???14??⑦돱筌왖筌??醫???랁? ??곌쾿???쨮???怨멸쉭 嚥≪뮄???疫꿸퀣????쇱젟揶쏅????怨뺚뀮??筌ㅼ뮆? 14??깆뱽 ??? ??낅즲嚥?App ??뽰삂 ???怨밸립???怨몄뒠??됰뮸??덈뼄.
- RollingTextLogStoreTests 3椰꾨똻???곕떽??????뵬 ??由??怨밸립 ?醫?, ??살삋?????뵬 ???? ?醫롮? ?遺얠젂?怨뺚봺 ??????덉삂??野꺜筌앹빜六??щ빍??
- 野꺜筌? dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_logroll\\ -p:IntermediateOutputPath=obj\\verify_logroll\\ 野껋럡??0 / ??살첒 0
- 野꺜筌? dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter RollingTextLogStoreTests -p:OutputPath=bin\\verify_logroll_tests\\ -p:IntermediateOutputPath=obj\\verify_logroll_tests\\ ???궢 3
- 筌〓㈇?? ???뮞???袁⑥쨮??븍뱜??疫꿸퀣??nullable 野껋럡??src/AxCopilot.Tests/Services/WorkspaceContextGeneratorTests.cs(76) 1椰꾨똻? ?醫???몃빍??
?낅뜲?댄듃: 2026-04-14 21:00 (KST)
- Word/Excel/HTML 臾몄꽌 ?앹꽦 怨좊룄??1李⑤? 諛섏쁺?덉뒿?덈떎. `DocumentPlannerTool`? ?쒖븞??蹂닿퀬??遺꾩꽍 臾몄꽌瑜?`Executive Summary`, `Business Case`, `Decision Ask`, `Appendix`源뚯? ?ы븿???낅Т???꾩썐?쇱씤?쇰줈 ?뺤옣?⑸땲??
- `DocumentAssemblerTool`? DOCX 議곕┰ ??HTML/Markdown 援ъ“瑜???蹂댁〈?섎룄濡??먮뇬?듬땲?? ?? 紐⑸줉, 肄쒖븘?? ?뚯젣紐⑹쓣 ?됰Ц?쇰줈留?諛?대쾭由ъ? ?딄퀬 Word 釉붾줉?쇰줈 ?ㅼ떆 議곕┰?⑸땲??
- `ExcelSkill`??`summary_sheet`瑜?異붽???KPI/?듭떖 ?몄궗?댄듃/?꾩냽 怨쇱젣瑜??댁? ?붿빟 ?쒗듃瑜??곸꽭 ?곗씠???쒗듃 ?욎뿉 ?④퍡 ?앹꽦?????덇쾶 ?덉뒿?덈떎.
- `HtmlSkill`? `comparison`, `roadmap`, `matrix` 援ъ“???뱀뀡??吏?먰븯怨? ?⑥닔 ?ㅽ궎留덉쓽 `body` ?꾩닔 議곌굔???꾪솕??`sections` 以묒떖 ?몄텧???먯뿰?ㅻ읇寃?諛쏅룄濡??뺣━?덉뒿?덈떎.
- `docx-creator.skill.md`, `csv-to-xlsx.skill.md`, `markdown-to-doc.skill.md`, `report-writer.skill.md`??Python ?고쉶 寃쎈줈蹂대떎 AX ?ㅼ씠?곕툕 臾몄꽌 ?꾧뎄瑜??곗꽑 ?ъ슜?섎룄濡??ъ옉?깊뻽?듬땲??
- ?뚯뒪?? `DocumentAssemblerSemanticTests`, `ExcelSkillSummarySheetTests`, `HtmlSkillConsultingSectionsTests`, `DocumentPlannerBusinessDocumentTests` 異붽?
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_phase1\\ -p:IntermediateOutputPath=obj\\verify_doc_phase1\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "DocumentAssemblerSemanticTests|ExcelSkillSummarySheetTests|HtmlSkillConsultingSectionsTests|DocumentPlannerBusinessDocumentTests|DocumentPlannerPresentationTests" -p:OutputPath=bin\\verify_doc_phase1_tests\\ -p:IntermediateOutputPath=obj\\verify_doc_phase1_tests\\` ?듦낵 5

?낅뜲?댄듃: 2026-04-14 21:50 (KST)
- PPT ?앹꽦 怨좊룄??3李⑤? 諛섏쁺?덉뒿?덈떎. `DeckPlanningService`瑜?異붽???deck brief ?뺢퇋?? consulting storyline 蹂닿컯, ?꾨씫??`Executive Summary`/`Recommendation`/`Roadmap`/`Appendix` ?먮룞 ?쎌엯, ?덉씠?꾩썐 alias ?뺢퇋?붾? ?대? ?뚯씠?꾨씪?몄쑝濡?泥섎━?⑸땲??
- `DeckQualityReviewService`瑜?異붽???deck-level ?덉쭏 ?먯닔? 寃쎄퀬瑜?怨꾩궛?⑸땲?? ?쒗뵆由??ъ슜 ?щ?, ?덉씠?꾩썐 ?ㅼ뼇?? executive summary/recommendation ?좊Т, ?띿뒪??怨쇰?, 洹쇨굅 ?щ씪?대뱶 遺議? placeholder ?붿〈???④퍡 ?먭??⑸땲??
- `PptxSkill`? `audience`, `objective`, `decision_ask`, `storyline` ?뚮씪誘명꽣瑜?異붽??덇퀬, `issue_tree`, `before_after`, `decision_matrix`, `risk_heatmap`, `benefit_waterfall`, `operating_model`, `appendix_evidence` 媛숈? ?곸쐞 deck ?덉씠?꾩썐???ㅼ씠?곕툕 ?щ씪?대뱶 ??낆쑝濡??먮룞 ?뺢퇋?뷀빐 ?뚮뜑留??꾩뿉 蹂댁젙?⑸땲??
- 寃곌낵 硫붿떆吏??怨좊룄?뷀뻽?듬땲?? `pptx_create` ?ㅽ뻾 ???뚯씪 寃쎈줈留?諛섑솚?섎뜕 ?먮쫫?먯꽌, ?댁젣 planning summary? deck quality summary瑜??④퍡 諛섑솚??紐⑤뜽怨??ъ슜?먭? 寃곌낵臾??꾩꽦?꾨? 諛붾줈 ?뺤씤?????덉뒿?덈떎.
- `pptx-creator.skill.md`瑜?deck planning 以묒떖?쇰줈 ?ъ옉?깊뻽怨? `strategy-deck`, `board-update`, `pmo-steering`, `sales-review-deck`, `operating-model-deck` 踰덈뱾 ?ㅽ궗??異붽???紐⑹쟻??deck ?앹꽦 吏꾩엯?먯쓣 ?섎졇?듬땲??
- ?뚯뒪?몃줈 `DeckPlanningServiceTests`, `DeckQualityReviewServiceTests`, `PptxSkillAutoRepairTests`瑜?異붽??덇퀬, 湲곗〈 `PptxSkillConsultingDeckTests`? ?④퍡 寃利앺뻽?듬땲??
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_ppt_phase3\\ -p:IntermediateOutputPath=obj\\verify_ppt_phase3\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "DeckPlanningServiceTests|DeckQualityReviewServiceTests|PptxSkillAutoRepairTests|PptxSkillConsultingDeckTests" -p:OutputPath=bin\\verify_ppt_phase3_tests\\ -p:IntermediateOutputPath=obj\\verify_ppt_phase3_tests\\` ?듦낵 5

?낅뜲?댄듃: 2026-04-14 22:14 (KST)
- 臾몄꽌 planner/assembler 怨좊룄??2李⑤? 諛섏쁺?덉뒿?덈떎. [DocumentPlannerTool.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DocumentPlannerTool.cs)??`format: xlsx`瑜?吏?먰븯怨? 遺꾩꽍/?쒖븞 ?쒕굹由ъ삤?먯꽌 `summary_sheet + sheets` 援ъ“??`excel_create` scaffold瑜?吏곸젒 ?앹꽦?⑸땲??
- 媛숈? ?뚯씪???щ㎎ ?댁꽍 濡쒖쭅? `xlsx`, `excel`, `workbook`, `tracker`, `dashboard`, `scorecard` 怨꾩뿴 ?섎룄瑜?癒쇱? 媛먯????뚰겕遺?寃쎈줈濡?蹂대궡?꾨줉 蹂닿컯?덉뒿?덈떎.
- [DocumentAssemblerTool.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DocumentAssemblerTool.cs)??DOCX 議곕┰ ??`cover_subtitle`, `toc`, `header`, `footer`瑜??ㅼ젣 OpenXML 臾몄꽌??諛섏쁺?섍퀬, 援ъ“??HTML??Word 釉붾줉?쇰줈 議곕┰?????덉쭏 由щ럭 ?먯닔瑜??④퍡 諛섑솚?⑸땲??
- 媛숈? ?꾧뎄??HTML 議곕┰ 寃쎈줈??怨듯넻 [ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)? ?곌껐??score/strengths/issues 湲곗????붿빟???뚮젮二쇰룄濡??뺣━?덉뒿?덈떎.
- [kpi-workbook.skill.md](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/skills/kpi-workbook.skill.md)??complex workbook ?앹꽦 ??planner 寃쎈줈瑜??닿린 ?꾪빐 `document_plan`???덉슜 ?꾧뎄??異붽??덉뒿?덈떎.
- ?뚯뒪?몃줈 [DocumentPlannerWorkbookScaffoldTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DocumentPlannerWorkbookScaffoldTests.cs), [DocumentAssemblerDocxFeaturesTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DocumentAssemblerDocxFeaturesTests.cs)瑜?異붽??덉뒿?덈떎.
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_planning2\\ -p:IntermediateOutputPath=obj\\verify_doc_planning2\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "DocumentPlannerWorkbookScaffoldTests|DocumentAssemblerDocxFeaturesTests|DocumentAssemblerSemanticTests|DocumentPlannerBusinessDocumentTests|ExcelSkillExecutiveSummaryLinkTests|HtmlSkillConsultingSectionsTests|DocxSkillTemplateFeaturesTests" -p:OutputPath=bin\\verify_doc_planning_tests3\\ -p:IntermediateOutputPath=obj\\verify_doc_planning_tests3\\` ?듦낵 7

?낅뜲?댄듃: 2026-04-14 22:28 (KST)
- 臾몄꽌 ?щ㎎ 怨좊룄??3李⑤? 諛섏쁺?덉뒿?덈떎. [DocumentAssemblerTool.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DocumentAssemblerTool.cs)??DOCX 議곕┰ ??`template_path`? `page_numbers`瑜?吏?먰빐 ?щ궡 ?쒗뵆由?蹂듭젣 ??而ㅻ쾭, 紐⑹감, 癒몃━湲, 諛붾떏湲, ?섏씠吏 踰덊샇瑜??④퍡 ?곸슜?????덇쾶 ?덉뒿?덈떎.
- 媛숈? ?꾧뎄??DOCX 寃쎈줈???쒗뵆由??곸냽 ?щ?瑜?[ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)??援ъ“??臾몄꽌 由щ럭 ?낅젰?쇰줈 ?꾨떖???쒗뵆由?湲곕컲 ?곗텧臾?媛뺤젏源뚯? ?덉쭏 ?붿빟??諛섏쁺?⑸땲??
- [ExcelSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ExcelSkill.cs)??`data_validations`瑜?吏?먰븯?꾨줉 ?뺤옣?덉뒿?덈떎. ?⑥씪 ?쒗듃, summary sheet ?ы븿 ?뚰겕遺? 硫???쒗듃 ?뚰겕遺?紐⑤몢?먯꽌 OpenXML `DataValidation` 洹쒖튃???앹꽦?섍퀬 ?뚰겕遺??덉쭏 由щ럭??寃利?洹쒖튃 ?섎? ?ы븿?⑸땲??
- [HtmlSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/HtmlSkill.cs)??`decision_summary`, `evidence_cards` ?뱀뀡??吏?먰빐 寃쎌쁺 蹂닿퀬??HTML?먯꽌 ?섏궗寃곗젙 ?붿빟怨?洹쇨굅 移대뱶 臾띠쓬??援ъ“??釉붾줉?쇰줈 ?뚮뜑留곹빀?덈떎.
- [ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)??HTML 由щ럭????釉붾줉???몄떇??comparison, roadmap, matrix ?몄뿉 decision/evidence 援ъ“??媛뺤젏?쇰줈 ?먯닔?뷀븯?꾨줉 蹂닿컯?덉뒿?덈떎.
- ?뚯뒪?몃줈 [ExcelSkillDataValidationTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ExcelSkillDataValidationTests.cs)瑜?異붽??덇퀬, [DocumentAssemblerDocxFeaturesTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DocumentAssemblerDocxFeaturesTests.cs), [HtmlSkillConsultingSectionsTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/HtmlSkillConsultingSectionsTests.cs)瑜??뺤옣??DOCX ?쒗뵆由??섏씠吏 踰덊샇? HTML decision/evidence 釉붾줉???뚭? 寃利앺뻽?듬땲??
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_phase_next\\ -p:IntermediateOutputPath=obj\\verify_doc_phase_next\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "DocumentAssemblerDocxFeaturesTests|DocumentAssemblerSemanticTests|DocumentPlannerWorkbookScaffoldTests|ExcelSkillExecutiveSummaryLinkTests|ExcelSkillSummarySheetTests|ExcelSkillDataValidationTests|HtmlSkillConsultingSectionsTests|DocxSkillTemplateFeaturesTests|DocumentPlannerBusinessDocumentTests" -p:OutputPath=bin\\verify_doc_phase_next_tests\\ -p:IntermediateOutputPath=obj\\verify_doc_phase_next_tests\\` ?듦낵 9

?낅뜲?댄듃: 2026-04-14 23:05 (KST)
- 臾몄꽌 怨좊룄???ㅼ쓬 ?④퀎瑜?諛섏쁺?덉뒿?덈떎. [ExcelSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ExcelSkill.cs)??`summary_sheet`??`decision_summary`, `scorecards`, `sheet_summaries`瑜?異붽?濡?諛쏆쓣 ???덇쾶 ?뺤옣?먭퀬, executive summary sheet?먯꽌 ?섏궗寃곗젙 ?붿껌, ?듭떖 scorecard, ?곸꽭 ?쒗듃蹂??곹깭瑜??쒖꽌?濡??뚮뜑留곹빀?덈떎.
- ?뚰겕遺??덉쭏 由щ럭 ?낅젰??媛숈? 援ъ“瑜??몄떇?섎룄濡?[ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)??`WorkbookReviewInput`怨?`ReviewWorkbook()`瑜??뺤옣?덉뒿?덈떎. ?댁젣 summary sheet媛 KPI/decision/detail summary瑜?異⑸텇???닿퀬 ?덈뒗吏 媛뺤젏怨?蹂댁셿 ?ъ씤?몃줈 ?④퍡 ?쒖떆?⑸땲??
- [DocumentAssemblerTool.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DocumentAssemblerTool.cs)??`style_map` ?뚮씪誘명꽣瑜?諛쏆븘 template-based DOCX assembly?먯꽌 `title`, `heading1`, `heading2`, `body` 臾몃떒 ?ㅽ??쇱쓣 ?ㅼ젣 Word 臾몃떒??留ㅽ븨?⑸땲?? cover title, ?뱀뀡 ?ㅻ뵫, 蹂몃Ц 臾몃떒???щ궡 ?쒗뵆由??ㅽ??쇱쓣 ???먯뿰?ㅻ읇寃??곕씪媛?꾨줉 ?뺣━?덉뒿?덈떎.
- ???뚭? ?뚯뒪??[ExcelSkillDashboardSummaryTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ExcelSkillDashboardSummaryTests.cs), [DocumentAssemblerStyleMapTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DocumentAssemblerStyleMapTests.cs)瑜?異붽??덇퀬, [ArtifactQualityReviewServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ArtifactQualityReviewServiceTests.cs)????record ?쒓렇?덉쿂??留욎떠 媛깆떊?덉뒿?덈떎.
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_next2\\ -p:IntermediateOutputPath=obj\\verify_doc_next2\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ArtifactQualityReviewServiceTests|DocumentAssemblerStyleMapTests|DocumentAssemblerDocxFeaturesTests|DocumentAssemblerSemanticTests|ExcelSkillDashboardSummaryTests|ExcelSkillSummarySheetTests|ExcelSkillExecutiveSummaryLinkTests|ExcelSkillDataValidationTests|ExcelSkillConditionalFormattingTests" -p:OutputPath=bin\\verify_doc_next2_tests\\ -p:IntermediateOutputPath=obj\\verify_doc_next2_tests\\` ?듦낵 11

?낅뜲?댄듃: 2026-04-14 23:15 (KST)
- [ExcelSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ExcelSkill.cs)??`summary_sheet.trend_series`瑜??덈줈 吏?먰빀?덈떎. summary sheet?먯꽌 `Trend Dashboard` ?뱀뀡??異붽?濡?留뚮뱾怨?`label/current/target/delta/status`瑜???湲곕컲?쇰줈 ?뚮뜑留곹빐 workbook summary媛 KPI ???섏????섏뼱 ?곹깭 ??쒕낫????븷源뚯? ?섎룄濡??뺤옣?덉뒿?덈떎.
- 媛숈? ?뚯씪??workbook review ?낅젰 怨꾩궛? `trend_series`??summary quality 媛뺤젏?쇰줈 ?몄젙?섎룄濡??낅뜲?댄듃?덉뒿?덈떎. [ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)??workbook summary媛 KPI/decision/highlight ?놁씠 ?앸굹??寃쎌슦 蹂댁셿 ?ъ씤?몃? 異붽?濡?諛섑솚?⑸땲??
- [HtmlSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/HtmlSkill.cs)??`print=true`?먯꽌 紐낆떆??`print_header`/`print_footer`媛 ?녿뒗 寃쎌슦 湲곕낯 frame(`title`, `date | AX Copilot`)???먮룞 ?앹꽦?⑸땲?? print-ready HTML??理쒖냼 諛고룷??header/footer瑜?媛뽯룄濡??대? 湲곕낯媛믪쓣 ?ｌ? 寃껋엯?덈떎.
- [ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)??HTML 由щ럭??print-ready 臾몄꽌??frame???녾굅?? decision/evidence block??遺議깊븯嫄곕굹, ?λЦ 蹂닿퀬?쒖씤??cover媛 ?녿뒗 寃쎌슦瑜?異붽?濡?寃쎄퀬?⑸땲??
- [DeckPlanningService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DeckPlanningService.cs)??`comparison`, `roadmap`, `executive_summary`, `kpi_dashboard` ?щ씪?대뱶??理쒖냼 援ъ“瑜??먮룞 蹂댁젙?섍퀬, 湲?headline? ?대? 湲곗? 湲몄씠濡??뺤텞?⑸땲??
- [DeckQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DeckQualityReviewService.cs)??slide-level quality gate瑜?異붽???湲?headline, 怨쇰? ?щ씪?대뱶, ?듭뀡 遺議? ??李⑦듃 ?곗씠???꾨씫??`Slide N:` 寃쎄퀬濡??덉쭏 ?붿빟???ы븿?⑸땲??
- ?뚯뒪?몃줈 [ExcelSkillDashboardSummaryTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ExcelSkillDashboardSummaryTests.cs), [HtmlSkillPrintFrameTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/HtmlSkillPrintFrameTests.cs), [DeckQualityReviewServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DeckQualityReviewServiceTests.cs)瑜??뺤옣?덉뒿?덈떎.
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_next3\\ -p:IntermediateOutputPath=obj\\verify_doc_next3\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "DeckQualityReviewServiceTests|PptxSkillAutoRepairTests|PptxSkillConsultingDeckTests|ExcelSkillDashboardSummaryTests|ExcelSkillSummarySheetTests|HtmlSkillPrintFrameTests|HtmlSkillConsultingSectionsTests|ArtifactQualityReviewServiceTests" -p:OutputPath=bin\\verify_doc_next3_tests\\ -p:IntermediateOutputPath=obj\\verify_doc_next3_tests\\` ?듦낵 13

?낅뜲?댄듃: 2026-04-14 23:25 (KST)
- [ExcelSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ExcelSkill.cs)??`summary_sheet.dashboard_sheet_name`怨?`trend_series`瑜?諛뷀깢?쇰줈 蹂꾨룄 `Dashboard` worksheet瑜??앹꽦?⑸땲?? summary sheet?먯꽌 decision summary, scorecards, trend dashboard, detail sheet links瑜??붿빟?섍퀬, dashboard sheet?먯꽌???대? ???μ쓽 workbook dashboard濡??ㅼ떆 ?뺣━??summary-only workbook蹂대떎 遺꾩꽍/蹂닿퀬 諛?꾨? ?믪엯?덈떎.
- 媛숈? ?뚯씪??single-sheet / multi-sheet workbook ?앹꽦 寃쎈줈??dashboard sheet媛 ?덉쑝硫??쒗듃 ?쒖꽌瑜?`Summary -> Dashboard -> Detail...`濡??뺣젹?섍퀬, summary hyperlink ?섏? total sheet count瑜??덉쭏 由щ럭 ?낅젰???뺥솗???꾨떖?⑸땲??
- [ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)??`WorkbookReviewInput`? `HasDashboardSheet`瑜??덈줈 諛쏆뒿?덈떎. dashboard媛 ?덈뒗 workbook? 媛뺤젏?쇰줈 怨꾩궛?섍퀬, detail sheet媛 ?щ윭 ?μ씤??dashboard媛 ?녿뒗 寃쎌슦??蹂댁셿 ?ъ씤?몃줈 ?뚮젮以띾땲??
- [DocumentAssemblerTool.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DocumentAssemblerTool.cs)??`style_map` 吏??踰붿쐞瑜?`cover_subtitle`, `callout`, `table_header`源뚯? ?볧삍?듬땲?? cover subtitle 臾몃떒, 媛뺤“ 釉붾줉 paragraph, ??header cell paragraph媛 ?щ궡 DOCX ?쒗뵆由??ㅽ??쇱쓣 ?ㅼ젣濡???꾨줉 議곕┰ 寃쎈줈瑜??곌껐?덉뒿?덈떎.
- [DocumentAssemblerStyleMapTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DocumentAssemblerStyleMapTests.cs)??title/heading/body肉??꾨땲??subtitle/callout/table header ?ㅽ??쇨퉴吏 ?뚭? 寃利앺븯?꾨줉 蹂닿컯?덉뒿?덈떎.
- [PptxSkillGoldenDeckTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/PptxSkillGoldenDeckTests.cs)瑜?異붽???strong board deck??`PPT quality` ?붿빟???덉젙?곸쑝濡?諛섑솚?섍퀬 遺덊븘?뷀븳 `Slide alerts` ?놁씠 ?듦낵?섎뒗吏 golden regression?쇰줈 怨좎젙?덉뒿?덈떎.
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_next4\\ -p:IntermediateOutputPath=obj\\verify_doc_next4\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ArtifactQualityReviewServiceTests|DocumentAssemblerStyleMapTests|DocumentAssemblerDocxFeaturesTests|DocumentAssemblerSemanticTests|ExcelSkillDashboardSummaryTests|ExcelSkillSummarySheetTests|ExcelSkillExecutiveSummaryLinkTests|ExcelSkillDataValidationTests|ExcelSkillConditionalFormattingTests|HtmlSkillPrintFrameTests|HtmlSkillConsultingSectionsTests|DeckQualityReviewServiceTests|PptxSkillAutoRepairTests|PptxSkillConsultingDeckTests|PptxSkillGoldenDeckTests" -p:OutputPath=bin\\verify_doc_next4_tests\\ -p:IntermediateOutputPath=obj\\verify_doc_next4_tests\\` ?듦낵 20

?낅뜲?댄듃: 2026-04-14 23:32 (KST)
- [HtmlSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/HtmlSkill.cs)??`board_report`, `strategy_brief` 援ъ“???뱀뀡 ??낆쓣 異붽??덉뒿?덈떎. board report??decision ask, recommendation, rationale, metrics, risks, next steps瑜?board-ready ?⑤꼸濡??뚮뜑留곹븯怨? strategy brief??strategic question, core thesis, implications, decisions瑜??꾨왂 ?붿빟 ?⑤꼸濡??뚮뜑留곹빀?덈떎.
- [ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)??HTML 由щ럭??`board-report-panel`, `strategy-brief-panel`????媛뺤젏?쇰줈 ?몄떇?⑸땲?? 諛섎?濡?board report?몃뜲 evidence/table???녾굅??strategy brief?몃뜲 comparison/roadmap???놁쓣 ?뚮뒗 異붽? 蹂댁셿 ?ъ씤?몃? 諛섑솚?섎룄濡?洹쒖튃??蹂닿컯?덉뒿?덈떎.
- [ExcelSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ExcelSkill.cs)??`WriteDashboardSheet()`??dashboard sheet??`kpis`, `highlights`, `actions`源뚯? ?④퍡 ?쒖떆?섎룄濡??뺤옣?먯뒿?덈떎. summary sheet? dashboard sheet媛 ?쒕줈 媛숈? ?뺣낫瑜??⑥닚 以묐났?섎뒗 ??? executive dashboard ?깃꺽????遺꾨챸??媛뽯룄濡??뺣━??蹂寃쎌엯?덈떎.
- [PptxSkillGoldenDeckTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/PptxSkillGoldenDeckTests.cs)??board deck ?몄뿉 strategy deck golden fixture瑜?異붽??덉뒿?덈떎. `storyline`, `decision_ask`, recommendation headline 湲몄씠源뚯? ?덉쭏 寃뚯씠??湲곗???留욌뒗 strong strategy deck???뚭? ?섑뵆濡?怨좎젙?덉뒿?덈떎.
- ?뚯뒪?몃줈 [HtmlSkillConsultingSectionsTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/HtmlSkillConsultingSectionsTests.cs), [ExcelSkillDashboardSummaryTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ExcelSkillDashboardSummaryTests.cs), [ArtifactQualityReviewServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ArtifactQualityReviewServiceTests.cs), [PptxSkillGoldenDeckTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/PptxSkillGoldenDeckTests.cs)瑜??뺤옣?덉뒿?덈떎.
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_next5\\ -p:IntermediateOutputPath=obj\\verify_doc_next5\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ArtifactQualityReviewServiceTests|ExcelSkillDashboardSummaryTests|HtmlSkillConsultingSectionsTests|HtmlSkillPrintFrameTests|DeckQualityReviewServiceTests|PptxSkillGoldenDeckTests|PptxSkillAutoRepairTests|PptxSkillConsultingDeckTests" -p:OutputPath=bin\\verify_doc_next5_tests\\ -p:IntermediateOutputPath=obj\\verify_doc_next5_tests\\` ?듦낵 14

?낅뜲?댄듃: 2026-04-14 23:58 (KST)
- [ArtifactRepairGuideService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactRepairGuideService.cs)瑜?異붽??덉뒿?덈떎. ???쒕퉬?ㅻ뒗 [ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)媛 諛섑솚??HTML/XLSX/DOCX ?덉쭏 ?댁뒋瑜??쎌뼱 `Repair guide:` ?뺥깭??諛붾줈 ?ㅽ뻾 媛?ν븳 媛쒖꽑 媛?대뱶濡?諛붽퓠?덈떎.
- [HtmlSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/HtmlSkill.cs), [ExcelSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ExcelSkill.cs), [DocumentAssemblerTool.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DocumentAssemblerTool.cs)???댁젣 ?덉쭏 ?먯닔 ?붿빟 ?ㅼ뿉 repair guide瑜??④퍡 諛섑솚?⑸땲?? 異쒕젰留?蹂대뒗 ?ъ슜?먮룄 ?쒕Т?뉗쓣 ??蹂댁셿?댁빞 ?섎뒗吏?앸? 諛붾줈 ?댄빐?????덇쾶 ?뺣━??蹂寃쎌엯?덈떎.
- [ExcelSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ExcelSkill.cs)??`dashboard_tiles`, `variance_series`瑜?異붽? 吏?먰빀?덈떎. `WriteDashboardSheet()` 寃쎈줈??decision summary, scorecards, KPI, trend dashboard, detail summaries ?몄뿉 dashboard tiles? variance overview源뚯? ?④퍡 ?뚮뜑留곹빐 ?댁쁺 由щ럭??workbook archetype????紐낇솗??留뚮뱾?덉뒿?덈떎.
- workbook 由щ럭 媛뺤젏 怨꾩궛??媛숈씠 ?볧삍?듬땲?? [ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)??summary/dashboard ?좏샇 ?먯젙? `dashboard_tiles`, `variance_series`媛 ?ㅼ뼱??workbook??richer dashboard濡??몄떇?⑸땲??
- 紐⑹쟻??踰덈뱾 ?ㅽ궗??異붽??덉뒿?덈떎. [strategy-brief-html.skill.md](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/skills/strategy-brief-html.skill.md)???꾨왂 釉뚮━??HTML ?앹꽦??吏꾩엯?먯쓣 ?쒓났?섍퀬, [operating-review-xlsx.skill.md](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/skills/operating-review-xlsx.skill.md)??Summary/Dashboard/Detail 援ъ“???댁쁺 由щ럭 workbook ?앹꽦 寃쎈줈瑜??쒓났?⑸땲??
- ?뚯뒪?몃줈 [ArtifactRepairGuideServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ArtifactRepairGuideServiceTests.cs)瑜?異붽??덇퀬, [ExcelSkillDashboardSummaryTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ExcelSkillDashboardSummaryTests.cs), [HtmlSkillConsultingSectionsTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/HtmlSkillConsultingSectionsTests.cs)瑜??뺤옣??archetype怨?repair guide瑜??④퍡 ?뚭? 寃利앺뻽?듬땲??
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_next6\\ -p:IntermediateOutputPath=obj\\verify_doc_next6\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ArtifactQualityReviewServiceTests|ArtifactRepairGuideServiceTests|ExcelSkillDashboardSummaryTests|HtmlSkillConsultingSectionsTests|HtmlSkillPrintFrameTests|DocumentAssemblerStyleMapTests|DocumentAssemblerDocxFeaturesTests|DocumentAssemblerSemanticTests|PptxSkillGoldenDeckTests|DeckQualityReviewServiceTests" -p:OutputPath=bin\\verify_doc_next6_tests\\ -p:IntermediateOutputPath=obj\\verify_doc_next6_tests\\` ?듦낵 17

?낅뜲?댄듃: 2026-04-15 00:19 (KST)
- `AgentCommandQueue`瑜?`Prompt/Notification` 2醫낆뿉??`Steering`, `PermissionContinuation`, `Resume`, `UserDecision`源뚯? ?ы븿?섎뒗 ?듯빀 ?먮줈 ?뺤옣?덉뒿?덈떎. [AgentLoopService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentLoopService.cs)???대? `queued_steering`, `queue_permission_continuation`, `queue_resume` 硫뷀? 硫붿떆吏濡?二쇱엯???ㅽ뻾 以?異붽? ?낅젰怨??뱀씤 ???ш컻 臾몃㎘?????덉젙?곸쑝濡?諛섏쁺?⑸땲??
- 肄붾뱶 ???몄뼱 吏??移댄깉濡쒓렇瑜??뺤옣?덉뒿?덈떎. [CodeLanguageCatalog.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/CodeLanguageCatalog.cs)??`Go`, `Rust`, `PHP`, `Ruby`, `Kotlin`, `Swift`瑜?LSP ?ы솕 吏?먭뎔?쇰줈 ?밴꺽?덇퀬, [LspClientService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/LspClientService.cs)??`gopls`, `rust-analyzer`, `intelephense`, `solargraph`, `kotlin-language-server`, `sourcekit-lsp`瑜?濡쒖뺄 ?ㅼ튂 ?쒕쾭 湲곗??쇰줈 ?먯??⑸땲??
- ?대? ?ㅼ젙??肄붾뱶 ???ㅻ챸????紐낆떆?곸쑝濡??뺣━?덉뒿?덈떎. [SettingsWindow.xaml](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Views/SettingsWindow.xaml), [SettingsViewModel.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/ViewModels/SettingsViewModel.cs)??`鍮좊Ⅸ ?좏깮 ?몄뼱`, `吏???몄뼱(LSP)`, `肄붾뱶 ??湲곕낯 吏?????섎닠 蹂댁뿬二쇰룄濡?蹂닿컯?덉뒿?덈떎.
- ?뚰겕?ㅽ럹?댁뒪 而⑦뀓?ㅽ듃 ?앹꽦湲곕? 媛뺥솕?덉뒿?덈떎. [WorkspaceContextGenerator.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/WorkspaceContextGenerator.cs)??`Language Snapshot`, `Agent Context`, `Key Manifests` ?뱀뀡??異붽??섍퀬 `.claude/skills`, `.ax/rules`, `AXMEMORY.md`, 二쇱슂 manifest ?뚯씪???④퍡 ?붿빟?⑸땲??
- PPT ?덉쭏 蹂댁젙 媛?대뱶??異붽??덉뒿?덈떎. [DeckRepairGuideService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DeckRepairGuideService.cs)??deck ?덉쭏 ?댁뒋瑜?諛붾줈 ?ㅽ뻾 媛?ν븳 媛쒖꽑 臾몄옣?쇰줈 諛붽씀怨? [PptxSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/PptxSkill.cs)??`Deck repair guide:`瑜??덉쭏 ?붿빟怨??④퍡 諛섑솚?⑸땲??
- ?뚯뒪?? [AgentCommandQueueTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/AgentCommandQueueTests.cs), [CodeLanguageCatalogTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/CodeLanguageCatalogTests.cs), [WorkspaceContextGeneratorTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/WorkspaceContextGeneratorTests.cs), [DeckRepairGuideServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DeckRepairGuideServiceTests.cs), [PptxSkillConsultingDeckTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/PptxSkillConsultingDeckTests.cs)
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_master_batch\\ -p:IntermediateOutputPath=obj\\verify_master_batch\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentCommandQueueTests|CodeLanguageCatalogTests|WorkspaceContextGeneratorTests|PptxSkillConsultingDeckTests|DeckRepairGuideServiceTests" -p:OutputPath=bin\\verify_master_batch_tests\\ -p:IntermediateOutputPath=obj\\verify_master_batch_tests\\` ?듦낵 35

?낅뜲?댄듃: 2026-04-15 07:00 (KST)
- `湲곗? 援ъ“` 湲곗? ?⑥? 寃⑹감瑜?以꾩씠湲??꾪븳 ?듯빀 怨좊룄??怨꾪쉷???뺤젙?덉뒿?덈떎. ?⑥? 二쇱슂 異뺤? `?먯씠?꾪떛 猷⑦봽/紐낅졊 ??, `tool_result preview ?덉젙??, `紐낅졊/?ㅽ궗 ?⑹꽦`, `臾몄꽌 ?щ㎎ 留덇컧`, `媛쒕컻?몄뼱 吏???뺥빀??, `?뚭? ?뚯뒪??由대━利?寃뚯씠???낅땲??
- 泥?諛곗튂濡?[AgentCommandQueue.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentCommandQueue.cs)瑜??곗꽑?쒖쐞 諛곗튂 ?뚮퉬媛 媛?ν븳 援ъ“濡??ъ옉?깊뻽?듬땲?? `peek`, `dequeue`, `dequeueAllMatching`, `dequeuePriorityBatch`, `snapshot` API瑜?異붽???`湲곗? 援ъ“`??unified queue泥섎읆 怨좎슦???낅젰??癒쇱? ?뚮퉬?섍퀬 lower-priority ??ぉ???ㅻ줈 誘몃（??湲곕컲??留뚮뱾?덉뒿?덈떎.
- [AgentLoopService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentLoopService.cs)????諛곗닔 濡쒖쭅???④퍡 議곗젙?덉뒿?덈떎. 湲곗〈 `DrainAll()` 諛⑹떇 ???媛숈? ?곗꽑?쒖쐞 諛곗튂留??뚮퉬?섍퀬, ?⑥? ????ぉ???덉쑝硫?`Deferred ... lower-priority queued item(s)` thinking ?대깽?몃? ?④꺼 ?ㅼ쓬 ?댁쑝濡??섍퉩?덈떎.
- [AgentToolResultBudget.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentToolResultBudget.cs)??preview ?ъ궗??踰붿쐞瑜??볧삍?듬땲?? 湲곗〈?먮뒗 ?숈씪 `MsgId`?먯꽌留?`QueryPreviewContent`瑜??ъ궗?⑺뻽吏留? ?댁젣 `tool_use_id` 湲곗? preview ?몃뜳?ㅻ? 留뚮뱾???ш뎄?깅맂 tool result 硫붿떆吏?먯꽌???덉젙?곸쑝濡?媛숈? preview瑜??ъ궗?⑺빀?덈떎.
- ?뚯뒪?몃뒗 [AgentCommandQueueTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/AgentCommandQueueTests.cs)??`priority batch dequeue`, `predicate matching` ?쒕굹由ъ삤瑜?異붽??덇퀬, [AgentToolResultBudgetTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/AgentToolResultBudgetTests.cs)?먮뒗 `tool_use_id`媛 媛숈? cloned tool result媛 ?댁쟾 preview瑜??ъ궗?⑺븯???뚭? 耳?댁뒪瑜?異붽??덉뒿?덈떎.
- ?ㅼ쓬 諛곗튂?먯꽌??`tool_result replacement state`瑜?????⑥쐞濡???怨좎젙?섍퀬, ?댄썑 `紐낅졊/?ㅽ궗 ?⑹꽦 怨꾩링`怨?`臾몄꽌 ?щ㎎ 留덇컧`?쇰줈 ?쒖감 ?뺤옣???덉젙?낅땲??
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_queue_preview\\ -p:IntermediateOutputPath=obj\\verify_queue_preview\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentCommandQueueTests|AgentToolResultBudgetTests" -p:OutputPath=bin\\verify_queue_preview_tests\\ -p:IntermediateOutputPath=obj\\verify_queue_preview_tests\\` ?듦낵 7

?낅뜲?댄듃: 2026-04-15 07:16 (KST)
- `tool_result` preview ?덉젙??2李⑤? 諛섏쁺?덉뒿?덈떎. [AgentMessageInvariantHelper.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentMessageInvariantHelper.cs)??`tool_use_id -> QueryPreviewContent` 留듭쓣 怨듭슜?쇰줈 留뚮뱾怨? 媛숈? tool result媛 ?ㅻⅨ 硫붿떆吏 媛앹껜濡??ㅼ떆 濡쒕뱶?섎뜑?쇰룄 preview瑜?蹂듭썝?섎뒗 helper瑜??쒓났?⑸땲??
- [ChatSessionStateService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/ChatSessionStateService.cs)??遺꾧린 ????앹꽦 ??`QueryPreviewContent`瑜??④퍡 蹂듭궗?섍퀬, ??λ맂 ??붾? ?ㅼ떆 ?????꾨씫??preview瑜?`tool_use_id` 湲곗??쇰줈 蹂댁젙?⑸땲?? [ChatStorageService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/ChatStorageService.cs)?????吏곸쟾??preview 蹂댁젙??癒쇱? ?섑뻾???ъ떆????異뺤빟 ?곹깭媛 ?붾뱾由ъ? ?딄쾶 留욎톬?듬땲??
- ?щ옒???⑹꽦???ㅽ뻾 寃쎈줈源뚯? ?쇱썝?뷀뻽?듬땲?? [SlashCommandCatalog.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Views/SlashCommandCatalog.cs)??exact token 異⑸룎???붾젅?몄? 媛숈? ?곗꽑?쒖쐞濡??댁꽍?섎뒗 `ResolvePreferredCommand()`瑜?異붽??덇퀬, [ChatWindow.xaml.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Views/ChatWindow.xaml.cs)??`ParseSlashCommandAsync()`??built-in/skill ?꾨낫瑜??④퍡 紐⑥? ??媛숈? 洹쒖튃?쇰줈 ?곗꽑 ??곸쓣 ?좏깮?⑸땲??
- ??蹂寃쎌쑝濡?`/review`泥섎읆 builtin command? skill??媛숈? ?좏겙??怨듭쑀?섎뒗 寃쎌슦?먮룄 ?쒗뙏?덊듃?먮뒗 skill???욎뿉 蹂댁씠?붾뜲 ?ㅽ뻾? builtin??癒쇱? ?≫엳?붴?遺덉씪移섍? 以꾩뼱?ㅼ뿀?듬땲??
- ?뚯뒪?몃뒗 [ChatSessionStateServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ChatSessionStateServiceTests.cs)??branch/save-load preview 蹂듭썝 耳?댁뒪瑜?異붽??덇퀬, [SlashCommandCatalogTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/SlashCommandCatalogTests.cs)瑜??덈줈 異붽???skill ?곗꽑 dedupe? exact token ?곗꽑 ?댁꽍???뚭? 寃利앺뻽?듬땲??
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_preview_state\\ -p:IntermediateOutputPath=obj\\verify_preview_state\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentToolResultBudgetTests|ChatSessionStateServiceTests" -p:OutputPath=bin\\verify_preview_state_tests\\ -p:IntermediateOutputPath=obj\\verify_preview_state_tests\\` ?듦낵 38
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_command_resolution\\ -p:IntermediateOutputPath=obj\\verify_command_resolution\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "SlashCommandCatalogTests|ChatSessionStateServiceTests|AgentToolResultBudgetTests|AgentCommandQueueTests" -p:OutputPath=bin\\verify_command_resolution_tests\\ -p:IntermediateOutputPath=obj\\verify_command_resolution_tests\\` ?듦낵 50

?낅뜲?댄듃: 2026-04-15 08:32 (KST)
- `tool_result` replacement state瑜?query/compact 吏꾩엯 ?꾩뿉????怨좎젙?덉뒿?덈떎. [AgentQueryContextBuilder.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentQueryContextBuilder.cs)??query view ?앹꽦 ?꾩뿉 ?꾨씫??preview瑜?癒쇱? 蹂듭썝?섍퀬, [ContextCondenser.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ContextCondenser.cs)??compact ?댁쟾??媛숈? ?뺢퇋?붾? ?곸슜??湲??몄뀡怨??ъ떆?????곹깭 李⑥씠瑜?以꾩??듬땲??
- [AgentToolResultBudget.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentToolResultBudget.cs)??`sourceMessages`媛 ?녿뒗 ?몄텧?먯꽌???꾩옱 window ?먯껜??`tool_use_id` preview瑜??ъ궗?⑺븯?꾨줉 蹂닿컯?덉뒿?덈떎. ??蹂寃쎌쑝濡?query view ?대???cloned tool_result??source list ?좊Т? 愿怨꾩뾾??媛숈? preview瑜????덉젙?곸쑝濡??좎??⑸땲??
- 媛쒕컻?몄뼱 吏?먯? `no-LSP fallback`源뚯? ?곌껐?덉뒿?덈떎. [CodeLanguageCatalog.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/CodeLanguageCatalog.cs)???몄뼱蹂?`manifest/build/test/lint` ?뚰듃瑜??쒓났?섍퀬, [LspTool.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/LspTool.cs)??濡쒖뺄 ?몄뼱 ?쒕쾭媛 ?녾굅???곌껐?섏? ?딆븘???뺤쟻 fallback ?덈궡瑜?諛섑솚?⑸땲??
- ?ㅼ젙怨??꾨＼?꾪듃??媛숈? 紐⑤뜽濡?留욎톬?듬땲?? [SettingsViewModel.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/ViewModels/SettingsViewModel.cs), [SettingsWindow.xaml](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Views/SettingsWindow.xaml), [ChatWindow.SystemPromptBuilder.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Views/ChatWindow.SystemPromptBuilder.cs)??`Fallback 遺꾩꽍` ?ㅻ챸怨?LSP 誘몄궗?????泥?遺꾩꽍 吏移⑥쓣 ?몄텧?⑸땲??
- ?뚯뒪?몃줈 [AgentQueryContextBuilderTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/AgentQueryContextBuilderTests.cs)瑜?異붽??덇퀬, [AgentToolResultBudgetTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/AgentToolResultBudgetTests.cs), [CodeLanguageCatalogTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/CodeLanguageCatalogTests.cs)瑜??뺤옣??preview ?ъ궗?⑷낵 fallback ?뚰듃瑜??뚭? 寃利앺뻽?듬땲??
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_loop_lang_finish\\ -p:IntermediateOutputPath=obj\\verify_loop_lang_finish\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentToolResultBudgetTests|AgentQueryContextBuilderTests|CodeLanguageCatalogTests|ContextCondenserTests" -p:OutputPath=bin\\verify_loop_lang_finish_tests\\ -p:IntermediateOutputPath=obj\\verify_loop_lang_finish_tests\\` ?듦낵 20

?낅뜲?댄듃: 2026-04-15 09:05 (KST)
- 臾몄꽌 critic/repair 猷⑦봽瑜?異붽? ?뺣━?덉뒿?덈떎. [ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)??DOCX ?λЦ 臾몄꽌?먯꽌 `cover`, `table of contents`, `template`, `header/footer` 蹂닿컯 ?ъ씤?몃?, XLSX dashboard workbook?먯꽌??`highlight/action`, `detail navigation`, `trend/variance formula` 蹂닿컯 ?ъ씤?몃? ?덈줈 ?먯젙?⑸땲??
- [ArtifactRepairGuideService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactRepairGuideService.cs)?????댁뒋?ㅼ쓣 諛붾줈 ?ㅽ뻾 媛?ν븳 蹂댁젙 媛?대뱶濡?移섑솚?섎룄濡??뺤옣?덉뒿?덈떎. HTML/DOCX/XLSX?먯꽌 ?덉쭏 ?먯닔留?蹂댁뿬二쇰뒗 寃껋씠 ?꾨땲?? ?대뼡 援ъ“瑜?異붽??섍굅???대뼡 ?곗씠?곕? ?곌껐?댁빞 ?섎뒗吏 吏곸젒 ?덈궡?⑸땲??
- [DeckRepairGuideService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DeckRepairGuideService.cs)??`appendix/evidence` 遺議깃낵 `duplicate headline` 臾몄젣瑜?蹂꾨룄 ?≪뀡?쇰줈 諛붽퓭 deck 留덇컧 媛?대뱶瑜???援ъ껜?뷀뻽?듬땲??
- [DocxSkill.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DocxSkill.cs)??DOCX 異쒕젰 寃곌낵?먮룄 `Repair guide:`瑜??④퍡 諛섑솚?섍퀬, Executive Summary/Recommendation/Appendix ?뱀뀡 ?몄떇???쒓? ?ㅼ썙?쒕? 媛숈씠 ?ъ슜?섎룄濡?議곗젙?덉뒿?덈떎.
- ?뚯뒪?몃뒗 [ArtifactQualityReviewServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ArtifactQualityReviewServiceTests.cs), [ArtifactRepairGuideServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ArtifactRepairGuideServiceTests.cs), [DeckRepairGuideServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DeckRepairGuideServiceTests.cs), [DocxSkillTemplateFeaturesTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DocxSkillTemplateFeaturesTests.cs)瑜??뺤옣???뚭?瑜?怨좎젙?덉뒿?덈떎.
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_repair_finalize\\ -p:IntermediateOutputPath=obj\\verify_doc_repair_finalize\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ArtifactQualityReviewServiceTests|ArtifactRepairGuideServiceTests|DeckRepairGuideServiceTests|DocxSkillTemplateFeaturesTests" -p:OutputPath=bin\\verify_doc_repair_finalize_tests\\ -p:IntermediateOutputPath=obj\\verify_doc_repair_finalize_tests\\` ?듦낵 11

?낅뜲?댄듃: 2026-04-15 09:24 (KST)
- ?먯씠?꾪떛 猷⑦봽??queued command ?뚮퉬 濡쒖쭅??helper濡?遺꾨━?덉뒿?덈떎. [AgentQueuedCommandProjector.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentQueuedCommandProjector.cs)??drain????諛곗튂瑜?`queued_input_interrupt`, `queue_notification`, `queue_resume`, `queued_prompt` 媛숈? ???硫붿떆吏? thinking/user ?대깽?몃줈 ?ъ쁺?⑸땲?? [AgentLoopService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentLoopService.cs)????寃곌낵瑜??곸슜?섎뒗 ??븷留??④꺼 猷⑦봽 蹂몄껜??梨낆엫????以꾩??듬땲??
- workbook/dashboard ?덉쭏 由щ럭??媛뺥솕?덉뒿?덈떎. [ArtifactQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactQualityReviewService.cs)??dashboard sheet媛 ?덉뼱??KPI쨌trend쨌decision ?댁슜??遺議깊븯硫?蹂꾨룄 ?댁뒋瑜?留뚮뱾怨? [ArtifactRepairGuideService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/ArtifactRepairGuideService.cs)???대? `core story`媛 蹂댁씠?꾨줉 KPI/decision 釉붾줉??異붽??섎씪??媛?대뱶濡??곌껐?⑸땲??
- deck ?덉쭏 由щ럭??storyline ?뚰듃源뚯? 蹂닿린 ?쒖옉?덉뒿?덈떎. [DeckQualityReviewService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DeckQualityReviewService.cs)??storyline??`Options`, `Roadmap`, `Appendix`媛 ?덈뒗???ㅼ젣 ?щ씪?대뱶媛 鍮좎쭊 寃쎌슦 蹂꾨룄 ?댁뒋瑜?留뚮뱾怨? [DeckRepairGuideService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/DeckRepairGuideService.cs)???대? storyline 蹂닿컯 ?≪뀡?쇰줈 諛붽퓠?덈떎.
- ?뚯뒪?몃뒗 [AgentQueuedCommandProjectorTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/AgentQueuedCommandProjectorTests.cs), [DeckQualityReviewServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DeckQualityReviewServiceTests.cs), [ArtifactQualityReviewServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ArtifactQualityReviewServiceTests.cs), [ArtifactRepairGuideServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ArtifactRepairGuideServiceTests.cs), [DeckRepairGuideServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DeckRepairGuideServiceTests.cs)瑜??뺤옣???뚭?瑜?怨좎젙?덉뒿?덈떎.
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_loop_doc_finish2\\ -p:IntermediateOutputPath=obj\\verify_loop_doc_finish2\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentQueuedCommandProjectorTests|AgentCommandQueueTests|ArtifactQualityReviewServiceTests|ArtifactRepairGuideServiceTests|DeckQualityReviewServiceTests|DeckRepairGuideServiceTests|PptxSkillGoldenDeckTests|ExcelSkillDashboardSummaryTests" -p:OutputPath=bin\\verify_loop_doc_finish2_tests\\ -p:IntermediateOutputPath=obj\\verify_loop_doc_finish2_tests\\` ?듦낵 25

?낅뜲?댄듃: 2026-04-15 09:36 (KST)
- `tool_result` replacement state??留덉?留?鍮덊땲??硫붿썱?듬땲?? [AgentMessageInvariantHelper.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentMessageInvariantHelper.cs)??湲곗〈 `QueryPreviewContent`媛 ?섎굹???녿뒗 寃쎌슦?먮룄 `tool_use_id`, `tool_name`, 異뺤빟??`content/output/error`瑜?湲곕컲?쇰줈 synthetic preview瑜??앹꽦?⑸땲?? ?대줈??????ш컻/遺꾧린 ?댄썑 preview媛 ?꾩쟾???좎떎???몄뀡?먯꽌???ㅼ떆 query preview瑜?留뚮뱾 ???덉뒿?덈떎.
- [AgentQueryContextBuilderTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/AgentQueryContextBuilderTests.cs)? ??[AgentMessageInvariantHelperTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/AgentMessageInvariantHelperTests.cs)??preview媛 ?녿뒗 tool_result媛 synthetic preview濡?蹂듭썝?섍퀬, query view ?앹꽦 ?쒖뿉??媛숈? preview媛 ?ㅼ젣 諛섏쁺?섎뒗吏 ?뚭? 寃利앺빀?덈떎.
- 臾몄꽌 golden ?뚭??????④퀎 ???щ졇?듬땲?? ??[ExcelSkillGoldenWorkbookTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ExcelSkillGoldenWorkbookTests.cs)??summary/dashboard/detail 援ъ“? formula, data validation, conditional formatting??紐⑤몢 ?ы븿???댁쁺 由щ럭 workbook??`Needs work: none`, `Repair guide: none`???좎??섎뒗吏 ?뺤씤?⑸땲??
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_preview_golden_finish\\ -p:IntermediateOutputPath=obj\\verify_preview_golden_finish\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentMessageInvariantHelperTests|AgentQueryContextBuilderTests|AgentQueuedCommandProjectorTests|ExcelSkillGoldenWorkbookTests|ExcelSkillDashboardSummaryTests|PptxSkillGoldenDeckTests" -p:OutputPath=bin\\verify_preview_golden_finish_tests\\ -p:IntermediateOutputPath=obj\\verify_preview_golden_finish_tests\\` ?듦낵 10

?낅뜲?댄듃: 2026-04-15 09:20 (KST)
- 猷⑦봽 吏꾨떒 ?щ㎎??遺꾨━?덉뒿?덈떎. ??[AgentLoopDiagnosticsFormatter.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentLoopDiagnosticsFormatter.cs)??而⑦뀓?ㅽ듃 ?뺤텞 ?꾨즺 ?대깽?몄? query-view ?붿빟 臾몄옄?댁쓣 ?꾨떞?섎ŉ, [AgentLoopService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentLoopService.cs)???대떦 formatter瑜??몄텧?섎뒗 orchestration ??븷濡???媛踰쇱썙議뚯뒿?덈떎.
- ????ш컻 寃쎈줈??legacy preview 蹂듭썝??蹂닿컯?덉뒿?덈떎. [ChatStorageService.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/ChatStorageService.cs)??蹂듯샇??吏곹썑 `PopulateMissingToolResultPreviews()`瑜??섑뻾???덉쟾 ??λ낯?먯꽌??synthetic preview瑜?利됱떆 梨꾩썎?덈떎.
- ?뚯뒪?몃뒗 ??[AgentLoopDiagnosticsFormatterTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/AgentLoopDiagnosticsFormatterTests.cs), [ChatStorageServiceTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/ChatStorageServiceTests.cs), [HtmlSkillGoldenReportTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/HtmlSkillGoldenReportTests.cs), [DocxSkillGoldenDocumentTests.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot.Tests/Services/DocxSkillGoldenDocumentTests.cs)瑜?異붽???猷⑦봽 吏꾨떒 臾몄옄?? legacy `.axchat` 蹂듭썝, HTML/DOCX golden ?덉쭏???뚭? 怨좎젙?덉뒿?덈떎.
- golden 踰붿쐞???댁젣 `PPTX + XLSX + HTML + DOCX`源뚯? ?뺤옣?섏뿀?듬땲?? HTML golden? board-grade 蹂닿퀬?쒖쓽 print frame/evidence/decision 援ъ꽦?? DOCX golden? template/TOC/header-footer/appendix媛 ?ы븿??business pack 議곕┰??湲곗? fixture濡??쇱뒿?덈떎.
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_loop_storage_golden\\ -p:IntermediateOutputPath=obj\\verify_loop_storage_golden\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentLoopDiagnosticsFormatterTests|ChatStorageServiceTests|HtmlSkillGoldenReportTests|DocxSkillGoldenDocumentTests|AgentMessageInvariantHelperTests|PptxSkillGoldenDeckTests|ExcelSkillGoldenWorkbookTests" -p:OutputPath=bin\\verify_loop_storage_golden_tests\\ -p:IntermediateOutputPath=obj\\verify_loop_storage_golden_tests\\` ?듦낵 10

?낅뜲?댄듃: 2026-04-15 09:49 (KST)
- `CodeLanguageCatalog`瑜??⑥닚 ?쒖떆??移댄깉濡쒓렇?먯꽌 ?ㅽ뻾 ?뚰듃 移댄깉濡쒓렇濡??뺤옣?덈떎. ?몄뼱蹂?`manifest/build/test/lint` 議고쉶 硫붿꽌?쒖? `BuildWorkflowSummary()`瑜?異붽??? 吏???몄뼱 紐⑸줉怨?no-LSP fallback ?ㅻ챸??媛숈? ?뚯뒪?먯꽌 ?섏삤?꾨줉 ?뺣━?덈떎.
- `WorkspaceContextGenerator`??`.ax-context.md` ?앹꽦 ??`## Language Workflow` ?뱀뀡??異붽??쒕떎. ?곸쐞 ?몄뼱 3媛쒓퉴吏??manifest, build/test/lint ?뚰듃瑜??④퍡 湲곕줉???κ린 ?몄뀡怨??쒕툕?먯씠?꾪듃 臾몃㎘?먯꽌 諛붾줈 ?ъ궗?⑺븷 ???덇쾶 ?덈떎.
- 臾몄꽌 ?덉쭏 異쒕젰 ?щ㎎??怨듯넻?붾? ?쒖옉?덈떎. ??`ArtifactQualityOutputFormatter`瑜?異붽??덇퀬, ?꾩옱??`HtmlSkill`, `ExcelSkill`???숈씪??quality summary + repair guide 議고빀湲곕? ?ъ슜?쒕떎. ?댄썑 DOCX/PPTX源뚯? 媛숈? helper濡?留욎텛??湲곕컲?대떎.
- ?뚯뒪??蹂닿컯:
  - `CodeLanguageCatalogTests`: workflow summary, hint lookup ?뚭? 異붽?
  - `WorkspaceContextGeneratorTests`: generated context ??`Language Workflow` ?뱀뀡 ?뚭? 異붽?
- 寃利?
  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_language_workflow\\ -p:IntermediateOutputPath=obj\\verify_language_workflow\\`
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "CodeLanguageCatalogTests|WorkspaceContextGeneratorTests" -p:OutputPath=bin\\verify_language_workflow_tests\\ -p:IntermediateOutputPath=obj\\verify_language_workflow_tests\\`

?낅뜲?댄듃: 2026-04-15 10:05 (KST)
- `AgentLoopRunLifecycle.cs` 異붽?:
  - `BeginRun()`?쇰줈 run stopwatch, user query, iteration budget, retry budget 珥덇린??  - `BootstrapRunAsync()`濡?intent 遺꾨쪟, exploration/path state, session learnings, task/execution policy 怨꾩궛 遺꾨━
  - `FinalizeRun()`?쇰줈 run summary metric, exploration breadth, stats 湲곕줉, transient state reset ?쇱썝??- `AgentLoopService.RunAsync()` ?뺣━:
  - ?쒖옉遺??`run id/iteration budget/intent bootstrap` 釉붾줉??helper ?몄텧濡??泥?  - 醫낅즺遺??run summary logging??helper ?몄텧濡??泥?  - 醫낅즺 metric??鍮?run id媛 ?⑤뜕 ?먮쫫???섏젙???ㅼ젣 run id瑜??좎?
- `AgentMessageInvariantHelper` 怨좊룄??
  - persisted preview map怨?fingerprint preview map??遺꾨━
  - 媛숈? tool output???ㅻⅨ `tool_use_id`濡??щ벑?ν븷 ??preview瑜??꾩옱 id濡??щ컮?몃뵫
  - preview ?먯깋 ?곗꽑?쒖쐞瑜?`??λ맂 preview ??fingerprint ?щ컮?몃뵫 ??synthetic` ?쒖꽌濡?怨좎젙
- 臾몄꽌 ?덉쭏 異쒕젰 寃쎈줈 ?뺣━:
  - `ArtifactQualityOutputFormatter`瑜?`DocxSkill`, `PptxSkill`, `ExcelSkill` 硫?곗떆??諛섑솚 寃쎈줈源뚯? ?곌껐
  - ?щ㎎蹂?quality summary/repair guide 臾몄옄??議곕┰??怨듯넻 helper濡??듭씪
- ?뚯뒪??蹂닿컯:
  - `AgentMessageInvariantHelperTests`: fingerprint 湲곕컲 preview ?щ컮?몃뵫 ?뚭? 異붽?
  - ?ш?利???? `AgentCommandQueueTests`, `AgentQueuedCommandProjectorTests`, `AgentQueryContextBuilderTests`, `ChatStorageServiceTests`, `PptxSkillGoldenDeckTests`, `ExcelSkillGoldenWorkbookTests`, `DocxSkillGoldenDocumentTests`, `HtmlSkillGoldenReportTests`
- 寃利?
  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_run_finalize\\ -p:IntermediateOutputPath=obj\\verify_run_finalize\\`
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentCommandQueueTests|AgentQueuedCommandProjectorTests|AgentMessageInvariantHelperTests|AgentQueryContextBuilderTests|ChatStorageServiceTests|PptxSkillGoldenDeckTests|ExcelSkillGoldenWorkbookTests|DocxSkillGoldenDocumentTests|HtmlSkillGoldenReportTests" -p:OutputPath=bin\\verify_run_finalize_tests2\\ -p:IntermediateOutputPath=obj\\verify_run_finalize_tests2\\`

?낅뜲?댄듃: 2026-04-15 10:10 (KST)
- ?듯빀 留덇컧 怨꾪쉷 ?뺤젙:
  1. `臾몄꽌 ?щ㎎ 理쒖쥌 留덇컧`
     - 李몄“ ??? `湲곗? 援ъ“/src/query.ts`, `湲곗? 援ъ“/src/utils/toolResultStorage.ts`, `湲곗? 援ъ“/src/commands/init-verifiers.ts`
     - AX ?곸슜 ?꾩튂: `PptxSkill.cs`, `DeckPlanningService.cs`, `DeckQualityReviewService.cs`, `DocxSkill.cs`, `DocumentAssemblerTool.cs`, `ExcelSkill.cs`, `HtmlSkill.cs`, `ArtifactQualityReviewService.cs`, `ArtifactRepairGuideService.cs`
     - ?꾨즺 議곌굔: PPTX/DOCX/XLSX/HTML 紐⑤몢 `plan -> critic -> repair` ?먮쫫怨?golden fixture ?뺤옣 ?꾨즺
     - ?덉쭏 ?먯젙 湲곗?: strong fixture??`Needs work: none`, weak fixture???щ㎎蹂??곸젅??repair guide瑜?諛섑솚
  2. `?먯씠?꾪떛 猷⑦봽 iteration pipeline 遺꾨━`
     - 李몄“ ??? `湲곗? 援ъ“/src/QueryEngine.ts`, `湲곗? 援ъ“/src/query.ts`, `湲곗? 援ъ“/src/utils/messageQueueManager.ts`
     - AX ?곸슜 ?꾩튂: `AgentLoopService.cs`, `AgentLoopRunLifecycle.cs`, `AgentQueuedCommandProjector.cs`, `AgentQueryContextBuilder.cs`
     - ?꾨즺 議곌굔: `RunAsync`??bootstrap, query-view ?앹꽦, LLM ?몄텧, tool dispatch, finalize瑜????묒? helper/service濡?遺꾨━
     - ?덉쭏 ?먯젙 湲곗?: 以묐떒/?ш컻/沅뚰븳 ?뱀씤/遺꾧린/?κ린 ?몄뀡 replay ?뚯뒪???듦낵
  3. `tool_result replacement state ?κ린 ?몄뀡 怨좎젙`
     - 李몄“ ??? `湲곗? 援ъ“/src/utils/toolResultStorage.ts`
     - AX ?곸슜 ?꾩튂: `AgentMessageInvariantHelper.cs`, `AgentToolResultBudget.cs`, `ContextCondenser.cs`, `ChatStorageService.cs`
     - ?꾨즺 議곌굔: `tool_use_id` 蹂寃? compact ?댄썑, branch/replay ?곹솴?먯꽌??preview? replacement ?뺤콉???덉젙 ?좎?
     - ?덉쭏 ?먯젙 湲곗?: replay/branch ??λ낯?먯꽌 preview ?붾뱾由?0嫄?  4. `媛쒕컻?몄뼱 no-LSP fallback ?ы솕`
     - 李몄“ ??? `湲곗? 援ъ“/src/query.ts`, `湲곗? 援ъ“/src/context.ts`
     - AX ?곸슜 ?꾩튂: `CodeLanguageCatalog.cs`, `LspTool.cs`, `WorkspaceContextGenerator.cs`, `ChatWindow.SystemPromptBuilder.cs`, `SettingsWindow.xaml`
     - ?꾨즺 議곌굔: ?몄뼱蹂?`manifest/build/test/lint` ?뚰듃媛 ?ㅼ젣 fallback 遺꾩꽍怨??뚰겕?ㅽ럹?댁뒪 而⑦뀓?ㅽ듃????源딄쾶 ?곌껐
     - ?덉쭏 ?먯젙 湲곗?: 濡쒖뺄 LSP ?녿뒗 ??μ냼?먯꽌??Auto 紐⑤뱶媛 湲곕낯 ?ㅽ뻾 ?먮쫫怨??곹뼢 踰붿쐞瑜??덉젙?곸쑝濡??덈궡
  5. `紐낅졊/?ㅽ궗 ?⑹꽦 諛?由대━利?寃뚯씠??
     - 李몄“ ??? `湲곗? 援ъ“/src/commands.ts`, `湲곗? 援ъ“/src/skills/loadSkillsDir.ts`
     - AX ?곸슜 ?꾩튂: `SlashCommandCatalog.cs`, `SkillService.cs`, `README.md`, `docs/DEVELOPMENT.md`, `docs/NEXT_ROADMAP.md`
     - ?꾨즺 議곌굔: builtin/skill/plugin/workflow ?좏겙 異⑸룎???몄텧/?ㅽ뻾 ?곗꽑?쒖쐞 ?꾩쟾 ?쇱튂, 由대━利?泥댄겕由ъ뒪??理쒖떊??     - ?덉쭏 ?먯젙 湲곗?: 媛숈? ?좏겙 異⑸룎 ???붾젅???쒖떆? ?ㅼ젣 ?ㅽ뻾???꾩쟾 ?쇱튂?섍퀬, 由대━利????섎룞 ?뺤씤 ??ぉ 理쒖냼??- 理쒖쥌 寃뚯씠??
  - `dotnet build` 寃쎄퀬 0 / ?ㅻ쪟 0
  - 臾몄꽌 golden: `PPTX/XLSX/DOCX/HTML`
  - 猷⑦봽/??而⑦뀓?ㅽ듃: `以묐떒/?ш컻/沅뚰븳/branch/replay`
  - ?몄뼱 fallback: `CodeLanguageCatalogTests`, `WorkspaceContextGeneratorTests`, 愿??fallback ?뚭?

?낅뜲?댄듃: 2026-04-15 10:24 (KST)
- 臾몄꽌 critic ?몃???
  - `ArtifactQualityReviewService.cs`
    - HTML: `board_report`??`decision_summary` ?꾨씫 ??蹂꾨룄 寃쎄퀬, `strategy_brief`??explicit decision block ?꾨씫 ??蹂꾨룄 寃쎄퀬
    - HTML ?덉쭏 怨꾩궛 ??`h2`留뚯씠 ?꾨땲??`board_report`, `strategy_brief`, `comparison`, `roadmap`, `decision_summary`, `evidence_cards`, `kpi`瑜?`major section`/`supporting block` 異붿젙??諛섏쁺
    - DOCX: ?λЦ 鍮꾩쫰?덉뒪 臾몄꽌?먯꽌 evidence table, callout/highlight 遺議깆쓣 蹂꾨룄 ?댁뒋濡??먯젙
    - XLSX: dashboard workbook??`trend_series`, `variance_series`, `sheet_summaries`, `dashboard_tiles` 遺?щ? 媛곴컖 異붽? 吏꾨떒
- 蹂댁젙 媛?대뱶 媛뺥솕:
  - `ArtifactRepairGuideService.cs`
    - HTML: board decision summary, strategy brief decision block, comparison/roadmap, evidence-card 蹂닿컯 媛?대뱶 異붽?
    - DOCX: evidence table, callout/highlight 蹂닿컯 媛?대뱶 異붽?
    - XLSX: trend/variance framing, supporting sheet summary, headline tile, follow-up action 蹂닿컯 媛?대뱶 異붽?
  - `DeckRepairGuideService.cs`
    - Executive Summary??decision ask, recommendation slide??rationale/next steps ?꾨씫??蹂꾨룄 ?≪뀡?쇰줈 蹂??- Workbook review ?낅젰 ?뺤옣:
  - `WorkbookReviewInput`??`HasTrendSection`, `HasVarianceSection`, `HasDashboardTileSection` 異붽?
  - `ExcelSkill.cs`??single-summary/multi-sheet review 寃쎈줈媛 ???좏샇瑜??ㅼ젣 review???꾨떖
- Deck ?덉쭏 湲곗? 媛뺥솕:
  - `DeckQualityReviewService.cs`
    - Executive Summary ??recommendation/decision ask ?꾨씫 媛먯?
    - Recommendation slide??rationale/next steps ?꾨씫 媛먯?
    - Roadmap slide媛 1媛?phase留?媛吏?寃쎌슦 寃쎄퀬
- Golden/?뚭? ?뚯뒪???뺤옣:
  - `HtmlSkillGoldenReportTests.cs`: `strategy-golden.html` 異붽?
  - `PptxSkillGoldenDeckTests.cs`: `pmo-golden.pptx` 異붽?
  - `ArtifactQualityReviewServiceTests.cs`, `ArtifactRepairGuideServiceTests.cs`, `DeckQualityReviewServiceTests.cs`, `DeckRepairGuideServiceTests.cs` ?뚭? ?뺤옣
- 寃利?
  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_doc_finish_batch\\ -p:IntermediateOutputPath=obj\\verify_doc_finish_batch\\`
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ArtifactQualityReviewServiceTests|ArtifactRepairGuideServiceTests|DeckQualityReviewServiceTests|DeckRepairGuideServiceTests|HtmlSkillGoldenReportTests|PptxSkillGoldenDeckTests|DocxSkillGoldenDocumentTests|ExcelSkillGoldenWorkbookTests" -p:OutputPath=bin\\verify_doc_finish_batch_tests\\ -p:IntermediateOutputPath=obj\\verify_doc_finish_batch_tests\\`

?낅뜲?댄듃: 2026-04-15 10:50 (KST)
- 媛쒕컻?몄뼱 fallback ?ы솕:
  - `CodeLanguageCatalog.cs`
    - ?뚯씪??UTF-8 湲곗??쇰줈 ?ъ젙由ы븯怨?以묐났 `BuildFallbackSupportDescription()`???쒓굅
    - `BuildWorkspaceWorkflowSummaries()` 異붽?
    - ?? quick select key, ?뺤옣?? ?뚯씪 寃쎈줈瑜?紐⑤몢 諛쏆븘 capability濡??뺢퇋?뷀븯??`ResolveCapabilityFromKeyOrExtension()` 異붽?
  - `WorkspaceContextGenerator.cs`
    - `DetectLanguageWorkflowHints()` 異붽?
    - `.ax-context.md`??`Language Workflow` ?앹꽦??移댄깉濡쒓렇 怨듭슜 API瑜??ъ슜?섎룄濡??뺣━
  - `ChatWindow.SystemPromptBuilder.cs`
    - 肄붾뱶 ?쒖뒪???꾨＼?꾪듃??`## Repository Language Workflow` ?뱀뀡 二쇱엯
    - no-LSP ??μ냼?먯꽌???ㅼ젣 manifest/build/test/lint ?뚰듃瑜?prompt ?덉뿉??吏곸젒 ?쒖슜
- ?먯씠?꾪떛 猷⑦봽 遺꾨━:
  - ??`AgentLoopLlmRequestPreparationService.cs`
    - 珥덇린 tool-call 媛뺤젣 ?щ? 怨꾩궛
    - pre-call tool reminder ?쎌엯 ?щ? 怨꾩궛
    - ?ㅼ젣 LLM ?꾩넚??`sendMessages` 諛곗뿴 議곕┰
  - `AgentLoopService.cs`
    - LLM ?붿껌 ??硫붿떆吏 議곕┰ 梨낆엫??helper ?몄텧濡??泥댄빐 orchestration 吏묒쨷???μ긽
- ?뚯뒪??蹂닿컯:
  - ??`AgentLoopLlmRequestPreparationServiceTests.cs`
  - `CodeLanguageCatalogTests.cs`: fallback summary, workflow summary, workspace workflow dedupe/?곗꽑?쒖쐞 寃利?  - `WorkspaceContextGeneratorTests.cs`: preferred language ?곗꽑 `Language Workflow` ?뚰듃 寃利?- 寃利?
  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_final_batch\\ -p:IntermediateOutputPath=obj\\verify_final_batch\\` 寃쎄퀬 0 / ?ㅻ쪟 0
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "CodeLanguageCatalogTests|WorkspaceContextGeneratorTests|AgentLoopLlmRequestPreparationServiceTests|AgentLoopIterationPreparationServiceTests|AgentMessageInvariantHelperTests|AgentToolResultBudgetTests|ChatStorageServiceTests|HtmlSkillGoldenReportTests|PptxSkillGoldenDeckTests|DocxSkillGoldenDocumentTests|ExcelSkillGoldenWorkbookTests" -p:OutputPath=bin\\verify_final_batch_tests\\ -p:IntermediateOutputPath=obj\\verify_final_batch_tests\\` ?듦낵 54

?낅뜲?댄듃: 2026-04-15 11:17 (KST)
- SQL ?꾩슜 fallback 遺꾩꽍 異붽?:
  - ??`SqlDialectDetector.cs`
    - PostgreSQL / MySQL / SQL Server / SQLite / Oracle 諛⑹뼵 ?대━?ㅽ떛 媛먯?
  - ??`SqlAnalysisService.cs`
    - statement kind 遺꾨쪟: `CREATE TABLE`, `ALTER TABLE`, `DROP TABLE`, `TRUNCATE TABLE`, `CREATE INDEX`, `CREATE VIEW`, `CREATE FUNCTION`, `CREATE PROCEDURE`, `INSERT`, `UPDATE`, `DELETE`, `MERGE`, `SELECT`
    - object 異붿텧: table/view/update/insert/delete/from/join 湲곕컲 ?곸쐞 object ?섏쭛
    - ?꾪뿕 媛먯?: `DROP`, `TRUNCATE`, `ALTER TABLE DROP COLUMN`, `DELETE/UPDATE without WHERE`, `SELECT *`, transaction boundary 遺??    - SQL ?꾩슜 fallback summary ?앹꽦
- 媛쒕컻?몄뼱 移댄깉濡쒓렇 ?뺤옣:
  - `CodeLanguageCatalog.cs`
    - SQL manifest ?뚰듃: `migrations/*.sql`, `schema.sql`, `seed.sql`, `*.sqlproj`
    - SQL build/test/lint ?뚰듃 媛뺥솕
    - `BuildWorkflowSummary()`??SQL ?꾩슜 `dialect/statement/risk/object dependency` 遺꾩꽍 ?붿빟 異붽?
    - `BuildFallbackSummary()`?먯꽌 SQL? ?쇰컲 fallback ???`SqlAnalysisService.BuildFallbackSummary()`瑜??ъ슜
- PPT/HTML 怨좊룄??
  - `DeckPlanningService.cs`
    - 援ъ“?붾맂 `content` ?щ씪?대뱶瑜??낅젰 ?곗씠?곗뿉 ?곕씪 `kpi_dashboard`, `comparison`, `roadmap`, `chart`濡??먮룞 ?밴꺽
  - `DeckQualityReviewService.cs`
    - Executive Summary???뺣웾 洹쇨굅 遺議? comparison verdict 遺?? roadmap owner/timeline 遺議? KPI dashboard metric/takeaway 遺議?吏꾨떒 異붽?
  - `DeckRepairGuideService.cs`
    - ??PPT 吏꾨떒 ??ぉ???ㅼ젣 蹂댁젙 ?≪뀡?쇰줈 留ㅽ븨
  - `HtmlSkill.cs`
    - ??`kpi_panel` ?뱀뀡 ???異붽?
  - `ArtifactQualityReviewService.cs`
    - KPI panel??major/supporting block ?먮떒??諛섏쁺
    - board/strategy 臾몄꽌?먯꽌 KPI/evidence/decision ?곌껐 遺議??댁뒋 異붽?
  - `ArtifactRepairGuideService.cs`
    - KPI panel/metric strip, evidence support, decision/next-step ?곌껐 蹂댁젙 媛?대뱶 異붽?
- ?뚯뒪??
  - ??`SqlDialectDetectorTests.cs`
  - ??`SqlAnalysisServiceTests.cs`
  - `CodeLanguageCatalogTests.cs`
  - `DeckPlanningServiceTests.cs`
  - `ArtifactQualityReviewServiceTests.cs`
  - `ArtifactRepairGuideServiceTests.cs`
  - `HtmlSkillConsultingSectionsTests.cs`
- 寃利?
  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_sql_doc_batch\\ -p:IntermediateOutputPath=obj\\verify_sql_doc_batch\\` 寃쎄퀬 0 / ?ㅻ쪟 0
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "SqlDialectDetectorTests|SqlAnalysisServiceTests|CodeLanguageCatalogTests|DeckPlanningServiceTests|DeckQualityReviewServiceTests|ArtifactQualityReviewServiceTests|ArtifactRepairGuideServiceTests|HtmlSkillConsultingSectionsTests|HtmlSkillGoldenReportTests|PptxSkillGoldenDeckTests" -p:OutputPath=bin\\verify_sql_doc_batch_tests\\ -p:IntermediateOutputPath=obj\\verify_sql_doc_batch_tests\\` ?듦낵 47

?낅뜲?댄듃: 2026-04-15 11:36 (KST)

### SQL fallback 遺꾩꽍 ?ы솕
- `SqlAnalysisService.cs`
  - `SqlAnalysisReport`??`ScriptIntent`, `Dependencies`, `ReviewNotes`瑜?異붽??덉뒿?덈떎.
  - `Analyze()`媛 dialect/statement/risk/object ?몄뿉 `schema migration`, `schema change`, `seed / reference data`, `query / reporting` intent瑜?怨꾩궛?⑸땲??
  - dependency 媛먯???script媛 吏곸젒 ?앹꽦/?섏젙?섎뒗 owned object? 李몄“ dependency瑜?遺꾨━?? view/reporting query媛 ?섏〈?섎뒗 ?뚯씠釉붽낵 lookup source瑜?蹂꾨룄濡??≪뒿?덈떎.
  - review note??rollback, dependency impact, transaction scope, dialect-specific validation ?ъ씤?몃? ?④퍡 ?앹꽦?⑸땲??
  - fallback summary??`script`, `dependencies`, `review focus`源뚯? ?ы븿?섎룄濡??뺤옣?덉뒿?덈떎.
- `CodeLanguageCatalog.cs`
  - SQL workflow summary瑜?`dialect/statement/risk/object dependency` ?섏??먯꽌 `script intent/migration order/dependency`源뚯? 蹂댁씠?꾨줉 媛뺥솕?덉뒿?덈떎.
- `WorkspaceContextGenerator.cs`
  - SQL ??μ냼?먯꽌 `## SQL Review Focus` ?뱀뀡???앹꽦?섎룄濡??뺤옣?덉뒿?덈떎.
  - migration/seed/reporting query 遺꾨쪟, destructive DDL쨌broad DML쨌transaction scope쨌rollback ?먭???臾몃㎘??吏곸젒 ?ｌ뒿?덈떎.

### HTML ?섏궗寃곗젙??臾몄꽌 媛뺥솕
- `HtmlSkill.cs`
  - ???뱀뀡 ???`decision_matrix`, `metric_strip`瑜?異붽??덉뒿?덈떎.
  - `decision_matrix`??option/criteria/verdict/notes瑜????쒕줈 ?뚮뜑留곹빀?덈떎.
  - `metric_strip`? KPI headline, trend, note瑜?媛濡?移대뱶???붿빟?쇰줈 ?뚮뜑留곹빀?덈떎.
- `ArtifactQualityReviewService.cs`
  - HTML ?덉쭏 ?됯???`decision_matrix`, `metric_strip` 議댁옱瑜?諛섏쁺?⑸땲??
  - board report?먯꽌 comparison/decision matrix 遺?? strategy brief?먯꽌 trade-off matrix 遺?? metric strip??recommendation怨??곌껐?섏? ?딅뒗 寃쎌슦瑜?蹂꾨룄 ?댁뒋濡??먯젙?⑸땲??
- `ArtifactRepairGuideService.cs`
  - decision matrix 異붽?, comparison/decision block 蹂닿컯, metric strip??recommendation/board summary? ?곌껐?섎뒗 ?섎━ 媛?대뱶瑜?異붽??덉뒿?덈떎.
  - HTML repair action ?곹븳??4媛쒕줈 ?볧? ?덉쭏 ?쇰뱶諛??먯떎??以꾩??듬땲??

### PPT ?щ씪?대뱶 ?덉쭏 critic ?몃텇??- `DeckQualityReviewService.cs`
  - Executive Summary??headline ?좊챸??遺議깆쓣 ???꾧꺽??媛먯??⑸땲??
  - Comparison slide??trade-off ?ㅻ챸 遺議? roadmap phase milestone 遺議? chart takeaway 遺?? KPI dashboard trend/note context 遺議깆쓣 蹂꾨룄 寃쎄퀬濡??먯젙?⑸땲??
  - executive/recommendation/comparison(or chart)/roadmap媛 媛뽰떠吏?deck??`decision-ready consulting storyline` 媛뺤젏 ?좏샇瑜?異붽??덉뒿?덈떎.
- `DeckRepairGuideService.cs`
  - ??異붽? ?댁뒋瑜?媛곴컖 headline ?뺤텞, trade-off 蹂닿컯, phase milestone 紐낆떆, chart takeaway 異붽?, KPI trend/note 蹂닿컯 ?≪뀡?쇰줈 蹂?섑빀?덈떎.

### ?뚯뒪??- `SqlAnalysisServiceTests.cs`
  - migration intent/dependency/rollback note 寃利?異붽?
  - seed/reference data intent, transaction risk, lookup dependency 寃利?異붽?
- `CodeLanguageCatalogTests.cs`
  - SQL workflow summary??`migration order`, `dependencies`媛 ?ы븿?섎뒗吏 寃利?- `WorkspaceContextGeneratorTests.cs`
  - SQL ??μ냼?먯꽌 `## SQL Review Focus` ?뱀뀡 ?앹꽦 寃利?- `HtmlSkillConsultingSectionsTests.cs`
  - `decision_matrix`, `metric_strip` ?뚮뜑留??뚭? 異붽?
- `ArtifactQualityReviewServiceTests.cs`
  - decision matrix瑜?媛뺤젏?쇰줈 ?몄떇?섍퀬, trade-off view 遺????蹂꾨룄 寃쎄퀬瑜?諛섑솚?섎뒗吏 寃利?- `ArtifactRepairGuideServiceTests.cs`
  - HTML repair guide??decision matrix 蹂닿컯 ?≪뀡???ы븿?섎뒗吏 寃利?- `DeckQualityReviewServiceTests.cs`
  - headline/trade-off/KPI context 異붽? 寃쎄퀬 ?뚭? 寃利?
### 寃利?- `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_code_sql_doc\\ -p:IntermediateOutputPath=obj\\verify_code_sql_doc\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "SqlDialectDetectorTests|SqlAnalysisServiceTests|CodeLanguageCatalogTests|WorkspaceContextGeneratorTests|ArtifactQualityReviewServiceTests|ArtifactRepairGuideServiceTests|DeckQualityReviewServiceTests|HtmlSkillConsultingSectionsTests" -p:OutputPath=bin\\verify_code_sql_doc_tests\\ -p:IntermediateOutputPath=obj\\verify_code_sql_doc_tests\\` ?듦낵 62

?낅뜲?댄듃: 2026-04-15 11:50 (KST)

### SQL review 怨꾩링 異붽?
- ??`SqlReviewService.cs`
  - `SqlReviewResult`瑜??꾩엯??`review severity`, `key findings`, `review checklist`瑜?援ъ“?뷀뻽?듬땲??
  - schema migration/schema change??migration sequencing, dependent object readiness瑜??곗꽑 泥댄겕?⑸땲??
  - seed/reference data??rerun safety? idempotent upsert 愿?먯쓣 蹂꾨룄 泥댄겕?⑸땲??
  - query/reporting SQL? join width? downstream consumer ?곹뼢 寃???ъ씤?몃? 異붽??⑸땲??
  - destructive DDL, broad DML, unclear transaction scope, wildcard projection??findings/checklist濡?蹂?섑빀?덈떎.
- `SqlAnalysisService.cs`
  - `BuildFallbackSummary()`媛 `SqlReviewService.Review(report)` 寃곌낵瑜??댁뼱遺숈뿬 SQL fallback??`analysis + review` 2??援ъ“濡?諛섑솚?섎룄濡?蹂寃쏀뻽?듬땲??
- `CodeLanguageCatalog.cs`
  - SQL workflow summary??`review: confirm rollback notes, dependency order, and row-count guards before apply` ?뚰듃瑜?異붽??덉뒿?덈떎.

### AgentLoop ?묐떟 遺꾪빐 helper 異붽?
- ??`AgentLoopResponseClassificationService.cs`
  - LLM ?묐떟 釉붾줉??`TextResponse`, `TextParts`, `ToolCalls`, `NextConsecutiveNoToolResponses`濡?遺꾨쪟?⑸땲??
  - `BuildThinkingSummary()`瑜??쒓났??thinking preview 湲몄씠 ?쒗븳??helper?먯꽌 泥섎━?⑸땲??
- `AgentLoopService.cs`
  - ?섎룞 `text/tool_use` 遺꾨━ 猷⑦봽瑜??쒓굅?섍퀬 `AgentLoopResponseClassificationService.Classify()`瑜??ъ슜?섎룄濡??뺣━?덉뒿?덈떎.
  - no-tool ?묐떟 ?꾩쟻 移댁슫?몄? thinking summary ?앹꽦 梨낆엫??helper ?몄텧濡??泥댄뻽?듬땲??

### ?뚯뒪??- ??`SqlReviewServiceTests.cs`
  - destructive migration? `high` severity? rollback checklist瑜?諛섑솚?섎뒗吏 寃利?  - seed/reference data??idempotency? rerun safety 泥댄겕由ъ뒪?몃? 諛섑솚?섎뒗吏 寃利?- ??`AgentLoopResponseClassificationServiceTests.cs`
  - text/tool_use 遺꾨━? no-tool counter reset/increment ?숈옉 寃利?- 湲곗〈 `SqlAnalysisServiceTests.cs`, `CodeLanguageCatalogTests.cs`
  - SQL fallback summary??`review severity`, `review checklist`, rollback review ?뚰듃媛 ?ㅼ뼱媛?붿? ?뚭? 寃利?
### 寃利?- `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_loop_sql_finalize\\ -p:IntermediateOutputPath=obj\\verify_loop_sql_finalize\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentLoopResponseClassificationServiceTests|AgentLoopLlmRequestPreparationServiceTests|AgentLoopIterationPreparationServiceTests|SqlAnalysisServiceTests|SqlReviewServiceTests|CodeLanguageCatalogTests|WorkspaceContextGeneratorTests" -p:OutputPath=bin\\verify_loop_sql_finalize_tests\\ -p:IntermediateOutputPath=obj\\verify_loop_sql_finalize_tests\\` ?듦낵 48

?낅뜲?댄듃: 2026-04-15 14:00 (KST)

### Code ??鍮??묒뾽 ?대뜑 ?앹꽦 踰꾧렇 蹂닿컯
- ??`AgentLoopCodeRuntimeGuards.cs`
  - `skill_manager`, `mcp_list_resources`, `mcp_read_resource`瑜?Code 湲곕낯 ?고????꾧뎄 ?몄텧?먯꽌 ?쒖쇅?섎뒗 `ApplyCodeDefaultMetaToolFilter()`瑜?異붽??덉뒿?덈떎.
  - 鍮??묒뾽 ?대뜑?먯꽌 `folder_map`, `glob`, `grep`, `code_search`, `file_read`, `env_tool`, `skill_manager`, `mcp_*` ?꾧뎄濡??고쉶 ?먯깋???쒕룄?섎㈃ `TryHandleEmptyWorkspaceFallbackTransition()`??李⑤떒?섍퀬, `file_write` 吏곸젒 ?앹꽦 蹂듦뎄 ?꾨＼?꾪듃瑜?二쇱엯?섎룄濡?留뚮뱾?덉뒿?덈떎.
  - ?곷? 寃쎈줈 `.`???묒뾽 ?대뜑 湲곗??쇰줈 ?댁꽍???몃? 猷⑦듃 ?먯깋怨?detour瑜?援щ텇?섎룄濡?`IsExternalWorkspaceEscalationTarget()`瑜?蹂댁젙?덉뒿?덈떎.
  - direct-creation ?붿껌?대㈃???묒뾽 ?대뜑媛 鍮꾩뼱 ?덉쑝硫??쒖옉 ?쒖젏??怨㏓컮濡?`file_write` ?앹꽦 ?곗꽑 媛?대뱶瑜?二쇱엯?섎뒗 `InjectInitialEmptyWorkspaceCreationGuidance()`瑜?異붽??덉뒿?덈떎.

### AgentLoop / Code ?꾨＼?꾪듃 ?곕룞
- `AgentLoopService.cs`
  - `BuildContext()` 吏곹썑 `DetectEmptyWorkspace(context.WorkFolder)`濡?鍮??묒뾽 ?대뜑瑜?媛먯???`runState.WorkspaceAppearsEmpty`??諛섏쁺?⑸땲??
  - `GetRuntimeActiveTools()`?먯꽌 `ApplyCodeDefaultMetaToolFilter()`瑜??ㅼ젣 ?고????꾧뎄 紐⑸줉???곸슜?⑸땲??
  - ?꾧뎄 ?ㅽ뻾 吏곸쟾 `TryHandleEmptyWorkspaceFallbackTransition()`???몄텧???몃? 猷⑦듃 fallback怨?硫뷀? ?꾧뎄 detour瑜?留됱뒿?덈떎.
  - direct-creation ?곹깭 硫붿떆吏??Code ??뿉??`利됱떆 ?앹꽦 紐⑤뱶 쨌 諛붾줈 ?뚯씪??留뚮뱶??以??쇰줈 遺꾨━???ъ슜?먯뿉寃??꾩옱 ?섎룄瑜????뺥솗??蹂댁씠?꾨줉 ?뺣━?덉뒿?덈떎.
- `ChatWindow.SystemPromptBuilder.cs`
  - Code/Cowork ?꾨＼?꾪듃??`鍮??묒뾽 ?대뜑 + ???뚯씪/?뱁럹?댁?/scaffold ?앹꽦 ?붿껌`?대㈃ broad exploration ?놁씠 `file_write`瑜?諛붾줈 ?몄텧?섎씪??洹쒖튃??異붽??덉뒿?덈떎.
  - Code ?쇰컲 ?묒뾽?먯꽌 `skill_manager`, `mcp_list_resources`, `mcp_read_resource`瑜??곗? 留먮씪??洹쒖튃???④퍡 異붽??덉뒿?덈떎.

### Tool-call ?뺥빀??蹂듦뎄
- `AgentLoopResponseClassificationService.cs`
  - ?띿뒪??釉붾줉 ?덉뿉 `<tool_call>{...}</tool_call>` ?뺥깭濡??욎뿬 ?ㅼ뼱???몄텧??`LlmService.TryExtractToolCallsFromText()`濡?蹂듦뎄?섎룄濡??뺤옣?덉뒿?덈떎.
  - `LlmService.StripToolCallTokens()`濡??⑥? ?띿뒪?몃뒗 thinking/assistant ?붿빟?먮쭔 ?④린怨??ㅼ젣 ?꾧뎄 ?몄텧? ?ㅽ뻾 寃쎈줈濡??섍퉩?덈떎.
  - ??蹂닿컯?쇰줈 `file_write`媛 ?ㅽ듃由щ컢 以??띿뒪?몄뿉 臾삵? ?좎떎?섎뒗 耳?댁뒪瑜?以꾩??듬땲??

### ?뚯뒪??- `AgentLoopE2ETests.cs`
  - `RunAsync_EmptyWorkspace_BlocksExternalFallbackAndRecoversToFileWrite()`
  - `RunAsync_EmptyWorkspace_DisallowsSkillManagerAndRecoversToFileWrite()`
  - `RunAsync_TextEmbeddedToolCall_RecoversAndExecutesFileWrite()`
  - E2E helper `BuildLoopSettings()`??ambient project/plugin/MCP skill discovery瑜?爰쇱꽌 ?꾩옱 ??μ냼 ?ㅽ궗 ?곹깭???곹뼢諛쏆? ?딅룄濡?寃⑸━?덉뒿?덈떎.
- `AgentLoopResponseClassificationServiceTests.cs`
  - `Classify_ShouldRecoverToolCallEmbeddedInText()` 異붽?

### 寃利?- `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_empty_workspace_fix2\\ -p:IntermediateOutputPath=obj\\verify_empty_workspace_fix2\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "FullyQualifiedName~RunAsync_EmptyWorkspace_BlocksExternalFallbackAndRecoversToFileWrite|FullyQualifiedName~RunAsync_EmptyWorkspace_DisallowsSkillManagerAndRecoversToFileWrite|FullyQualifiedName~RunAsync_TextEmbeddedToolCall_RecoversAndExecutesFileWrite|FullyQualifiedName~Classify_ShouldRecoverToolCallEmbeddedInText" -p:OutputPath=bin\\verify_empty_workspace_fix2_tests\\ -p:IntermediateOutputPath=obj\\verify_empty_workspace_fix2_tests\\` ?듦낵 4

?낅뜲?댄듃: 2026-04-15 14:18 (KST)

### AgentLoop ???뺤콉 / broader E2E ?뺥빀???섏젙
- `AgentLoopE2ETests.cs`
  - `RunAsync_ExecutesToolCall_AndCompletesWithFinalText()`
  - `RunAsync_UnknownTool_RecoversAndCompletes()`
  - `RunAsync_PlanModeAlways_EmitsPlanningThenExecutesTool()`
  - `RunAsync_PreHookInputMutation_ChangesToolArguments()`
  - ??4媛??쒕굹由ъ삤??`ActiveTab`??`Chat`?먯꽌 `Cowork`濡??뺣━?덉뒿?덈떎.
  - 洹쇨굅: [AgentToolCatalog.cs](/E:/AX%20Copilot%20-%20Codex/src/AxCopilot/Services/Agent/AgentToolCatalog.cs) 湲곗? `math_eval`? `Cowork,Code` ?꾧뎄?대ŉ Chat 湲곕낯 ?몄텧 ??곸씠 ?꾨떃?덈떎. 湲곗〈 broader E2E ?ㅽ뙣???고????뺤콉 ?꾩닔?쇨린蹂대떎 ?뚯뒪?멸? ?꾪뻾 ???뺤콉蹂대떎 ?ㅻ옒??媛?뺤쓣 ?좎????곹뼢?댁뿀?듬땲??

### no-tool ?곹깭 硫붿떆吏 遺꾧린 蹂닿컯
- `AgentLoopService.cs`
  - `activeTools.Count == 0`???뚯쓽 ?ㅻ쪟 諛섑솚??2媛덈옒濡?遺꾨━?덉뒿?덈떎.
  - ?ㅼ젣 `runtimeOverrides.AllowedToolNames`媛 ?덉쓣 ?뚮쭔 湲곗〈 `?꾩옱 ?ㅽ궗 ?뺤콉?먯꽌 ?덉슜???꾧뎄媛 ?놁뼱...` 臾멸뎄瑜??좎??⑸땲??
  - 洹??몄뿉??`?꾩옱 {?? ??뿉???ъ슜 媛?ν븳 ?꾧뎄媛 ?놁뼱...` ?뺤떇????湲곗? 硫붿떆吏瑜?諛섑솚???먯씤 ?덈궡媛 ?ㅽ빐瑜?遺瑜댁? ?딅룄濡??뺣━?덉뒿?덈떎.

### 寃利?- `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_runtime_policy_alignment_build\\ -p:IntermediateOutputPath=obj\\verify_runtime_policy_alignment_build\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentLoopE2ETests|AgentLoopResponseClassificationServiceTests" -p:OutputPath=bin\\verify_runtime_policy_alignment\\ -p:IntermediateOutputPath=obj\\verify_runtime_policy_alignment\\` ?듦낵 19
?낅뜲?댄듃: 2026-04-15 15:09 (KST)
- `src/AxCopilot/Views/ChatWindow.xaml.cs`???묒뾽 ?대뜑 諛섏쁺 寃쎈줈瑜?蹂닿컯?덉뒿?덈떎. `SetWorkFolder(...)`媛 ?댁젣 Code/Cowork ??뿉???꾩옱 ??붽? ?녿뜑?쇰룄 `EnsureCurrentConversation(...)`?쇰줈 ??붾? 利됱떆 ?뺣낫????`WorkFolder`瑜?湲곕줉?? ?대뜑 ?좏깮 吏곹썑 鍮좊Ⅸ ?꾩넚?먯꽌?????硫뷀??곗씠?곌? 鍮꾩뼱 ?덉? ?딄쾶 ?좎??⑸땲??
- `GetCurrentWorkFolder()`???꾩뿭 `Llm.WorkFolder`蹂대떎 ??퀎 `CodeWorkFolder`/`CoworkWorkFolder`瑜?癒쇱? ?쎈룄濡?諛붽엥?듬땲?? ?대뜑 諛붋룹썙?곕쭏??룹뒪??濡쒕뜑媛 蹂대뒗 寃쎈줈? ?ㅼ젣 ??퀎 ???寃쎈줈瑜?????留욎떠 UI fallback怨??ㅽ뻾 寃쎈줈媛 ?닿툔?섎뒗 ?곹솴??以꾩??듬땲??
- `BtnFolderClear_Click(...)`????붿쓽 `WorkFolder`留?鍮꾩슦??湲곗〈 ?숈옉?먯꽌 ?뺤옣????퀎 理쒓렐 ?묒뾽 ?대뜑 ?ㅼ젙怨?UI ?곹깭???④퍡 珥덇린?뷀빀?덈떎. ?댁쟾 寃쎈줈媛 ?ㅼ젙 fallback?쇰줈 ?ㅼ떆 ?섑??섎뒗 ?꾩긽??以꾩씠怨? ?댄썑 ?ㅽ궗 ?щ줈?쒕룄 媛숈? 湲곗??쇰줈 ?ㅼ떆 ?쒖옉?⑸땲??
- `src/AxCopilot/Services/ChatSessionStateService.cs`??`CreateFreshConversation(...)`??Code/Cowork ????????앹꽦 ????퀎 理쒓렐 ?묒뾽 ?대뜑瑜?湲곕낯 `WorkFolder`濡??밴퀎?⑸땲?? ?대줈???쏹I?먮뒗 ?대뜑媛 蹂댁씠?붾뜲 ?꾩넚 李⑤떒? 寃쎈줈 ?놁쓬?쇰줈 ?먮떒?앺븯??遺덉씪移섎? ?꾪솕?⑸땲??
- ?뚯뒪?? `src/AxCopilot.Tests/Services/ChatSessionStateServiceTests.cs`?먯꽌 fresh conversation 湲곕낯 ?대뜑 ?밴퀎? ??퀎 ?곗꽑?쒖쐞瑜?寃利앺븯?꾨줉 ?뺤옣
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_workfolder_sync\\ -p:IntermediateOutputPath=obj\\verify_workfolder_sync\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatSessionStateServiceTests" -p:OutputPath=bin\\verify_workfolder_sync_tests\\ -p:IntermediateOutputPath=obj\\verify_workfolder_sync_tests\\` ?듦낵 37
?낅뜲?댄듃: 2026-04-15 15:18 (KST)
- `src/AxCopilot/Models/AppSettings.cs`??`LlmSettings.MaxContextTokens` 湲곕낯媛믪쓣 `32_768`濡?議곗젙?덉뒿?덈떎. ?댁젣 ?좉퇋 ?ㅼ튂, ?좉퇋 ?몄뀡, 珥덇린???댄썑??肄붿썙??肄붾뱶 ?대??ㅼ젙? 32K 而⑦뀓?ㅽ듃 湲곗??쇰줈 ?쒖옉?⑸땲??
- `src/AxCopilot/Views/SettingsWindow.xaml`怨?`src/AxCopilot/Views/SettingsWindow.xaml.cs`?먮뒗 `32K` 而⑦뀓?ㅽ듃 移대뱶? ?좏깮 濡쒖쭅??異붽??덉뒿?덈떎. 湲곗〈 4K/16K/64K ?ъ씠??媛꾧꺽 ?뚮Ц??32K 湲곕낯媛믪씠 64K泥섎읆 蹂댁씠??遺덉씪移섎? ?쒓굅?⑸땲??
- `src/AxCopilot/Views/AgentSettingsWindow.xaml.cs`??`TxtMaxContextTokens` ?뚯떛 ?ㅽ뙣 ??fallback 媛믪쓣 4096?먯꽌 32768濡?蹂寃쏀뻽?듬땲?? ?대? ?ㅼ젙 李쎌뿉???섎せ???낅젰????ν븯?붾씪??湲곕낯 而⑦뀓?ㅽ듃媛 ?ㅼ떆 4K濡??대젮媛吏 ?딆뒿?덈떎.
- ?뚯뒪?? `src/AxCopilot.Tests/Services/SettingsServiceTests.cs`??`LlmSettings_DefaultMaxContextTokens_IsThirtyTwoK` 異붽?
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_context32k\\ -p:IntermediateOutputPath=obj\\verify_context32k\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "SettingsServiceTests" -p:OutputPath=bin\\verify_context32k_tests\\ -p:IntermediateOutputPath=obj\\verify_context32k_tests\\` ?듦낵 32

?낅뜲?댄듃: 2026-04-15 14:55 (KST)

### Code ??LLM ?湲?heartbeat 吏꾨떒 蹂닿컯
- `src/AxCopilot/Services/Agent/StreamingToolExecutionCoordinator.cs`
  - 泥??묐떟 ??`LLM ?붿껌 ?쒖옉`, 泥??묐떟 ?섏떊 ?쒖젏, ?댄썑 ?μ떆媛??湲?援ш컙??`[AgentLoopWait]` 濡쒓렇濡??④린?꾨줉 蹂닿컯?덉뒿?덈떎.
  - `onStreamEventAsync`媛 ?덈뒗 ?ㅽ듃由щ컢 寃쎈줈?먯꽌 泥??대깽?멸? ??쾶 ?ㅻ㈃ `硫붿씤 猷⑦봽 N: 紐⑤뜽 泥??묐떟??湲곕떎由щ뒗 以묒엯?덈떎... (n珥?` heartbeat瑜?二쇨린?곸쑝濡?`Thinking` ?대깽?몃줈 諛쒗뻾?⑸땲??
  - 泥??대깽?멸? ??쾶 ?꾩갑??寃쎌슦 `硫붿씤 猷⑦봽 N: 紐⑤뜽 泥??묐떟??諛쏆븘 怨꾩냽 吏꾪뻾?⑸땲??`瑜???踰???湲곕줉?? ?ㅼ튂蹂?濡쒓렇? UI 吏꾪뻾 ?대젰留뚯쑝濡쒕룄 ?쒖븘??硫덉땄?앷낵 ?쒖쓳???湲겸앸? 援щ텇?????덇쾶 ?덉뒿?덈떎.
  - 鍮좊Ⅸ ?묐떟?먯꽌??waiting heartbeat瑜??④린吏 ?딅룄濡?湲곕낯 heartbeat 吏?곌컪???먭퀬, ?뚯뒪?몄뿉?쒕뒗 吏㏃? 吏?곌컪?쇰줈留??숈옉??寃利앺빀?덈떎.

### ?뚯뒪??- ??`src/AxCopilot.Tests/Services/StreamingToolExecutionCoordinatorTests.cs`
  - ?먮┛ 泥??묐떟????waiting heartbeat? first-response recovery 硫붿떆吏媛 ?섏삤?붿? 寃利?  - 鍮좊Ⅸ 泥??묐떟?먯꽌???湲?heartbeat媛 諛쒖깮?섏? ?딅뒗吏 寃利?
### 寃利?- `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_llm_wait_diag\\ -p:IntermediateOutputPath=obj\\verify_llm_wait_diag\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "StreamingToolExecutionCoordinatorTests|AgentLoopLlmRequestPreparationServiceTests|AgentLoopIterationPreparationServiceTests" -p:OutputPath=bin\\verify_llm_wait_diag_tests\\ -p:IntermediateOutputPath=obj\\verify_llm_wait_diag_tests\\` ?듦낵 6

?낅뜲?댄듃: 2026-04-15 15:27 (KST)

### Cowork/Code ?쇱씠釉?移대뱶 ?쒖옉 寃쎈줈 蹂듦뎄
- `src/AxCopilot/Views/ChatWindow.xaml.cs`
  - `StartLiveAgentProgressHints()`媛 Cowork/Code ?ㅽ뻾 ?쒖옉 ??`ShowAgentLiveCard(runTab)`瑜??ㅼ떆 ?몄텧?섎룄濡?蹂듦뎄?덉뒿?덈떎.
  - 硫붿씤 猷⑦봽2 ?댄썑 ?곹깭 ?뚰듃/?섎떒 諛붾쭔 ?쒖옉?섍퀬, 梨꾪똿李?諛붾줈 ???쇱씠釉?移대뱶 而⑦뀒?대꼫瑜?留뚮뱾吏 ?딅뜕 ?뚭?瑜??섏젙??寃껋엯?덈떎.
  - 鍮꾨?????Chat ?? ?ㅽ뻾 ?쒖옉 ?쒖뿉??`RemoveAgentLiveCard(animated: false)`濡?湲곗〈 ?쇱씠釉?移대뱶瑜?利됱떆 ?뺣━?????꾪솚 ???붿긽???⑥? ?딄쾶 留욎톬?듬땲??

- `src/AxCopilot/Views/ChatWindow.LiveProgressPresentation.cs`
  - `IsAgentLiveCardEligibleTab(string? runTab)` ?ы띁瑜?異붽????쇱씠釉?移대뱶 ?????쓣 `Cowork`, `Code`濡?怨좎젙?덉뒿?덈떎.
  - ?쒖옉 寃쎈줈? ?뚭? ?뚯뒪?멸? 媛숈? ?먯젙?앹쓣 ?ъ슜?섎룄濡?臾띠뼱 ??議곌굔???ㅼ떆 ?닿툔?섏? ?딄쾶 ?덉뒿?덈떎.

### ?뚯뒪??- `src/AxCopilot.Tests/Views/ChatWindowSlashPolicyTests.cs`
  - `IsAgentLiveCardEligibleTab_ShouldMatchExpectedTabs()` 異붽?

### 寃利?- `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_live_card_restore\\ -p:IntermediateOutputPath=obj\\verify_live_card_restore\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatWindowSlashPolicyTests" -p:OutputPath=bin\\verify_live_card_restore_tests\\ -p:IntermediateOutputPath=obj\\verify_live_card_restore_tests\\` ?듦낵 49
?낅뜲?댄듃: 2026-04-15 15:40 (KST)
- Code ???뚰겕?ㅽ럹?댁뒪/沅뚰븳 ?뺥빀???섏젙. `src/AxCopilot/Services/Agent/AgentLoopService.cs`??`RuntimeWorkFolderOverride`瑜?異붽??? loop媛 settings??`CodeWorkFolder`蹂대떎 ?꾩옱 ??붿쓽 `WorkFolder`瑜??곗꽑 ?ъ슜?섎룄濡?諛붽엥?듬땲?? ?댁젣 UI媛 蹂댁뿬二쇰뒗 ?묒뾽 ?대뜑? ?ㅼ젣 ?꾧뎄 ?ㅽ뻾/沅뚰븳 寃??湲곗???媛숈? 寃쎈줈瑜?諛붾씪遊낅땲??
- `src/AxCopilot/Views/ChatWindow.xaml.cs`??`RunAgentLoopAsync(...)`???꾩옱 conversation??`WorkFolder`瑜??대떦 ??loop??吏곸젒 二쇱엯?섍퀬, 沅뚰븳 ?앹뾽 ?덈궡 臾멸뎄??`_currentConversation` ????ㅽ뻾 以묒씤 loop??runtime workspace override瑜??곗꽑 李몄“?⑸땲?? ?щ궡 紐⑤뱶?먯꽌??吏???뚰겕?ㅽ럹?댁뒪 ?섏쐞??臾댁듅?? ?몃? 寃쎈줈留??뱀씤 ??곸씠?쇰뒗 洹쒖튃??Code ??뿉???쇨??섍쾶 ?곸슜?⑸땲??
- `src/AxCopilot.Tests/Services/AgentLoopE2ETests.cs`????媛吏 ?뚭?瑜?異붽??덉뒿?덈떎. ????뚰겕?ㅽ럹?댁뒪媛 stale settings ?대뜑蹂대떎 ?곗꽑 ?곸슜?섎뒗吏, ?щ궡 紐⑤뱶 + BypassPermissions?먯꽌 ?뚰겕?ㅽ럹?댁뒪 ?대? ?곌린媛 ?뱀씤 ?놁씠 ?덉슜?섎뒗吏, ?몃? 寃쎈줈 ?곌린??諛섎뱶???뱀씤 肄쒕갚????붿?瑜?媛곴컖 寃利앺빀?덈떎.
- 寃利? `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_workspace_permission_fix\\ -p:IntermediateOutputPath=obj\\verify_workspace_permission_fix\\` 寃쎄퀬 0 / ?ㅻ쪟 0
- 寃利? `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "FullyQualifiedName~RunAsync_CodeRuntimeWorkspaceOverride_PrefersConversationWorkspaceOverSettingsFolder|FullyQualifiedName~RunAsync_InternalMode_BypassPermissions_AllowsWorkspaceWriteWithoutPrompt|FullyQualifiedName~RunAsync_InternalMode_BypassPermissions_RequestsApprovalForPathOutsideWorkspace|FullyQualifiedName~RunAsync_EmptyWorkspace_BlocksExternalFallbackAndRecoversToFileWrite|FullyQualifiedName~RunAsync_EmptyWorkspace_DisallowsSkillManagerAndRecoversToFileWrite|FullyQualifiedName~RunAsync_TextEmbeddedToolCall_RecoversAndExecutesFileWrite" -p:OutputPath=bin\\verify_workspace_permission_fix_tests\\ -p:IntermediateOutputPath=obj\\verify_workspace_permission_fix_tests\\` ?듦낵 6
?낅뜲?댄듃: 2026-04-15 16:30 (KST)

### 沅뚰븳 泥닿퀎 ?뺣━ 1李?- `src/AxCopilot/Services/OperationModePolicy.cs`
  - ?щ궡 紐⑤뱶?먯꽌 李⑤떒???몃? ?묎렐 湲곗???蹂닿컯?덉뒿?덈떎.
  - `open_external`? HTTP/HTTPS肉??꾨땲??`mailto:` 媛숈? ?몃? URI scheme??李⑤떒?섍퀬, `process`/`build_run`?먯꽌 ?ъ궗?⑺븷 ?ㅽ듃?뚰겕??紐낅졊 ?⑦꽩 ?먯젙 helper瑜?異붽??덉뒿?덈떎.
- `src/AxCopilot/Services/Agent/ProcessTool.cs`
  - ?щ궡 紐⑤뱶?먯꽌 `curl`, `Invoke-WebRequest` ???몃? ?ㅽ듃?뚰겕 ?묎렐 媛?μ꽦???믪? 紐낅졊? ?ㅽ뻾 ?꾩뿉 利됱떆 李⑤떒?⑸땲??
- `src/AxCopilot/Services/Agent/BuildRunTool.cs`
  - ?щ궡 紐⑤뱶?먯꽌 `action=custom`? 李⑤떒?섍퀬, ?뚮젮吏??ㅽ듃?뚰겕??紐낅졊 ?⑦꽩???ㅽ뻾 ?꾩뿉 留됱뒿?덈떎.
- `src/AxCopilot/Services/Agent/OpenExternalTool.cs`
  - 吏곸젒 ?꾧뎄 ?몄텧 寃쎈줈?먯꽌???몃? URI 李⑤떒???쇨??섍쾶 ?곸슜?섎룄濡?`OperationModePolicy.IsExternalUri(...)`瑜??ъ슜?섎룄濡??뺣━?덉뒿?덈떎.
- `src/AxCopilot/Views/ChatWindow.xaml.cs`
  - `?대쾲 ?ㅽ뻾 ?숈븞 ?덉슜` ?뱀씤 洹쒖튃?????ㅽ뻾 ?⑥쐞濡?愿由ы븯?꾨줉 諛붽엥?듬땲??
  - ?ㅽ뻾 ?쒖옉怨?醫낅즺 ??run-scope ?뱀씤 罹먯떆瑜?鍮꾩슦怨? 媛숈? ?ㅽ뻾 ?덉뿉?쒕쭔 ?숈씪 踰붿쐞 ?묎렐???ъ쭏臾??놁씠 ?듦낵?쒗궢?덈떎.
- `src/AxCopilot/Services/Agent/PermissionModePresentationCatalog.cs`
  - 沅뚰븳 紐⑤뱶 ?ㅻ챸???ㅼ젣 ?숈옉??留욊쾶 ?ъ옉?깊뻽?듬땲??
- `src/AxCopilot/Views/ChatWindow.PermissionPresentation.cs`
  - `沅뚰븳 嫄대꼫?곌린` 諛곕꼫 臾멸뎄瑜??щ궡 紐⑤뱶 ?덉쇅源뚯? 諛섏쁺?섎룄濡??섏젙?덉뒿?덈떎.
- `src/AxCopilot/Services/AppStateService.cs`
  - ???곹깭 ?붿빟??沅뚰븳 ?ㅻ챸???숈씪???섎?濡좎쑝濡?留욎톬?듬땲??

### ?뚯뒪??- `src/AxCopilot.Tests/Services/OperationModePolicyTests.cs`
  - ?몃? URI/mailto 李⑤떒
  - ?ㅽ듃?뚰겕??shell 紐낅졊 媛먯?
  - `ProcessTool` ?щ궡 紐⑤뱶 李⑤떒
  - `BuildRunTool` custom 李⑤떒
- `src/AxCopilot.Tests/Services/OperationModeReadinessTests.cs`
  - `OpenExternalTool`???몃? URI scheme 李⑤떒 ?뚭? 異붽?
- 寃利?  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_permission_policy_cleanup\\ -p:IntermediateOutputPath=obj\\verify_permission_policy_cleanup\\` 寃쎄퀬 0 / ?ㅻ쪟 0
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "OperationModePolicyTests|OperationModeReadinessTests|AgentLoopE2ETests" -p:OutputPath=bin\\verify_permission_policy_cleanup_tests\\ -p:IntermediateOutputPath=obj\\verify_permission_policy_cleanup_tests\\` ?듦낵 46
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "LlmOperationModeTests" -p:OutputPath=bin\\verify_permission_policy_llm_tests\\ -p:IntermediateOutputPath=obj\\verify_permission_policy_llm_tests\\` ?듦낵 3

?낅뜲?댄듃: 2026-04-15 16:40 (KST)

### ?щ궡 紐⑤뱶 ?몃? LLM 踰붿쐞 怨좎젙
- `src/AxCopilot.Tests/Services/LlmOperationModeTests.cs`
  - ?몄퐫?⑹씠 源⑥졇 ?덈뜕 湲곗〈 ?뚯뒪?몃? UTF-8 湲곗??쇰줈 ?뺣━?덉뒿?덈떎.
  - ?щ궡 紐⑤뱶?먯꽌 `Gemini`, `Claude`留??몃? LLM 李⑤떒 ??곸쑝濡?蹂닿퀬, `Ollama`, `vLLM`? 李⑤떒 媛?쒕? ?듦낵?댁빞 ?쒕떎???뚭? ?뚯뒪?몃? 異붽??덉뒿?덈떎.
- ?뺤콉 湲곗?
  - ?몃? LLM: `Gemini`, `Claude`
  - ?щ궡/?ъ쇅 紐⑤몢 ?덉슜: `Ollama`, `vLLM`
- 寃利?  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_internal_llm_scope\\ -p:IntermediateOutputPath=obj\\verify_internal_llm_scope\\` 寃쎄퀬 0 / ?ㅻ쪟 0
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "LlmOperationModeTests" -p:OutputPath=bin\\verify_internal_llm_scope_tests\\ -p:IntermediateOutputPath=obj\\verify_internal_llm_scope_tests\\` ?듦낵 5

업데이트: 2026-04-15 18:30 (KST)
- AX Agent 실행 루프의 반복 호출 방어를 보강했습니다. `src/AxCopilot/Services/Agent/AgentLoopTransitions.Execution.cs`는 동일 시그니처 도구 호출이 계속 반복될 때 read-only 전용 가드 외에 일반 실행 도구용 가드도 적용하고, `src/AxCopilot/Services/Agent/AgentLoopService.cs`는 이 전환을 메인 루프에 연결해 `build_run`, `process`, `wait_agents` 류 호출이 무의미하게 되풀이될 때 다른 접근을 강제하도록 정리했습니다.
- 채팅 상단 라이브 진행 표현을 요약형으로 재구성했습니다. `src/AxCopilot/Views/ChatWindow.V2LiveProgressPresentation.cs`는 상단 카드를 1~2줄 서술형 상태 카드로 단순화했고, `src/AxCopilot/Views/ChatWindow.V2Rendering.cs`는 스트리밍 중 발생한 ToolCall/ToolResult 이벤트를 더 이상 라이브 카드 안에만 가두지 않고 본문 타임라인에 누적되게 바꿨습니다.
- 실행 이력의 노이즈도 함께 줄였습니다. `src/AxCopilot/Services/Agent/AgentProgressSummarySanitizer.cs`, `src/AxCopilot/Views/ChatWindow.TimelinePresentation.cs`, `src/AxCopilot/Views/ChatWindow.AgentEventRendering.cs`는 모델 응답 대기, 내부 재시도, 저신호 Thinking 요약을 기본 로그/본문에서 더 적극적으로 숨기고, `src/AxCopilot/Services/Agent/StreamingToolExecutionCoordinator.cs`와 `src/AxCopilot/Views/ChatWindow.V2Rendering.cs`는 반복적인 대기 로그를 `Debug` 수준으로 낮췄습니다.
- 사용자에게 보이는 작업 설명도 `src/AxCopilot/Services/Agent/AgentStatusNarrativeCatalog.cs`에서 다시 정리했습니다. 코드 탐색, 수정, 실행, 문서화, 권한 대기 같은 단계가 더 짧고 친절한 한국어 문구로 노출되며, 대상 파일/명령/쿼리 같은 힌트는 detail 줄로 별도 노출됩니다.
- 채팅 본문 드래그 복사도 지원합니다. `src/AxCopilot/Services/MarkdownRenderer.cs`에 선택 가능한 RichTextBox 기반 마크다운 렌더를 추가했고, `src/AxCopilot/Views/ChatWindow.MessageBubblePresentation.cs`, `src/AxCopilot/Views/ChatWindow.V2MessagePresentation.cs`, `src/AxCopilot/Views/ChatWindow.ResponsePresentation.cs`가 Cowork/Code 본문에 이를 사용하도록 연결했습니다.
- 테스트는 `src/AxCopilot.Tests/Services/AgentLoopCodeQualityTests.cs`, `src/AxCopilot.Tests/Services/AgentStatusNarrativeCatalogTests.cs`, `src/AxCopilot.Tests/Services/AgentProgressSummarySanitizerTests.cs`를 갱신했고, `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_agent_ui_logs\\ -p:IntermediateOutputPath=obj\\verify_agent_ui_logs\\` 경고 0 / 오류 0, `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentLoopCodeQualityTests|AgentStatusNarrativeCatalogTests|AgentProgressSummarySanitizerTests" -p:OutputPath=bin\\verify_agent_ui_logs_tests\\ -p:IntermediateOutputPath=obj\\verify_agent_ui_logs_tests\\` 131개 통과를 확인했습니다.
업데이트: 2026-04-15 18:54 (KST)
- AX Agent 라이브 진행 UI를 이전 구조로 복구했습니다. `src/AxCopilot/Views/ChatWindow.V2LiveProgressPresentation.cs`는 상단 요약 1~2줄 카드 대신 단계형 라이브 카드와 도구 진행 행을 다시 사용하고, `src/AxCopilot/Views/ChatWindow.V2Rendering.cs`는 스트리밍 중 현재 실행 이벤트를 본문 타임라인에서 잠시 제외해 상단 카드와 본문이 중복 표시되지 않도록 원래 흐름으로 되돌렸습니다.
- 본문 드래그 선택은 유지하되 사용자 버블 회귀는 제거했습니다. `src/AxCopilot/Views/ChatWindow.MessageBubblePresentation.cs`, `src/AxCopilot/Views/ChatWindow.V2MessagePresentation.cs`에서 사용자 메시지 렌더만 기존 `MarkdownRenderer.Render(...)`로 되돌렸고, 어시스턴트 본문과 스트리밍 완료 본문은 계속 `RenderSelectable(...)`를 사용해 드래그 복사가 가능하도록 유지했습니다.
- `src/AxCopilot/Services/Agent/AgentProgressSummarySanitizer.cs`는 `SkillRuntime`, `allowed_tools`, 메인 루프 요청, 읽기 도구 조기 실행 준비, 스트리밍 도구 감지 등 저신호 내부 문구를 추가로 필터링해 본문/라이브 카드에 내부성 로그가 다시 노출되지 않도록 보강했습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_live_restore\\ -p:IntermediateOutputPath=obj\\verify_live_restore\\` 경고 0 / 오류 0
- 검증: `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentLoopCodeQualityTests|AgentStatusNarrativeCatalogTests|AgentProgressSummarySanitizerTests" -p:OutputPath=bin\\verify_live_restore_tests\\ -p:IntermediateOutputPath=obj\\verify_live_restore_tests\\` 통과 131

업데이트: 2026-04-15 19:12 (KST)

### Code 탭 로그 분석: 대화 저장소 복호화 오탐 수정
- 2026-04-15 18:44 Code 실행(`convId=08179304`)은 메인 루프 11회 후 정상 종료됐고, 로그상 실제 경고는 별도의 `.axchat` 대화 파일 복호화 단계에서 반복되고 있었습니다.
- 문제 원인:
  - `C:\Users\admin\AppData\Roaming\AxCopilot\conversations\0d65bb632d7b4fcea24b3d2cb0f900f0.axchat` 선행 바이트가 `0x5B`(`[`), `a0aa1206a20643959c710091e232d8be.axchat` 선행 바이트가 `0xEF`였습니다.
  - 기존 `CryptoService.DecryptFromFile(...)`는 첫 바이트가 `{`, `[`, `0xEF` 중 하나면 평문 JSON으로 간주했기 때문에, 암호화 바이너리가 우연히 이 바이트들로 시작할 때 복호화하지 않고 `JsonSerializer.Deserialize<ChatConversation>(...)`로 바로 넘겨 `대화 메타 로드 실패`, `만료 대화 정리 실패` 경고가 반복됐습니다.
- 수정 내용:
  - `src/AxCopilot/Services/CryptoService.cs`
    - `StrictUtf8` 디코더를 추가해 평문 JSON 판별 전에 실제 UTF-8 디코드 성공 여부를 먼저 확인합니다.
    - `TryNormalizePlainJson(...)`, `TryDecodePlainJson(...)` 헬퍼를 추가해 `UTF-8 BOM/공백 제거 후 첫 문자가 { 또는 [`인 경우만 평문 JSON으로 인정하도록 변경했습니다.
    - 복호화 후에도 같은 정규화 경로를 사용해 구버전 UTF-8 BOM 평문 대화 파일이 그대로 복원되도록 보강했습니다.
  - `src/AxCopilot.Tests/Services/ChatStorageServiceTests.cs`
    - 암호문 선행 바이트가 `[` 또는 `0xEF`인 회귀 케이스를 생성해 `Load()`와 `LoadAllMeta()`가 정상 복원되는지 검증합니다.
    - UTF-8 BOM이 있는 레거시 평문 `.axchat`도 정상 복원되는지 검증합니다.

### 검증
- `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_chat_storage_fix\\ -p:IntermediateOutputPath=obj\\verify_chat_storage_fix\\` 경고 0 / 오류 0
- `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatStorageServiceTests" -p:OutputPath=bin\\verify_chat_storage_fix_tests\\ -p:IntermediateOutputPath=obj\\verify_chat_storage_fix_tests\\` 통과 4
업데이트: 2026-04-15 19:21 (KST)
- AX Agent 실행 대화를 탭별로 추적하도록 정리했습니다. `src/AxCopilot/Views/ChatWindow.xaml.cs`는 실행 시작 시 원래 대화를 따로 보관하고, 같은 탭에서 다른 대화로 이동하거나 새 대화를 시작해도 진행 중인 실행이 끊기지 않도록 탭 복귀 시 해당 대화를 다시 로드합니다.
- `src/AxCopilot/Views/ChatWindow.ConversationListPresentation.cs`는 대화 선택 시 `StopStreamingIfActive()`로 전체 실행을 취소하던 흐름을 제거했습니다. 대신 `src/AxCopilot/Views/ChatWindow.AgentEventProcessor.cs`, `src/AxCopilot/Services/Agent/AxAgentExecutionEngine.cs`, `src/AxCopilot/Services/ChatSessionStateService.cs`가 에이전트 이벤트·실행 요약·완료 메시지를 현재 선택 대화가 아니라 실행이 시작된 원래 대화에 누적하도록 역할을 분리했습니다.
- 숨겨진 백그라운드 실행이 현재 선택 상태를 덮어쓰지 않도록 저장 경로도 보강했습니다. 같은 탭에서 다른 대화를 보고 있는 동안에는 실행 로그를 현재 본문에 렌더하지 않고, 배치 저장 시에도 `RememberConversation(...)`를 현재 선택 대화와 일치할 때만 갱신하도록 조정했습니다.
- 테스트는 `src/AxCopilot.Tests/Services/ChatSessionStateServiceTests.cs`, `src/AxCopilot.Tests/Services/AxAgentExecutionEngineTests.cs`에 같은 탭 백그라운드 실행 귀속 회귀 케이스를 추가했습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_conversation_background_resume\\ -p:IntermediateOutputPath=obj\\verify_conversation_background_resume\\` 경고 0 / 오류 0
- 검증: `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatSessionStateServiceTests|AxAgentExecutionEngineTests" -p:OutputPath=bin\\verify_conversation_background_resume_tests\\ -p:IntermediateOutputPath=obj\\verify_conversation_background_resume_tests\\` 통과 39
업데이트: 2026-04-15 19:31 (KST)
- AX Agent 상단 라이브 안내 카드 회귀를 수정했습니다. `src/AxCopilot/Views/ChatWindow.xaml.cs`의 `RefreshStreamingControlsForActiveTab()`와 `OnAgentEvent(...)`가 더 이상 `현재 대화가 실행 대화와 정확히 일치하지 않는다`는 이유만으로 상단 라이브 카드와 상태 바를 제거하지 않고, 같은 탭에 실행이 살아 있는 동안에는 상단 안내를 유지하도록 분기했습니다.
- 본문 실행 이력과 상단 진행 안내를 분리했습니다. 같은 탭의 다른 대화를 보고 있을 때는 conversation-bound timeline 렌더만 멈추고, 상단 라이브 카드/펄스 상태/토큰 갱신은 계속 유지되도록 바꿨습니다.
- `src/AxCopilot/Views/ChatStreamingUiPolicy.cs`를 추가해 `Hidden`, `ActiveConversation`, `BackgroundConversation` 세 상태를 명시적으로 분류하고, `src/AxCopilot.Tests/Views/ChatStreamingUiPolicyTests.cs`에 상단 가이드 유지 및 본문 렌더 분리 회귀 테스트를 추가했습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_live_guide_persistence\\ -p:IntermediateOutputPath=obj\\verify_live_guide_persistence\\` 경고 0 / 오류 0
- 검증: `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatStreamingUiPolicyTests|ChatWindowSlashPolicyTests|ChatSessionStateServiceTests|AxAgentExecutionEngineTests" -p:OutputPath=bin\\verify_live_guide_persistence_tests\\ -p:IntermediateOutputPath=obj\\verify_live_guide_persistence_tests\\` 통과 98
업데이트: 2026-04-15 19:46 (KST)
- Code 탭 proactive auto skill 선택을 실제 키워드·경로 신호 기반으로 다시 제한했습니다. `src/AxCopilot/Services/Agent/SkillService.cs`에서 기본 점수만으로 무관한 번들 스킬이 항상 선택되던 경로를 제거해, 일반 코드 생성 요청에 unrelated skill runtime이 덧붙지 않도록 했습니다.
- 같은 파일에서 `BuildProactiveSkillSystemPromptAsync(...)`는 auto skill guidance에 더 이상 `[Skill Runtime Policy]`를 합치지 않도록 변경했습니다. 이 회귀 때문에 `allowed_tools`가 7개 수준으로 좁아지면서 빈 작업 폴더 생성 요청에서 `file_write`가 빠져 조기 종료되던 문제가 재현됐습니다.
- `src/AxCopilot.Tests/Services/SkillServiceRuntimePolicyTests.cs`에 `BuildProactiveSkillSystemPromptAsync_ReturnsNull_WhenNothingMeaningfullyMatches`, `BuildProactiveSkillSystemPromptAsync_DoesNotInjectHardRuntimePolicy`를 추가했습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_auto_skill_runtime_fix\\ -p:IntermediateOutputPath=obj\\verify_auto_skill_runtime_fix\\` 경고 0 / 오류 0
- 검증: `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "SkillServiceRuntimePolicyTests|FullyQualifiedName~RunAsync_EmptyWorkspace_BlocksExternalFallbackAndRecoversToFileWrite|FullyQualifiedName~RunAsync_EmptyWorkspace_DisallowsSkillManagerAndRecoversToFileWrite" -p:OutputPath=bin\\verify_auto_skill_runtime_fix_tests\\ -p:IntermediateOutputPath=obj\\verify_auto_skill_runtime_fix_tests\\` 통과 15
업데이트: 2026-04-15 19:59 (KST)
- AX Agent 스트리밍 중 탭 전환, 새 대화, 경과 시간 갱신이 멈춘 것처럼 보이던 회귀를 수정했습니다. 원인은 `src/AxCopilot/Services/ChatSessionStateService.cs`가 같은 `LastActiveTab`, `LastConversationIds` 상태에서도 매번 `settings.Save()`를 호출해 `SettingsChanged -> RefreshFromSavedSettings -> UpdateTabUI -> SwitchToTabConversation -> SaveLastConversations` 순환이 계속 발생하던 흐름이었습니다.
- `ChatSessionStateService.Save(...)`는 이제 세션 스냅샷이 실제로 바뀐 경우에만 저장을 수행합니다. 스트리밍 렌더 중 같은 대화를 다시 보여줘도 설정 저장과 UI 재진입이 재발화하지 않도록 막았습니다.
- `src/AxCopilot.Tests/Services/ChatSessionStateServiceTests.cs`에 `Save_DoesNotPersistOrRaiseEvents_WhenSessionStateIsUnchanged`, `Save_PersistsAndRaisesEvents_WhenSessionStateChanges`를 추가해 반복 저장 루프 회귀를 고정했습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_streaming_tab_loop_fix\\ -p:IntermediateOutputPath=obj\\verify_streaming_tab_loop_fix\\` 경고 0 / 오류 0
- 검증: `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatSessionStateServiceTests|ChatStreamingUiPolicyTests|AxAgentExecutionEngineTests" -p:OutputPath=bin\\verify_streaming_tab_loop_fix_tests\\ -p:IntermediateOutputPath=obj\\verify_streaming_tab_loop_fix_tests\\` 통과 51
업데이트: 2026-04-15 20:06 (KST)
- 빠른 로컬 테스트 전용 Windows 스크립트 `build-quick.ps1`를 루트에 추가했습니다. 목적은 인스톨러 빌드와 `dist` 패키징을 건너뛰고 `src/AxCopilot/AxCopilot.csproj`만 직접 `Release + win-x64`로 빌드해 `src\\AxCopilot\\bin\\Release\\net8.0-windows10.0.17763.0\\win-x64` 출력물을 빠르게 갱신하는 것입니다.
- 스크립트는 기본적으로 `dotnet build --no-restore` 경로를 사용하고, `obj\\project.assets.json`이 없거나 사용자가 `-Restore`를 준 경우에만 restore를 수행합니다. 잠금 문제를 줄이기 위해 `-StopRunningApp`, 출력물 정리를 원할 때 `-Clean` 옵션도 함께 지원합니다.
- 검증: `powershell -ExecutionPolicy Bypass -File .\\build-quick.ps1` 실행으로 빠른 빌드 스크립트가 정상 완료되고 출력 경로가 갱신되는 것을 확인했습니다.
업데이트: 2026-04-15 20:12 (KST)
- AX Agent 하단 컨텍스트 사용량 링이 트랙보다 오른쪽으로 밀려 보이던 시각 회귀를 수정했습니다. 원인은 `src/AxCopilot/Views/ChatWindow.ContextUsagePresentation.cs`가 `22x22` 트랙 위에 arc를 `center=15`, `radius=11` 하드코딩으로 그려 실제 트랙 중심선보다 크게 렌더링하던 점이었습니다.
- `src/AxCopilot/Views/ChatWindow.xaml`에서 `TokenUsageTrack`을 명시적으로 분리하고, `TokenUsageArc`를 트랙과 같은 크기/가운데 정렬/`Stretch=None`으로 맞췄습니다. `src/AxCopilot/Views/ChatWindow.ContextUsagePresentation.cs`는 실제 트랙 지름을 읽어 arc 크기를 맞추고, `src/AxCopilot/Views/ChatWindow.xaml.cs`의 `CalculateCircularRingMetrics(...)` helper로 중심점과 반지름을 계산하도록 변경했습니다.
- `src/AxCopilot.Tests/Views/ChatWindowSlashPolicyTests.cs`에 `CalculateCircularRingMetrics_ShouldAlignCenterlineToTrack`를 추가해 지름과 스트로크 두께에 따른 계산 회귀를 고정했습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_token_ring_alignment\\ -p:IntermediateOutputPath=obj\\verify_token_ring_alignment\\` 경고 0 / 오류 0
- 검증: `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatWindowSlashPolicyTests" -p:OutputPath=bin\\verify_token_ring_alignment_tests\\ -p:IntermediateOutputPath=obj\\verify_token_ring_alignment_tests\\` 통과 53
업데이트: 2026-04-15 20:16 (KST)
- AX Agent 입력창 위 시간·토큰 표시가 라이브 진행 텍스트 높이에 끌려 올라가던 배치를 수정했습니다. 원인은 `src/AxCopilot/Views/ChatWindow.xaml`에서 `StreamMetricsLabel`이 `PulseDotBar`와 같은 Grid를 공유하고 있어, 왼쪽 진행 상태가 여러 줄로 커질 때 라벨도 같은 행 중앙으로 끌려가던 점이었습니다.
- `StreamMetricsLabel`를 진행 상태 행에서 분리해 입력 영역 바로 앞에 독립 배치했습니다. 이제 `PulseDotBar`의 높이가 바뀌어도 시간·토큰 라벨은 입력창 바로 위 오른쪽에 붙어 있게 됩니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_stream_metrics_anchor\\ -p:IntermediateOutputPath=obj\\verify_stream_metrics_anchor\\` 경고 0 / 오류 0
업데이트: 2026-04-15 20:41 (KST)
- AX Agent 좌측 대화 목록을 Codex 스타일에 가깝게 1줄형 카드로 재구성했습니다. `src/AxCopilot/Views/ChatWindow.xaml`의 `ConversationItemTemplate`를 제목/시간 1줄 구조로 바꾸고, 선택 상태는 얇은 좌측 바 대신 전체 배경 + 테두리 강조로 바꿔 현재 테마(`HintBackground`, `AccentColor`, `ItemHoverBackground`)를 그대로 따르도록 정리했습니다.
- `src/AxCopilot/Views/ChatWindow.ConversationListPresentation.cs`에 실행 링/미열람 완료 점 정책을 추가했습니다. 현재 탭의 실제 스트리밍 대화만 실행 중 심볼을 표시하고, 백그라운드 완료 후 아직 열어보지 않은 대화는 완료 점을 붙였다가 해당 대화를 열면 바로 지워지도록 `MarkConversationCompletionSeen(...)`, `ShouldShowConversationRunningIndicator(...)`, `ShouldShowConversationCompletionMarker(...)` 헬퍼를 넣었습니다.
- 좌측 대화 목록에서 같은 항목을 다시 클릭했을 때 바로 이름 편집으로 들어가던 흐름은 제거했습니다. 이름 변경은 더 이상 목록 직접 클릭으로 진입하지 않고, 우클릭 메뉴 기반 관리 흐름만 유지합니다.
- `src/AxCopilot/ViewModels/ChatWindowViewModel.cs`에 `HasUnreadCompletion` 바인딩을 추가했고, `src/AxCopilot.Tests/Views/ChatWindowSlashPolicyTests.cs`에 실행 링/완료 점 조건 회귀 테스트를 넣었습니다.
- 검증:
  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_conversation_list_refresh\\ -p:IntermediateOutputPath=obj\\verify_conversation_list_refresh\\` 경고 0 / 오류 0
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatWindowSlashPolicyTests" -p:OutputPath=bin\\verify_conversation_list_refresh_tests\\ -p:IntermediateOutputPath=obj\\verify_conversation_list_refresh_tests\\` 통과 59
업데이트: 2026-04-15 20:55 (KST)
- Code 탭 리뷰 로그를 기준으로 비 Git 작업 폴더 회복 흐름을 조정했습니다. `src/AxCopilot/Services/Agent/AgentLoopService.cs`와 `src/AxCopilot/Services/Agent/TaskTypePolicy.cs`가 `git_tool(diff)`만 고집하지 않고 `code_review(file_review)` 또는 직접 파일 검토 경로를 함께 제시하도록 바뀌어, 저장소가 아닌 폴더에서 리뷰/검증 작업이 같은 Git 계열 도구를 반복 호출하던 회귀를 줄였습니다.
- `src/AxCopilot/Services/Agent/CodeReviewTool.cs`는 `diff_review` 전에 실제 Git 저장소 루트를 확인하고, 저장소가 아니거나 Git 실행이 불가능하면 즉시 `file_review` 대안을 반환합니다. Git 탐지도 `where.exe` 기반으로 보강해 `git_tool`과 `code_review`의 Git 탐지 결과가 달라지던 문제를 함께 줄였습니다.
- `src/AxCopilot/Services/Agent/OpenExternalTool.cs`, `src/AxCopilot/Views/ChatWindow.SystemPromptBuilder.cs`, `src/AxCopilot/Services/Agent/IAgentTool.cs`에는 자동 열기 실행 가드를 추가했습니다. 사용자가 명시적으로 열기/실행/미리보기를 요청하지 않은 경우 `open_external`은 차단되고, Cowork/Code 시스템 프롬프트도 결과물 생성 뒤 브라우저 실행이나 미리보기 서버 시작을 자동으로 하지 않도록 고정했습니다.
- 테스트: `src/AxCopilot.Tests/Services/AgentLoopCodeQualityTests.cs`, `src/AxCopilot.Tests/Services/OperationModeReadinessTests.cs`
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_review_policy_fix\\ -p:IntermediateOutputPath=obj\\verify_review_policy_fix\\` 경고 0 / 오류 0
- 검증: `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "AgentLoopCodeQualityTests|OperationModeReadinessTests" -p:OutputPath=bin\\verify_review_policy_fix_tests\\ -p:IntermediateOutputPath=obj\\verify_review_policy_fix_tests\\` 통과 133

업데이트: 2026-04-15 21:00 (KST)
- AX Agent 좌측 대화 목록의 선택 스타일을 카드형 강조로 조정했습니다. `src/AxCopilot/Views/ChatWindow.xaml`의 `ConversationItemTemplate`가 선택된 항목에 `ItemSelectedBackground`를 채우는 둥근 직사각형 배경을 적용해, 제목만 굵어지는 대신 항목 전체가 현재 테마에서 더 분명하게 선택 상태를 보여줍니다.
- 같은 목록 템플릿에 idle 심볼도 추가했습니다. `src/AxCopilot/ViewModels/ChatWindowViewModel.cs`의 `ConversationItemViewModel.ShowIdleIndicator`가 실행 중/미확인 완료가 아닌 항목을 판정하고, 목록에서는 점선 링 심볼을 기본으로 보여주다가 실행 중이면 러닝 링, 아직 열어보지 않은 완료 대화면 완료 점으로 치환합니다.
- `src/AxCopilot.Tests/ViewModels/ConversationItemViewModelTests.cs`에 idle/running/completion 상태별 아이콘 계산 회귀 테스트를 추가했습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_conversation_list_selected_card\\ -p:IntermediateOutputPath=obj\\verify_conversation_list_selected_card\\` 경고 0 / 오류 0
- 검증: `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ConversationItemViewModelTests" -p:OutputPath=bin\\verify_conversation_list_selected_card_tests\\ -p:IntermediateOutputPath=obj\\verify_conversation_list_selected_card_tests\\` 통과 3

업데이트: 2026-04-15 21:11 (KST)
- AX Agent 좌측 대화 목록 선택 배경이 보이지 않던 회귀를 수정했습니다. `src/AxCopilot/Views/ChatWindow.xaml`의 `ConversationItemTemplate` 루트 `Border`에 있던 `Background="Transparent"`와 `BorderBrush="Transparent"` 로컬값이 스타일 트리거를 이기고 있어서, 선택 상태여도 `ItemSelectedBackground`가 실제로 적용되지 않았습니다.
- 같은 템플릿에서 기본 투명값을 스타일 setter로 옮기고, `ConversationItemsControl` 컨테이너를 가로 `Stretch`로 맞춰 선택된 항목이 제목 주변만이 아니라 행 전체 둥근 카드처럼 채워지도록 조정했습니다.
- idle 심볼은 `16x16` 영역과 내부 마진을 주도록 수정해 점선 링이 가장자리에서 약간 잘리던 문제를 줄였습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_conversation_list_selection_fix\\ -p:IntermediateOutputPath=obj\\verify_conversation_list_selection_fix\\` 경고 0 / 오류 0
- 검증: `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ConversationItemViewModelTests" -p:OutputPath=bin\\verify_conversation_list_selection_fix_tests\\ -p:IntermediateOutputPath=obj\\verify_conversation_list_selection_fix_tests\\` 통과 3

업데이트: 2026-04-15 21:19 (KST)
- AX Copilot 앱 아이콘이 작업 표시줄과 트레이에서 작게 보이던 문제를 자산 기준으로 조정했습니다. 기존 `src/AxCopilot/Assets/icon.ico`는 내부 여백이 커서 32px 기준 실사용 영역이 작았고, 트레이에서도 같은 아이콘이 더 축소돼 보였습니다.
- `tools/IconGenerator/Program.cs`를 현재 AX 4다이아몬드 아이콘 스타일 기준 생성기로 정리하고, `16/20/24/32/40/48/64/128/256` 프레임을 포함하는 멀티사이즈 `ico`를 만들도록 바꿨습니다. 이 변경으로 `src/AxCopilot/App.xaml.cs`의 `LoadAppIcon()`이 DPI별 트레이 크기에서도 더 맞는 프레임을 읽을 수 있습니다.
- `src/AxCopilot/Assets/icon.ico`는 내부 도형 점유율을 키운 새 아이콘으로 재생성했고, `src/AxCopilot/Assets/diamond_pixel.svg`도 같은 비율의 소스 자산으로 맞췄습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_icon_size\\ -p:IntermediateOutputPath=obj\\verify_icon_size\\` 경고 0 / 오류 0
- 검증: `System.Drawing.Icon` 확인 결과 16/20/24/32 프레임이 요청 크기 그대로 로드됨
업데이트: 2026-04-15 21:23 (KST)
- AX Agent 입력 영역 상단 레이아웃을 다시 정리했습니다. src/AxCopilot/Views/ChatWindow.xaml에서 StreamMetricsLabel을 독립 줄로 분리했던 배치 때문에 라이브 진행 문구와 입력창 사이가 넓게 벌어져 보였고, 우측 시간·토큰 표시만 아래로 내려간 상태였습니다.
- 같은 파일의 라이브 진행 Grid를 2열 구조로 바꾸고 StreamMetricsLabel을 우측 하단에 붙여, 진행 문구는 입력창과 시각적으로 붙은 상태를 유지하면서도 시간·토큰은 항상 입력창 바로 위 우측에 고정되도록 조정했습니다.
- 검증: dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_stream_metrics_compact\\ -p:IntermediateOutputPath=obj\\verify_stream_metrics_compact\\ 경고 0 / 오류 0

업데이트: 2026-04-15 21:48 (KST)
- AX Agent 채팅창의 Windows 제목을 `AX Agent`로 고정했습니다. `src/AxCopilot/Views/ChatWindow.xaml`이 더 이상 대화 제목을 창 제목에 섞어 보여주지 않아, 작업 표시줄/Alt+Tab/미리보기에서 제품명만 안정적으로 보입니다.
- PPT 템플릿 해상도 경로를 manifest 기반으로 재구성했습니다. `src/AxCopilot/Assets/ppt/templates.manifest.json`에 템플릿 키, 파일명, fallback theme, 태그/pack hint를 선언하고 `src/AxCopilot/Services/Agent/PptxTemplateManifestCatalog.cs`가 실행 폴더, 현재 작업 폴더, `%APPDATA%\\AXCopilot\\templates\\ppt`, 소스 루트의 `src/AxCopilot/Assets/ppt`를 상향 탐색해 실제 템플릿 파일을 찾도록 바꿨습니다. 이전 `ResolveTemplatePath(...)`는 `bin\\...\\Assets\\ppt`처럼 잘못된 상대 경로에 의존해 개발 빌드 출력에서 `basic100/core100`을 놓칠 수 있었습니다.
- `src/AxCopilot/Services/Agent/PptxSkill.cs`는 manifest 해상도 결과를 받아 명시적 템플릿/pack 템플릿의 fallback theme를 더 정확히 고르고, 결과 요약에서 `color fallback`과 `asset missing -> built-in fallback`을 구분해 남깁니다. 템플릿 파일을 못 찾은 경우에는 `Template diagnostics` 라인에 후보 디렉터리 수를 함께 남겨 원인 추적이 쉬워졌습니다.
- Cowork PPT 품질 게이트를 추가했습니다. `src/AxCopilot/Services/Agent/PptQualityGatePolicy.cs`가 `pptx_create` 출력에서 `PPT quality`, `Slide alerts`, `Needs work`, `color fallback`을 파싱하고, `src/AxCopilot/Services/Agent/AgentLoopTransitions.Documents.cs`는 Cowork에서 `pptx_create` 성공 직후 품질이 기준 미만이면 즉시 종료하지 않고 최대 2회까지 `document_plan`/`pptx_create` 재생성을 요구합니다. 그동안 `AgentLoopService`의 terminal document completion 때문에 저품질 PPT도 첫 성공 후 바로 끝나던 문제가 있었습니다.
- Cowork 시스템 프롬프트와 PPT 스킬 지시도 품질 기준으로 정렬했습니다. `src/AxCopilot/Views/ChatWindow.SystemPromptBuilder.cs`는 전략/제안/경영진용 PPT에서 `document_plan`을 먼저 쓰게 유도하고, `src/AxCopilot/skills/pptx-creator.skill.md`는 `document_plan + pptx_create`를 기본 경로로 명시하며 낮은 품질 요약이 나오면 바로 종료하지 말고 재생성하도록 안내합니다.
- 테스트:
  - `src/AxCopilot.Tests/Services/PptQualityGatePolicyTests.cs`
  - `src/AxCopilot.Tests/Services/PptxTemplateManifestCatalogTests.cs`
  - `src/AxCopilot.Tests/Services/PptxSkillTemplatePackTests.cs`
- 검증:
  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_ppt_quality_gate\\ -p:IntermediateOutputPath=obj\\verify_ppt_quality_gate\\` 경고 0 / 오류 0
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "PptxSkillTemplatePackTests|PptxSkillAutoRepairTests|PptxSkillGoldenDeckTests|PptQualityGatePolicyTests|PptxTemplateManifestCatalogTests" -p:OutputPath=bin\\verify_ppt_quality_gate_tests\\ -p:IntermediateOutputPath=obj\\verify_ppt_quality_gate_tests\\` 통과 12
업데이트: 2026-04-15 22:18 (KST)
- AX Agent V2 라이브 진행 카드의 상태 본문 지속성을 보강했습니다. `src/AxCopilot/Views/ChatWindow.V2LiveProgressPresentation.cs`에 고정 상태 카드(`_v2LiveStatusCard`)와 본문/상세/메타 텍스트를 추가해, 실행 로그 항목만 남고 상단 안내 문구가 사라진 것처럼 보이던 회귀를 줄였습니다.
- 스트리밍 시작 시 `RefreshV2LiveStatusCard(runTab)`로 초기 상태를 먼저 채우고, 각 `AgentEvent` 처리 시 `UpdateV2LiveStatusCardFromEvent(...)`로 카드 내용을 갱신하도록 정리했습니다. 이제 툴 호출 카드가 접히거나 thinking 요약이 비어도 라이브 카드 상단 메시지는 유지됩니다.
- 검증:
  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_live_message_persistence2\\ -p:IntermediateOutputPath=obj\\verify_live_message_persistence2\\` 경고 0 / 오류 0
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatStreamingUiPolicyTests|ChatWindowSlashPolicyTests" -p:OutputPath=bin\\verify_live_message_persistence_tests\\ -p:IntermediateOutputPath=obj\\verify_live_message_persistence_tests\\` 통과 69
업데이트: 2026-04-15 22:07 (KST)
- AX Agent 동일 탭 내 대화 선택 회귀를 수정했습니다. 원인은 `src/AxCopilot/Views/ChatWindow.xaml.cs`의 `SaveLastConversations()`가 세션 상태(`LastActiveTab`, `LastConversationIds`)를 저장할 때마다 `SettingsChanged`를 다시 태워 `RefreshFromSavedSettings() -> UpdateTabUI() -> SwitchToTabConversation()`가 연쇄 호출되고, 실행 중 탭에서는 스트리밍 대화를 다시 현재 대화로 강제 복귀시키던 흐름이었습니다.
- `ChatWindow.xaml.cs`에 `_suppressSettingsRefreshForSessionSave`를 추가해 세션 상태 저장으로 발생한 설정 변경 이벤트는 UI 전체 재적용에서 제외했습니다. 이로써 같은 탭 안의 다른 대화를 클릭해도 선택 직후 다시 원래 실행 대화로 튕기지 않습니다.
- `src/AxCopilot/Views/ChatStreamingUiPolicy.cs`에는 `ShouldPreferStreamingConversation(...)` 정책을 추가했습니다. 탭 복귀 시 스트리밍 대화가 있더라도, 사용자가 해당 탭에서 다른 대화를 명시적으로 선택해 기억해둔 상태라면 그 선택을 유지하고 라이브 가이드만 `BackgroundConversation`으로 노출하도록 `SwitchToTabConversation()` 분기를 조정했습니다.
- 테스트: `src/AxCopilot.Tests/Views/ChatStreamingUiPolicyTests.cs`에 스트리밍 대화 우선 노출 정책 회귀 케이스를 추가했습니다.
- 검증:
  - `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_conversation_selection_persist\\ -p:IntermediateOutputPath=obj\\verify_conversation_selection_persist\\` 경고 0 / 오류 0
  - `dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter "ChatStreamingUiPolicyTests|ChatSessionStateServiceTests" -p:OutputPath=bin\\verify_conversation_selection_persist_tests\\ -p:IntermediateOutputPath=obj\\verify_conversation_selection_persist_tests\\` 통과 55
업데이트: 2026-04-15 22:10 (KST)
- AX Agent 좌측 대화 목록 상태 심볼을 열린 링 대신 꽉 찬 원형 구체 스타일로 정리했습니다. `src/AxCopilot/Views/ChatWindow.xaml`의 `ConversationItemTemplate`에서 idle/running 표시를 모두 레이어드 `Ellipse` 배지로 교체해, 한쪽이 비어 보이던 시각 문제를 없앴습니다.
- idle 상태는 중립색 구체와 하이라이트 조합으로, 실행 중 상태는 `AccentColor` 기반 구체로 보이게 바꿨고, unread completion 점도 같은 외곽/하이라이트 패턴으로 맞췄습니다.
- 검증: `dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_conversation_symbol_sphere\\ -p:IntermediateOutputPath=obj\\verify_conversation_symbol_sphere\\` 경고 0 / 오류 0