SK-Intellix Book First-Cut Gate
이 문서는 SK-Intellix 위키를 책자 형태로 정리할 때 “1차로 정리되었다고 끊을 수 있는 기준”을 고정한다.
목적은 문서를 계속 추가하는 것이 아니라, 현재까지의 A2A, context-aware planner, Agent/Skills, 복합제어, Speech-LLM, On-device Bridge, DeviceAgent/SoC, Memory, Vendor, Validation 자료가 서로 연결되어 읽히는지 판단하는 것이다.
1. 1차 책자 범위
1차 책자는 아래 질문에 답할 수 있으면 끊는다.
| 질문 | 기준 문서 | 1차 판정 |
|---|---|---|
| 전체 시스템은 어떤 큰 장으로 나뉘는가 | SK-Intellix Book Shelf, Knowledge Category Map | 충족 |
| A2A가 selector가 아니라 planner라는 점이 설명되는가 | A2A Category, A2A Book Roadmap, Planner and Routing | 충족 |
| Speech/STT, context, memory, planner, Agent/Skill, 복합제어가 한 흐름으로 연결되는가 | Speech-LLM Context-Aware A2A Architecture | 충족 |
| 복합명령이 Cloud-only, device-only, mixed case로 설명되는가 | Scenario Walkthroughs, Device Task Flow | 충족 |
| On-device Bridge와 DeviceAgent/SoC 책임이 분리되는가 | On-device Bridge Category, DeviceAgent / SoC Category, SoC TaskManager Framework | 충족 |
| 업체가 무엇을 구현해야 하는지 전달 가능한가 | Vendor Category, DeviceAgent Vendor Implementation Package, Vendor API Acceptance Checklist | 충족 |
| 구현 근거와 검증 공백이 분리되어 있는가 | Source and Evidence Catalog, Validation Category, Status and Gap Audit | 충족 |
| 다음 작업이 무엇인지 보이는가 | A2A Next Action Board, Work Breakdown | 충족 |
2. 책의 장 구성
현재 1차 책자는 아래 순서로 읽는다.
| Part | 장 | 핵심 메시지 |
|---|---|---|
| 0 | Orientation | SK-Intellix 전체 분류와 진입점 |
| 1 | Executive Overview | 현재 결론, 리스크, 다음 액션 |
| 2 | Speech-LLM Context-Aware A2A | Speech 발화가 context-aware plan으로 바뀌는 전체 loop |
| 3 | Cloud A2A Planner/Runtime | route family, multi-step, agent/skill, device request 변환 |
| 4 | On-device Bridge | Cloud plan을 device intent workflow로 안전하게 연결 |
| 5 | DeviceAgent / SoC TaskManager | 실제 queue, condition, callback, reason code, domain execution |
| 6 | Composite Control Case Studies | Cloud-only, device-only, mixed, 19.comToMe 예시 |
| 7 | Memory / Personalization | short/mid/long memory와 DB/sync 방향 |
| 8 | Vendor Handoff | 업체 구현 범위, API 인수 기준, 제출 증거 |
| 9 | Validation / Evidence | source/test/artifact/gap 기준 |
| Appendix | Operations | llmwiki, Codex, 배포/접속 운영 |
3. 장별 입출력 연결
책자형 구조는 “문서 링크 모음”이 아니라 장 사이의 입력/출력이 이어져야 한다.
| 장 | 입력 | 출력 | 다음 장으로 넘기는 것 |
|---|---|---|---|
| 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 실행 요청 |
| 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차 책자 정리 범위에서는 완료로 본다.
- 상위 허브와 카테고리 분류가 있다.
- A2A, On-device, DeviceAgent/SoC, Memory, Vendor, Validation이 분리되어 있다.
- A2A 내부 읽기 순서가 있다.
- Speech-LLM context-aware loop가 별도 문서와 SVG로 존재한다.
- 복합제어의
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 |
| Memory DB 구현 완료 | migration/repository/sync worker/privacy test 필요 | Memory DB and Sync 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 대조표 |
| 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: 아님
따라서 다음부터는 “위키 전체 구조를 계속 다듬기”보다, 이 문서를 기준으로 후속 작업 단위를 하나씩 선택해 진행한다.