# AX Copilot 통합 로드맵

업데이트: 2026-04-15 18:20 (KST)

## 1. 방향
- AX Copilot 전반의 실행 신뢰성, 세션 내구성, 결과 품질을 함께 끌어올립니다.
- 개발 문서는 비교 보고서가 아니라 AX 기준 계획과 검증 기록으로 유지합니다.

## 2. 마일스톤

| 마일스톤 | 참조 대상 | AX 적용 위치 | 완료 조건 | 품질 판정 시나리오 |
|---|---|---|---|---|
| M1 (v0.7.3) Hook 계약 정식화 | `src/utils/hooks.ts`, `src/utils/hooks/hookEvents.ts`, `src/utils/permissions/PermissionUpdate.ts` | `AgentHookRunner.cs`, `AgentLoopService.cs`, `AppSettings.cs`, `SettingsViewModel.cs`, `SettingsWindow.xaml` | Hook 출력 계약(`updatedInput`, `updatedPermissions`, `additionalContext`) 반영, 설정값-실행코드-UI 동시 반영 | JSON 훅/텍스트 훅 혼합 환경에서도 실행 품질과 하위호환 유지 |
| M2 (v0.7.4 ~ v0.7.5) 세션/로그 내구성 | `src/utils/plans.ts`, `src/utils/sessionStorage.ts` | `ChatSessionStateService.cs`, `TaskRunService.cs`, `TaskRunStore.cs`, `ChatWindow.xaml.cs`, `ChatModels.cs` | plan/run 상태 영속화, 이벤트 로그 표준화, replay 안정성 확보 | 앱 재시작/강제 종료 후 같은 세션 재개 시 상태 불일치 0건 |
| M3 (v0.7.6) 도구 선택/복구 안정화 | `src/commands.ts`, `src/Tool.ts`, `src/query.ts` | `AgentLoopService.cs`, `AgentLoopParallelExecution.cs`, `LlmService.ToolUse.cs` | 도구 선택 실패 루프 억제, 실패 유형별 복구 흐름 정형화 | 오타/비활성/별칭 도구 요청이 반복 실패 없이 정상 경로로 수렴 |
| M4 (v0.8.0) 품질 게이트 고정 | `src/query.ts`, `src/QueryEngine.ts`, `src/utils/sessionStorage.ts` | `AgentLoopService.cs`, `AgentLoopTransitions.Execution.cs`, `AgentLoopTransitions.cs` | 증거 기반 완료 판정 고정, 릴리즈 게이트 자동화 강화 | 코드수정/문서생성/권한거부/복구 혼합 시나리오에서 조기 완료 없이 종료 |

## 3. 측정 지표
- 반복 실패 루프 발생률
- 세션 재개 성공률
- 완료 응답 근거 누락률
- 빌드/테스트 통과율

## 4. 운영 원칙
- `internal` 모드에서는 외부 유출 경로 차단 우선
- 신규 기능은 설정값 연결과 실제 동작 반영을 함께 완료
- 문서 마스터는 `.md`, HTML은 요청 시만 갱신

## 5. 즉시 실행 백로그
1. Hook 계약 확장 마무리 및 회귀 테스트
2. 세션 복원 경계조건 테스트 세트 추가
3. 이벤트 로그 스키마 고정 및 분석 리포트 템플릿 정리

## 6. 실행 증적 기준
- 기준 시점: 2026-04-03
- 전체 테스트: `379/379` 통과
- Hook 계약 필드 반영 경로 구현 완료
- run 복원/이력 재구성 경로 구현 및 테스트 존재
- unknown-tool 복구 루프와 완료 게이트 경로 구현 및 테스트 존재
- 스킬/도구 운영 정렬: `allowed-tools` 전건 명시, Python 의존 경로 fallback 반영, 레거시 도구명 참조 제거

## 7. 벤치마크 기준
- 기준 문서: `docs/AX_AGENT_QUALITY_PLAN.md`
- 고정 시나리오:
  - 기본 loop
  - unknown-tool 복구
  - plan 연결
  - 권한 거부
  - hook 입력 변형
  - allowed-tools 강제
  - hook filter
- 합격 게이트:
  - 빌드 경고·오류 0
  - 전체 테스트 통과
  - 고정 시나리오 회귀 통과

## 8. 실행 프레임

### 입력 계층
- slash 명령 카탈로그와 매칭 상태를 별도 파일로 분리
- 입력 파싱 변경은 회귀 테스트와 함께 반영

### 권한 UX
- 권한 모드 명칭, 설명, 색, 정렬 순서를 단일 소스에서 관리
- 팝업, 상태 배너, 슬래시 출력이 같은 용어를 사용

### 설정 동기화
- Cowork/Code 설정 분기를 실행 코드까지 일치
- 설정 변경 즉시 반영 시나리오를 체크리스트화

### 통합 회귀
- `internal/external`, permission deny/recover, mcp reconnect, compact 수동/자동 흐름을 함께 검증

### 업무형 UI 마감
- 좌측 패널, 컴포저, 권한 팝업 밀도와 탐색 동작을 단순하고 일관된 패턴으로 정리

## 9. 최근 진행 메모
- 2026-04-15 08:32 (KST): 루프 품질은 장기 상태 고정과 세분화 중심 과제로 축소
- 2026-04-15 09:49 (KST): 언어별 workflow 주입과 문서 포맷 critic/repair 루프를 다음 우선순위로 정리
- 2026-04-15 10:05 (KST): queued command projector, run lifecycle helper, quality formatter 확장을 다음 배치로 고정