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)
2.3 KiB
2.3 KiB
AX Agent 런타임 품질 계획
업데이트: 2026-04-15 18:20 (KST)
1. 기준
- 대상 범위: 명령 처리, 권한/훅, plan/run 내구성, 세션/로그 관리
- 문서 목적: AX Agent 런타임 경로의 품질 기준과 마감 조건을 명확히 고정
2. 주요 갭
- Hook 출력의 구조화 계약 적용 범위가 일부 경로에 아직 제한적입니다.
- 세션 재개와 이벤트 replay 품질은 시나리오별 편차가 남아 있습니다.
- 도구 선택 실패 뒤 재시도 전략의 메시지와 다음 행동이 완전히 표준화되지는 않았습니다.
3. 실행 순서
- Hook 계약 고도화
- 세션/이벤트 내구성 정리
- 실패 복구 메시지 표준화
- 완료 품질 게이트 고정
4. 완료 판정
- 내부 벤치마크 목표 성공률 충족
- 세션 재개/이벤트 재생 오류 0건
- 빌드 경고 0 / 오류 0 유지
5. 점검 스냅샷
- 기준 시점: 2026-04-03
- 계획 대비 현재 수준: 약 92~95%
- 테스트 상태:
dotnet test374/374 통과 - Hook 계약: 구현 완료 수준
- 세션/이벤트 내구성: 복원/재생 경계 케이스 테스트 반영
- 실패 복구 표준화: unknown-tool/권한/정체 경로 반영
- 완료 품질 게이트: 문서화와 코드 반영 완료
6. 관리 대상
- 도구 계층: 목록, 별칭 정규화, unknown-tool 복구, 선택 정책
- 스킬 계층: 로더, frontmatter, 파일 기반 운영, 조건부 활성화
- 훅/권한: pre/post hook 계약, permission update 반영, ask/auto/deny 일관성
- 세션/상태: run 복원, 이벤트 replay, 중복 억제, resume 신뢰성
- 계획/실행: plan 승인/수정 이력, 실행 게이트, 조기 완료 방지
- MCP/외부도구: 연결, 리소스 조회, 실패 복구, internal 정책
- 설정/UI 연동: 설정값, 실행 코드, UI 반영 동기화
7. 다음 순서
- Agentic loop E2E 시나리오를 회귀 테스트로 계속 고정
- 벤치마크 합격 기준과 증적을 배포 체크리스트에 연결 유지
- 수치와 상태 문구를
README.md,docs/DEVELOPMENT.md, 로드맵 문서와 동기화
8. 운영 기준
- 내부 벤치마크와 replay 안정성 테스트는 릴리즈 전 최소 조건으로 유지
- 문서에는 비교·모사 표현보다 AX 기준 완료 조건과 검증 결과만 기록