SK-Intellix Book Shelf
이 문서는 SK-Intellix 위키를 “책처럼” 읽기 위한 상위 목차다.
기존 A2A Book Roadmap은 A2A 카테고리 내부의 읽기 순서다. 이 문서는 그보다 한 단계 위에서 SK-Intellix 전체 지식 영역을 본문, 도메인 장, 검증 장, 부록으로 나눈다.
1. 전체 책 구조
| Part | 제목 | 목적 | 시작 문서 |
|---|---|---|---|
| 0 | Presentation Storyline | 팀 공유/전체 서사 | A2A Presentation Storyline |
| 0-1 | Orientation | 전체 진입점과 분류 기준 | Engineering Hub, Category Map |
| 1 | Domain Reading Order | 도메인 간 순서와 각 도메인 내부 7단계 읽기 문법 | Domain Reading Order |
| 1-1 | Wiki Structure | 이 위키의 레벨, 페이지 책임, 독자 흐름 | Wiki Structure Map |
| 2 | Rationale and Benefits | 왜 이 구조가 필요하고 구축하면 무엇이 좋아지는가 | Architecture Rationale and Benefits |
| 3 | First-Cut Gate | 1차 책자형 정리를 어디서 끊을지 판단 | Book First-Cut Gate |
| 4 | Framework / SDK Product Spine | A1 DeviceAgent API/runtime, peer agent, QSSI/UM/HAL/BSP를 SDK 후보와 platform release 기준으로 정리 | Framework and SDK Hub |
| 5 | Executive Overview | 현재 결론과 리스크를 빠르게 파악 | A2A Executive Summary |
| 6 | Speech-LLM Context-Aware A2A | STT/context/planner/Agent/Skills/복합제어가 한 loop로 이어지는 구조 | Speech-LLM Context-Aware A2A Architecture |
| 7 | Reactive / Proactive Operation | 사용자 발화 기반 reactive turn과 signal 기반 proactive turn의 운영 구조 | Reactive and Proactive Operation |
| 8 | Cloud A2A | 발화를 route/plan/task로 바꾸는 Cloud 지능 계층 | A2A Category, A2A Hub |
| 8-1 | Experience Goal | 여러 step과 Agent 뒤에도 사용자 결과와 성공 증거 보존 | Experience Goal Category |
| 9 | On-device Bridge | Cloud 응답을 기기 실행 요청으로 연결 | On-device Bridge Category |
| 10 | DeviceAgent / SoC | 실제 task queue, callback, reason, domain 실행. 업체 구현/프레임워크화는 SoC TaskManager Framework에서 확인 | DeviceAgent / SoC Category, SoC TaskManager Framework |
| 11 | Speech / Audio | 음성 텍스트 경로와 SoundFlow acoustic evidence 분리 | Speech, Audio / SoundFlow |
| 12 | Identity / Memory | 화자 맥락, 권한, 이전 대화와 사용자 특성 관리 | Speaker Identity, Memory |
| 13 | PoC / Cases | 제품 편입 전 실험과 cross-domain 사례 | PoC Lab, 19.comToMe Workflow |
| 14 | Vendor / Platform Enablement | 업체 구현/검증/인수 기준, AOSP/HAL/DTS/driver 범위 | Vendor Category, QCS6490 Platform Vendor Brief |
| 15 | 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, Framework/SDK, 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 -> Domain Reading Order -> Architecture Rationale -> Experience Goal Category -> Validation |
| Framework/SDK 개발자 | Framework/SDK Hub -> System Design -> SDK Contract -> Transformation Roadmap -> Source and Evidence Catalog -> DeviceAgent / SoC Category |
| Cloud A2A 개발자 | Domain Reading Order -> A2A Category -> Planner/Routing -> Contract -> Device Task Flow -> Validation |
| 온디바이스 개발자 | On-device Bridge Category -> Contract Matrix -> Scenario Walkthroughs -> Validation |
| DeviceAgent/SoC 업체 | DeviceAgent / SoC Category -> QCS6490 Platform Vendor Brief -> SoC TaskManager Framework -> Vendor Implementation Workbook -> Acceptance Checklist |
| AOSP/HAL/DTS 업체 | QCS6490 Platform Vendor Brief -> Framework/SDK Hub의 Platform Enablement 그림 -> Vendor Category -> Source and Evidence Catalog |
| 메모리/개인화 담당 | 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 |
3.1 이번 Framework/SDK 문서 배치
이번에 추가한 framework-sdk/ 문서는 Part 4의 제품 spine이다.
QCS6490 Platform Vendor Brief는 Part 13의 vendor/platform enablement 문서지만, Framework/SDK Hub에서도 같이 읽는다.
| 문서 | 책 안에서의 위치 | 이유 |
|---|---|---|
| Framework and SDK Hub | Part 4 Framework / SDK Product Spine | A1 package, DeviceAgent product-level service hub, peer agent, QSSI/UM/HAL/BSP 연결 |
| Framework SDK System Design | Part 4 상세 설계 | DeviceAgent API/runtime, service agent topology, platform enablement, release gate 책임 경계 |
| SDK Contract | Part 4 실행 계약 | 현재 DeviceControlAPIJavaLib와 IDeviceControl 위에 둘 수 있는 후보 SDK 계약 |
| Transformation Roadmap | Part 4 전환 계획 | A1 package와 기존 DeviceAgent 구조를 SDK product로 옮기는 단계 |
| QCS6490 Platform Vendor Brief | Part 13 Vendor / Platform Enablement | QSSI/UM, HAL, DTS, driver, device evidence 제출 범위 |
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 | Domain Reading Order와 허브 coverage test 유지 | 문서 추가 시 누락과 순서 회귀 방지 |
| 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 이동 비용이 커서 후순위 |
6. 관련 문서
- SK-Intellix Engineering Hub
- SK-Intellix Wiki Structure Map
- Architecture Rationale and Benefits
- Reactive and Proactive Operation
- SK-Intellix Book First-Cut Gate
- SK-Intellix Knowledge Category Map
- SK-Intellix Domain Reading Order
- SK-Intellix Source and Evidence Catalog
- SK-Intellix Document Migration Roadmap
- A2A Book Roadmap
- Validation Category