SK-Intellix Book First-Cut Gate
이 문서는 SK-Intellix 위키를 책자 형태로 정리할 때 “1차로 정리되었다고 끊을 수 있는 기준”을 고정한다.
목적은 문서를 계속 추가하는 것이 아니라, 현재까지의 Framework/SDK, A2A, context-aware planner, Agent/Skills, 복합제어, Speech-LLM, On-device Bridge, DeviceAgent/SoC, Memory, Vendor, Validation 자료가 서로 연결되어 읽히는지 판단하는 것이다.
1. 1차 책자 범위
1차 책자는 아래 질문에 답할 수 있으면 끊는다.
2. 책의 장 구성
현재 1차 책자는 아래 순서로 읽는다.
| Part | 장 | 핵심 메시지 |
|---|---|---|
| 0 | Orientation | SK-Intellix 전체 분류와 진입점 |
| 1 | Executive Overview | 현재 결론, 리스크, 다음 액션 |
| 2 | Framework / SDK Product Spine | A1 DeviceAgent API/runtime, peer agent, QSSI/UM/HAL/BSP를 후보 SDK와 platform release 기준으로 정리 |
| 3 | Speech-LLM Context-Aware A2A | Speech 발화가 context-aware plan으로 바뀌는 전체 loop |
| 4 | Cloud A2A Planner/Runtime | route family, multi-step, agent/skill, device request 변환 |
| 5 | Reactive / Proactive Operation | user speech와 signal bundle이 어떻게 같은 A2A 생태계로 들어오는지 |
| 6 | On-device Bridge | Cloud plan을 device intent workflow로 안전하게 연결 |
| 7 | DeviceAgent / SoC TaskManager | 실제 queue, condition, callback, reason code, domain execution |
| 8 | Composite Control Case Studies | Cloud-only, device-only, mixed, 19.comToMe 예시 |
| 9 | Memory / Personalization | short/mid/long memory와 DB/sync 방향 |
| 10 | Vendor / Platform Enablement | 업체 구현 범위, AOSP/HAL/DTS/driver, API 인수 기준, 제출 증거 |
| 11 | Validation / Evidence | source/test/artifact/gap 기준 |
| Appendix | Operations | llmwiki, Codex, 배포/접속 운영 |
3. 장별 입출력 연결
책자형 구조는 “문서 링크 모음”이 아니라 장 사이의 입력/출력이 이어져야 한다.
| 장 | 입력 | 출력 | 다음 장으로 넘기는 것 |
|---|---|---|---|
| Framework / SDK | A1 package source map, DeviceAgent/peer agent/Platform Vendor BSP 자료 | DeviceAgent API/runtime layer, 후보 SDK contract, platform enablement work package | 각 도메인별 구현/검증 기준 |
| Speech-LLM Context | recognized_text, voice_context, device_context, memory_snapshot |
context-aware 판단 loop | Planner 입력 우선순위 |
| Planner/Runtime | 발화/context/capability | turn_mode, selected_routes, steps[], device_task_requests |
Bridge/Agent 실행 요청 |
| Reactive/Proactive | user speech 또는 signal bundle | reactive turn, proactive recommendation/confirmation/execute/schedule/suppress | Planner/Runtime 또는 proactive runtime decision |
| Agent & Skills | route family와 step purpose | Cloud-only answer, device intent, unsupported 안내, mode handoff | Runtime 실행 결과와 event |
| On-device Bridge | device_intent_step, token/task request |
local workflow, DeviceAgent 호출, progress UI | DeviceAgent task/workflow |
| DeviceAgent / SoC | task/workflow bundle | native execution, onTaskEvent, reason_code |
Cloud event/replan gate |
| Memory | turn/result/event summary | short/mid/long memory update | 다음 turn context |
| Validation | source/test/artifact | pass/fail/gap 판정 | 다음 작업 backlog |
4. 1차 완료로 보아도 되는 것
아래는 1차 책자 정리 범위에서는 완료로 본다.
- 상위 허브와 카테고리 분류가 있다.
- Framework/SDK 최종 목표와 A1 package composition이 별도 허브에 정리되어 있다.
- 위키 구조 레벨과 각 페이지의 책임이 정의되어 있다.
- 주요 아키텍처 아이디어의 배경과 구축 이점이 설명되어 있다.
- A2A, On-device, DeviceAgent/SoC, Memory, Vendor, Validation이 분리되어 있다.
- A2A 내부 읽기 순서가 있다.
- Speech-LLM context-aware loop가 별도 문서와 SVG로 존재한다.
- Reactive/proactive 운영 축과 proactive source integration gap이 분리되어 있다.
- 복합제어의
depends_on,input_from,execution_target,wait_policy기준이 정리되어 있다. - DeviceAgent/SoC TaskManager 업체 구현 기준과 API/checklist/test evidence가 있다.
- source/evidence/gap/next action이 분리되어 있다.
llmwiki build와llmwiki lint로 정적 사이트 생성 가능성이 검증된다.
5. 1차 완료로 보면 안 되는 것
아래는 1차 책자 정리의 범위를 넘어서는 후속 작업이다.
| 항목 | 이유 | 후속 문서 |
|---|---|---|
| ADB 실기기 E2E 완료 | 현재 단말 연결/실행 artifact가 필요 | Validation Category, Validation Guide |
| 최신 router full benchmark 영구 보존 | prompt/모델/네트워크 상태별 결과 artifact 필요 | Benchmark and Router Evolution |
| Proactive runtime 제품 통합 완료 | 현재 작업 브랜치와 proactive_planner 브랜치의 source/schema/test 통합 증거 필요 |
Reactive and Proactive Operation, Source and Evidence Catalog |
| Memory DB 구현 완료 | migration/repository/sync worker/privacy test 필요 | Memory DB and Sync Contract |
| 실제 SDK AAR 구현 완료 | library module, mock transport, sample app, Gradle test evidence 필요 | Framework and SDK Hub, SDK Contract |
| 업체 구현 완료 | 실제 업체 diff, API response, device callback evidence 필요 | Vendor Category |
| SoC/AOSP 전체 프레임워크 분석 완료 | init/service/HAL/AIDL/SELinux 범위가 방대함 | 향후 별도 SoC/AOSP book |
| 실제 19.comToMe product implementation 완료 | stage gate, speaker/location/DoA/Vision/AMR callback 확정 필요 | 19.comToMe DeviceAgent Contract |
6. 1차 이후 작업 단위
1차 책자를 끊은 뒤에는 문서 추가가 아니라 아래 작업 단위로 진행한다.
| 우선순위 | 작업 단위 | 완료 증거 |
|---|---|---|
| P0 | ADB 실기기 복합명령 E2E | logcat, callback payload, artifact validator 결과 |
| P0 | Router benchmark snapshot 고정 | prompt snapshot, test data, family별 성공률, 실패 샘플 |
| P0 | Agent/Skill runtime drift 점검 | prompt/schema/runtime agent catalog 대조표 |
| P0 | Framework/SDK MVP skeleton | AAR module, model/adapter tests, sample client |
| P0 | Reactive/proactive source integration check | 현재 브랜치와 proactive_planner 브랜치 대조, proactive fixture 결과 |
| P1 | Memory DB implementation | migration, repository, sync worker, delete/privacy tests |
| P1 | DeviceAgent vendor implementation review | 업체 diff, unit/instrumented test, reason code evidence |
| P2 | SoC/AOSP architecture book | init/service/HAL/AIDL/SELinux structure |
7. 1차 컷 판정
현재 문서 구조는 1차 책자형 정리 관점에서는 끊을 수 있는 상태다.
단, 제품 통합 완료 상태는 아니다. 현재 판정은 아래처럼 분리한다.
Book first-cut: 가능
Architecture sharing: 가능
Vendor handoff discussion: 가능
Implementation complete: 아님
Real-device E2E complete: 아님
따라서 다음부터는 “위키 전체 구조를 계속 다듬기”보다, 이 문서를 기준으로 후속 작업 단위를 하나씩 선택해 진행한다.
8. 관련 문서
- SK-Intellix Engineering Hub
- SK-Intellix Wiki Structure Map
- Architecture Rationale and Benefits
- SK-Intellix Book Shelf
- Knowledge Category Map
- Reactive and Proactive Operation
- Source and Evidence Catalog
- Speech-LLM Context-Aware A2A Architecture
- A2A Book Roadmap
- Status and Gap Audit
- Documentation Quality Audit