SK-Intellix Book Shelf
이 문서는 SK-Intellix 위키를 “책처럼” 읽기 위한 상위 목차다.
기존 A2A Book Roadmap은 A2A 카테고리 내부의 읽기 순서다. 이 문서는 그보다 한 단계 위에서 SK-Intellix 전체 지식 영역을 본문, 도메인 장, 검증 장, 부록으로 나눈다.
1. 전체 책 구조
| Part | 제목 | 목적 | 시작 문서 |
|---|---|---|---|
| 0 | Orientation | 전체 진입점과 분류 기준 | Engineering Hub, Category Map |
| 1 | First-Cut Gate | 1차 책자형 정리를 어디서 끊을지 판단 | Book First-Cut Gate |
| 2 | Executive Overview | 현재 결론과 리스크를 빠르게 파악 | A2A Executive Summary |
| 3 | Speech-LLM Context-Aware A2A | STT/context/planner/Agent/Skills/복합제어가 한 loop로 이어지는 구조 | Speech-LLM Context-Aware A2A Architecture |
| 4 | Cloud A2A | 발화를 route/plan/task로 바꾸는 Cloud 지능 계층 | A2A Category, A2A Hub |
| 5 | On-device Bridge | Cloud 응답을 기기 실행 요청으로 연결 | On-device Bridge Category |
| 6 | DeviceAgent / SoC | 실제 task queue, callback, reason, domain 실행. 업체 구현/프레임워크화는 SoC TaskManager Framework에서 확인 | DeviceAgent / SoC Category, SoC TaskManager Framework |
| 7 | Memory / Personalization | 이전 맥락과 사용자 특성 관리 | Memory Category |
| 8 | 19.comToMe Case Study | 복합명령/이동/화자 인식 예시 | 19.comToMe Workflow Example |
| 9 | Vendor Handoff | 업체 구현/검증/인수 기준 | Vendor Category |
| 10 | Validation and Evidence | 요구사항, source, test, artifact 추적 | Validation Category, Source and Evidence Catalog |
| Appendix A | Operations | llmwiki, Codex 전역 설정, 서버 운영 | Operations Category |
| Appendix B | A2A Detail Book | A2A 내부 상세 읽기 순서 | A2A Book Roadmap |
2. 본문과 부록의 차이
| 구분 | 포함 문서 | 읽는 목적 |
|---|---|---|
| 본문 | Engineering Hub, Category Map, A2A, On-device, DeviceAgent, Memory | 시스템을 이해하고 설계 판단을 공유 |
| 사례 | 19.comToMe | 구체 기능을 전체 구조에 대입 |
| 실행 계약 | Contract, Device Task Flow, TaskManager API | 구현자가 payload/API/event를 맞춤 |
| 검증 | Validation, Evidence, Traceability, Benchmark | 완료 여부와 리스크를 판단 |
| 업체 부록 | Vendor package/checklist/template/open questions | 외부 업체에 전달하고 받을 산출물을 관리 |
| 운영 부록 | Global Wiki Operations, Local Access, Documentation Audit | 위키와 Codex 작업 환경을 유지 |
3. 독자별 읽는 순서
| 독자 | 읽는 순서 |
|---|---|
| 전체 의사결정자 | Engineering Hub -> Executive Summary -> Category Map -> Validation |
| Cloud A2A 개발자 | Book First-Cut Gate -> A2A Category -> A2A Book Roadmap -> Planner/Routing -> Device Task Flow |
| 온디바이스 개발자 | On-device Bridge Category -> Contract Matrix -> Scenario Walkthroughs -> Validation |
| DeviceAgent/SoC 업체 | DeviceAgent / SoC Category -> SoC TaskManager Framework -> Vendor Implementation Workbook -> Acceptance Checklist |
| 메모리/개인화 담당 | Memory Category -> Memory DB and Sync Contract -> Source and Evidence Catalog |
| QA/SQA | Validation Category -> Evidence Catalog -> Requirements Traceability -> Vendor Test Evidence Template |
| Codex/위키 운영자 | Operations Category -> Global Wiki Operations -> Local Access -> Documentation Quality Audit |
4. 현재 배치 정책
현재 상세 문서는 아직 docs/a2a/에 많이 남아 있다. 그러나 책의 논리 구조는 이미 docs/sk-intellix/에서 분리한다.
대량 파일 이동을 바로 하지 않는 이유:
- 기존 URL을 유지해야 한다.
- 브라우저 링크와 SVG 참조를 한 번에 깨뜨릴 위험이 있다.
- 상세 문서의 실제 소유 카테고리를 먼저 안정화해야 한다.
- ADB/업체 evidence가 들어오면 문서 구조가 다시 바뀔 수 있다.
따라서 현재 단계의 원칙은 다음과 같다.
1. SK-Intellix 상위 허브와 카테고리 문서로 논리 구조를 먼저 확정한다.
2. 기존 A2A 상세 문서는 URL을 보존한다.
3. 새 대형 주제는 처음부터 SK-Intellix 카테고리 아래에 만든다.
4. 문서 이동은 링크 안정성과 evidence 확정 이후 별도 migration으로 수행한다.
5. 다음 편집 우선순위
| 우선순위 | 작업 | 이유 |
|---|---|---|
| P0 | Book First-Cut Gate를 기준으로 1차 책자 baseline을 고정 | 무한 반복 정리를 막고 다음 구현/검증 작업으로 전환 |
| P0 | 각 카테고리 landing page에 “입력/출력/상태/이벤트/증거” 표 추가 | 책처럼 읽히려면 장마다 같은 구조가 필요 |
| P0 | Evidence Catalog를 최신 source 변경과 맞춰 갱신 | 문서-구현 불일치 방지 |
| P1 | A2A 상세 문서 중 On-device/DeviceAgent/Vendor 성격이 강한 문서에 상위 카테고리 backlink 추가 | 독자가 길을 잃지 않게 함 |
| P1 | ADB/실기기 evidence 수집 후 Validation/Evidence 장 갱신 | 현재 가장 큰 검증 공백 |
| P2 | 필요 시 docs/ondevice, docs/deviceagent, docs/memory, docs/vendor 실제 디렉터리 분리 |
URL 이동 비용이 커서 후순위 |