A2A Documentation Quality Audit
이 페이지는 A2A Wiki가 “작업 로그 모음”을 넘어 “책처럼 읽히는 구조 문서”가 되었는지 점검한다.
현재 진행률 판단
현재 A2A 브라우저 문서화는 대략 90~93% 수준으로 본다.
완료에 가까운 영역:
- 전체 구조와 레이어 책임 설명.
- 회의/업체 공유용 Executive Summary.
- 전역 위키 저장소, 다른 Codex 창에서의 갱신 방식, build/lint/서버 운영 절차.
- Planner/Router 판단 기준.
- Cloud Runtime과 device request 계약.
- On-device Bridge와 DeviceAgent TaskManager 경계.
- 정상 event와 replan event 정책.
- 실제 시나리오 walkthrough.
/home/silogood/work/19.comToMe폴더 내용을 바탕으로 한 ComeToMe A2A workflow 예시 문서와 SVG.- 접속/서버 상태 문제 해결 안내.
- 업체 전달/업무 분장/상태 공백 정리.
- SVG 기반 전체 시각 지도와 주요 항목별 구조도.
- 함수/API 단위 Source Map과 핵심 call chain line range.
- 업체 패키지 내 주요 DeviceAgent/On-device 소스 라인 근거.
- SoC 관점의
TaskManager실행 서브시스템 장. - DeviceAgent 내부
task/,moving/,cleaning/,map/,schedule/,interaction/도메인 지도. - 19.comToMe의 Cloud intent, On-device bridge, DeviceAgent TaskManager, DoA/Vision/AMR/FollowMe callback/reason 계약을 분리한 구현 계약 문서.
- 각 Wiki 장과 실제 설계/소스/검증 근거를 연결하는 Evidence Index.
- PM/아키텍트, Cloud, 온디바이스, DeviceAgent/SoC 업체, QA/SQA, Memory 담당자가 각자 어디부터 읽어야 하는지 정리한 역할별 Reader Path.
- 요구사항 추적 매트릭스와 다음 액션 보드.
- Speech-LLM, context-aware planner, Agent/Skills, 복합제어를 한 흐름으로 묶는 상위 구조 문서와 SVG.
- SK-Intellix 책자형 1차 컷 기준을 고정한 Book First-Cut Gate.
아직 남은 영역:
- 테스트/benchmark artifact와 연결된 source-backed 주석.
- SoC/AOSP 전체 구조의
init, service registration, partition, HAL/AIDL, SELinux 경계 분석. - ADB 실기기 E2E artifact가 붙은 운영 증거.
- 최신 benchmark 결과 파일과 family별 실패 샘플의 영구 보존.
- Memory DB schema는 분리됨. 아직 DB migration/repository/sync worker 구현 산출물은 없음.
커버리지 매트릭스
가시성 감사
| 항목 | 결과 |
|---|---|
| 브라우저 진입점 | http://127.0.0.1:8767/docs/a2a/로 명시 |
| 목차 | Hub와 Book Roadmap에 정리 |
| 시각 자료 | Visual Map SVG와 주요 항목별 SVG 구조도 19개 추가 |
| 역할별 탐색 | Work Breakdown과 Vendor Handoff로 분리 |
| 상태/공백 | Status and Gap Audit으로 분리 |
| 다음 작업 | Next Action Board로 분리 |
| 실제 예시 | Scenario Walkthroughs로 분리 |
| 검색 가능성 | docs page로 빌드되어 search-index에 포함 |
| 서버 장애 대응 | Local Access Guide에 정리 |
검증 증거
마지막 검증에서 확인한 항목:
llmwiki build: 성공
site/docs/a2a/local-access.html: 생성됨
site/docs/a2a/visual-map.html: 생성됨
site/docs/a2a/visual-map.svg: 생성됨
site/docs/a2a/executive-summary.html: 생성됨
site/docs/a2a/executive-summary.svg: 생성됨
site/docs/a2a/global-wiki-operations.html: 생성됨
site/docs/a2a/architecture-diagrams.html: 생성됨
site/docs/a2a/system-overview.svg: 생성됨
site/docs/a2a/planner-routing.svg: 생성됨
site/docs/a2a/benchmark-router.svg: 생성됨
site/docs/a2a/contracts.svg: 생성됨
site/docs/a2a/device-task-flow.svg: 생성됨
site/docs/a2a/scenario-walkthroughs.svg: 생성됨
site/docs/a2a/legacy-command-19-workflow-example.html: 생성됨
site/docs/a2a/legacy-command-19-workflow-example.svg: 생성됨
site/docs/a2a/cometome-deviceagent-contract.html: 생성됨
site/docs/a2a/cometome-deviceagent-contract.svg: 생성됨
site/docs/a2a/evidence-index.html: 생성됨
site/docs/a2a/evidence-index.svg: 생성됨
site/docs/a2a/role-based-reader-paths.html: 생성됨
site/docs/a2a/role-based-reader-paths.svg: 생성됨
site/docs/a2a/deviceagent-taskmanager-api-contract.svg: 생성됨
site/docs/a2a/soc-taskmanager-execution-subsystem.html: 생성됨
site/docs/a2a/soc-taskmanager-execution-subsystem.svg: 생성됨
site/docs/a2a/deviceagent-soc-domain-map.html: 생성됨
site/docs/a2a/deviceagent-soc-domain-map.svg: 생성됨
site/docs/a2a/vendor-handoff.svg: 생성됨
site/docs/a2a/vendor-implementation-package.svg: 생성됨
site/docs/a2a/source-map.svg: 생성됨
site/docs/a2a/requirements-traceability.svg: 생성됨
site/docs/a2a/next-action-board.html: 생성됨
site/docs/a2a/work-breakdown.svg: 생성됨
site/docs/a2a/status-gap-audit.svg: 생성됨
site/docs/a2a/memory-personalization.svg: 생성됨
site/docs/a2a/memory-db-sync.svg: 생성됨
site/docs/a2a/validation.svg: 생성됨
http://127.0.0.1:8767/docs/a2a/local-access.html: 200 OK
http://127.0.0.1:8767/docs/a2a/visual-map.html: 200 OK
http://127.0.0.1:8767/docs/a2a/visual-map.svg: 200 OK
http://127.0.0.1:8767/docs/a2a/executive-summary.html: 200 OK
http://127.0.0.1:8767/docs/a2a/global-wiki-operations.html: 200 OK
http://127.0.0.1:8767/docs/a2a/architecture-diagrams.html: 200 OK
http://127.0.0.1:8767/docs/a2a/planner-routing.svg: 200 OK
http://127.0.0.1:8767/docs/a2a/device-task-flow.svg: 200 OK
http://127.0.0.1:8767/docs/a2a/cometome-deviceagent-contract.html: 200 OK
http://127.0.0.1:8767/docs/a2a/evidence-index.html: 200 OK
http://127.0.0.1:8767/docs/a2a/role-based-reader-paths.html: 200 OK
http://127.0.0.1:8767/docs/a2a/legacy-command-19-workflow-example.html: 200 OK
http://127.0.0.1:8767/docs/a2a/: 200 OK
llmwiki lint: 0 errors, 0 warnings
문서 품질 기준
이 위키의 A2A 파트는 아래 기준을 만족해야 한다.
- 개념 설명만 있지 않고 실제 repo/source 위치로 이어져야 한다.
- 구조도와 예시가 함께 있어야 한다.
- Cloud, 온디바이스, DeviceAgent 책임이 섞이지 않아야 한다.
- 정상 흐름과 실패/replan 흐름이 분리되어야 한다.
- “현재 완료”와 “아직 검증 필요”가 같은 문서 안에서 혼동되지 않아야 한다.
- 업체가 해야 할 일과 내부 개발자가 해야 할 일이 구분되어야 한다.
남은 개선 우선순위
- 실제 ADB E2E가 가능해지면 logcat artifact와 validator 결과를
Validation Guide와Status Gap Audit에 붙인다. - Router benchmark 최신 결과를 versioned page로 고정한다.
- Memory DB migration, repository, sync worker, tests가 생기면
Memory DB and Sync Contract에 구현 근거를 붙인다. - SoC/AOSP 하위 도메인을 map/movement/cleaning/schedule 단위로 나눠 문서화한다.
- full AOSP 관점의 init/service/partition/HAL/AIDL/SELinux 배치를 별도 문서화한다.
- 실제 19.comToMe의
comeToMemethod, stage gate, speaker/location/DoA/Vision/AMR/FollowMe callback 계약이 확정되면 예시 payload를 실제 구현명으로 갱신한다. - 테스트/benchmark artifact를 Source Map의 관련 함수와 직접 연결한다.
현재 판정
현재 상태는 “A2A 설계와 현재 구현 방향을 책자형 baseline으로 설명하고 공유하기에는 충분”하다. 다만 “실제 제품 통합 완료 문서”로 보려면 실기기 E2E 증거와 최신 benchmark artifact가 더 필요하다.