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)
4.4 KiB
4.4 KiB
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. 즉시 실행 백로그
- Hook 계약 확장 마무리 및 회귀 테스트
- 세션 복원 경계조건 테스트 세트 추가
- 이벤트 로그 스키마 고정 및 분석 리포트 템플릿 정리
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 확장을 다음 배치로 고정