lacvet
9344cf83d6
- README와 DEVELOPMENT, 로드맵 문서에서 비교·모사 뉘앙스가 강한 문구를 AX 기준 설명으로 정리함 - 비교/패리티 성격의 문서를 AX Agent 구조 리뷰, 실행 개선 계획, 품질 계획, 런타임 품질 계획, 도구 커버리지 문서로 재구성함 - 회귀 프롬프트와 보조 개발 문서의 용어를 공통 핵심 명령과 운영 기준 중심으로 정리함 - 검증: dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\\verify_docs_cleanup\\ -p:IntermediateOutputPath=obj\\verify_docs_cleanup\\ (경고 0 / 오류 0)
81 lines
4.4 KiB
Markdown
81 lines
4.4 KiB
Markdown
# 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 확장을 다음 배치로 고정
|