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.0 KiB
4.0 KiB
AX Agent 로드맵
업데이트: 2026-04-15 18:20 (KST)
1. 목표
- AX Agent의 실행 신뢰성, 세션 내구성, 결과 품질을 단계적으로 높입니다.
- 비교·모사 표현 대신 실제 참조 모듈 경로와 AX 적용 위치만 문서에 남깁니다.
- 변경 우선순위는
상태 -> 실행 -> 렌더 -> UX순서로 유지합니다.
2. 보존 이력
- v0.5.x: MCP, 모델 폴백, 대화 분기, 프리뷰/토큰 관리, 에이전트 루프 기반 구축
- v0.6.0: 문서 생성, 데이터 피벗, 템플릿/이미지 분석 도구군 확장
- v0.7.0 ~ v0.7.2: Plan Mode, 병렬 도구 실행, 검증 게이트, 컨텍스트 압축 안정화
3. 2026 실행 계획
| Phase | 참조 대상 | AX 적용 위치 | 완료 조건 | 품질 판정 시나리오 |
|---|---|---|---|---|
| A (v0.7.3) Hook/Permission 계약 고도화 | src/utils/hooks.ts, src/utils/hooks/hookEvents.ts, src/utils/permissions/PermissionUpdate.ts, src/utils/permissions/permissionSetup.ts |
AgentHookRunner.cs, AgentLoopService.cs, AppSettings.cs, SettingsViewModel.cs, SettingsWindow.xaml |
Hook JSON 출력(updatedInput, updatedPermissions, additionalContext) 반영, plain text 훅 하위호환 유지, 훅 실패 비차단 유지 |
pre-hook 입력 변형과 권한 업데이트가 같은 run 안에서 즉시 적용되는지 검증 |
| B (v0.7.4) Plan/Run 상태 내구성 강화 | src/utils/plans.ts, src/utils/sessionStorage.ts |
ChatSessionStateService.cs, TaskRunService.cs, TaskRunStore.cs, ChatWindow.xaml.cs |
plan 승인/수정 이력 영속화, 재시작 후 마지막 run 지점 복원, 중복 이벤트 0건 | 실행 중 종료 후 재실행 시 같은 탭/대화에서 run 상태와 최근 이력이 일치하는지 검증 |
| C (v0.7.5) 세션/이벤트 로그 정규화 | src/utils/sessionStorage.ts, src/utils/hooks/hookEvents.ts |
ChatModels.cs, ChatSessionStateService.cs, AppStateService.cs |
이벤트 스키마 정리, replay 순서 불일치 0건, run 단위 요약 리포트 생성 가능 | 같은 세션을 여러 번 로드해도 실행 이력 순서와 상태가 변하지 않는지 검증 |
| D (v0.7.6) 명령/도구 선택 정확도 개선 | src/commands.ts, src/Tool.ts |
AgentLoopService.cs, AgentLoopParallelExecution.cs, LlmService.ToolUse.cs |
도구 별칭 정규화 강화, unknown-tool 재시도 루프 방지, 실패 유형별 복구 표준화 | 오타/별칭/비활성 도구 요청이 정상 도구로 수렴하는지 검증 |
| E (v0.8.0) 품질 게이트 정렬 | src/query.ts, src/QueryEngine.ts, src/utils/sessionStorage.ts |
AgentLoopService.cs, AgentLoopTransitions.Execution.cs, AgentLoopTransitions.cs |
코드/문서 작업 완료 게이트를 증거 기반으로 고정, 조기 완료 방지 | 코드수정/문서생성/권한거부/복구 혼합 시나리오에서 근거 기반 종료를 검증 |
4. 공통 검증 규칙
- 모든 단계에서
dotnet build경고 0 / 오류 0 - 고위험 변경마다 최소 1개 이상 재현 테스트 추가
internal/external운영 모드 정책 위반 0건
5. 즉시 착수 항목
- 내부 벤치마크 결과를 릴리즈 체크리스트에 계속 연결
Suite=ReplayStability전건 통과를 릴리즈 게이트로 유지- 계획/실행/검증 문서 간 수치와 상태 문구를 같은 기준으로 동기화
6. 최신 검증 스냅샷
- 기준 시점: 2026-04-03
dotnet test --filter "Suite=ParityBenchmark": 13/13 통과dotnet test --filter "Suite=ReplayStability": 14/14 통과dotnet test: 379/379 통과
7. 최근 보강 메모
- 2026-04-04:
/chrome,/mcp,/verify,/commit,/settings,/permissions하위 동작 정리 - 2026-04-04:
/mcp상태 라벨 표준화 및/chrome런타임 재시도 경로 보강 - 2026-04-04: 전용 AX Agent 테마 레이어 추가, 스타일/모드 분리
- 2026-04-04: 컴포저 컨텍스트 사용량 링, footer 직접
/compact, Git 상태 노출 보강 - 2026-04-04: 권한 UX, popup row 언어, 진행 이력 렌더 밀도를 더 가볍게 정리