SK-Intellix Knowledge Category Map
이 문서는 SK-Intellix 위키의 지식 분류 기준을 정의한다. 핵심은 A2A가 최상위가 아니라 SK-Intellix 내부의 큰 카테고리 중 하나라는 점이다.
1. 최상위 분류 원칙
문서를 기능 이름이 아니라 책임 경계로 나눈다.
| 분류 기준 | 설명 |
|---|---|
| 제품/시스템 관점 | SK-Intellix 전체를 설명하는 최상위 개요 |
| Framework / SDK | A1 DeviceAgent API/runtime, peer agent, QSSI/UM/HAL/BSP 경계를 정리하고 현재 client API를 SDK 후보로 안정화하는 기준 |
| Cloud 판단/계획 | A2A planner, router, runtime orchestration |
| 목표 연속성/Experience | 여러 Agent와 task 뒤에도 사용자 결과, effect, 성공 증거를 보존 |
| 음성인식 모듈 | STT, 딕셔너리/전처리, 온디바이스 LLM, Cloud fallback/rewrite, TTS, E2E log analysis |
| Audio/SoundFlow | processed PCM, AFE, Kardome, capture continuity, acoustic evidence |
| 화자인식/사용자 식별 | speaker enrollment, diarization, speaker_context, speaker-scoped memory, 권한/개인화 |
| 온디바이스 연결 | Cloud 응답을 기기 실행 요청으로 바꾸는 bridge |
| DeviceAgent/SoC 실행 | 실제 task queue, callback, reason, domain execution. SoC 실행 프레임워크화까지 이 분류 안에서 관리 |
| AOSP/BSP/HAL | QSSI/UM split build, platform vendor overlay, vendor HAL/service, init/VINTF/sepolicy, DTS/driver |
| 메모리/개인화 | 이전 맥락, 사용자 특성, DB/sync/delete 정책 |
| 검증/품질 | benchmark, unit, dry-run, ADB, evidence |
| 업체 회의/전달 | API 계약, 인수 기준, 제출 evidence, open question, 회의 순서 |
| 운영/위키 | llmwiki 저장소, 전역 Codex 규칙, build/lint/server |
| PoC | 제품 병합 전 독립 실험, 도구, 검증 후보 |
2. 현재 카테고리
| 코드 | 카테고리 | 시작 문서 | 역할 |
|---|---|---|---|
INTELLIX |
전체 제품/엔지니어링 허브 | SK-Intellix Engineering Hub | 모든 자료의 최상위 목차 |
CROSS_DOMAIN |
Cross-Domain Integration | Cross-Domain Integration Map | 분리된 도메인 사이의 발전 흐름과 연관 모듈 |
FRAMEWORK_SDK |
SK-Intellix Framework / SDK | Framework and SDK Hub | A1 DeviceAgent product-level service hub, 현재 DeviceControlAPI, 후보 SDK, QSSI/UM platform enablement, release gate |
A2A |
Cloud A2A / Planner | A2A Category, A2A Hub | 발화를 route/plan/task로 바꾸는 Cloud 지능 계층 |
EXPERIENCE |
Experience Goal | Experience Goal Category | 상위 사용자 결과, effect, observation, 제한 재판단 |
SPEECH |
Speech Recognition Module | Speech Recognition Module | STT, 딕셔너리, 온디바이스/Cloud LLM 경계, TTS, E2E 운영 로그 |
AUDIO |
Audio / SoundFlow / Kardome | Audio and SoundFlow Category | processed PCM, capture continuity, acoustic/decoder evidence, field tuning |
SPEAKER_IDENTITY |
Speaker Identity / User Context | Speaker Identity Service | 화자 등록/식별, speaker_context, 권한/개인화, speaker memory |
ONDEVICE |
On-device Bridge | On-device Bridge Category | Cloud와 실제 기기 사이 payload/token/task 연결 |
DEVICEAGENT |
DeviceAgent / SoC TaskManager | DeviceAgent / SoC Category, SoC TaskManager Framework | queue, workflow, callback, reason_code, 기기 domain 실행, multi-source ingress, 장기 프레임워크화 기준 |
AOSP_BSP |
AOSP / BSP / HAL | AOSP and BSP Category | QCS6490 QSSI/UM, platform vendor overlay, HAL/service, DTS/driver, release evidence |
MEMORY |
Memory / Personalization | Memory Category | pair/session/day/week/profile memory와 DB/sync |
VENDOR |
Vendor Meeting / Handoff | Vendor Meeting Entry, Vendor Category | 업체 회의 순서, 구현/검증/인수 기준 |
VALIDATION |
Validation / Evidence | Validation Category | 테스트, benchmark, evidence, gap audit |
OPERATIONS |
Wiki / Codex Operations | Operations Category | 전역 wiki root, Codex 창 간 공유, build/lint 운영 |
POC |
PoC Lab | PoC Lab | 독립 검증 도구와 제품 편입 전 실험 |
FINDER |
Document Finder | Document Finder | 전역 검색, 추천 검색어, 애매한 검색어 분리 기준 |
READING_ORDER |
Domain Reading Order | Domain Reading Order | 도메인 간 순서와 도메인 내부 7단계 배열 기준 |
DOC_MAP |
Domain Document Map | Domain Document Map | 전체 문서 primary domain, 관련 domain, target folder, 누락 검사 기준 |
도메인 간·내부 읽는 순서는 Domain Reading Order, 책처럼 읽는 전체 순서는 SK-Intellix Book Shelf를 기준으로 본다. 1차 책자 정리를 끊는 기준은 SK-Intellix Book First-Cut Gate를 기준으로 본다. 카테고리별 repo/source/test/evidence 연결은 SK-Intellix Source and Evidence Catalog를 기준으로 본다. 기존 docs/a2a/ 문서를 장기적으로 분리하는 기준은 SK-Intellix Document Migration Roadmap을 따른다.
위키 자체의 레벨과 페이지 책임은 SK-Intellix Wiki Structure Map을 기준으로 본다. 각 아키텍처 아이디어의 배경과 구축 이점은 Architecture Rationale and Benefits을 기준으로 본다.
3. 현재 파일 위치 정책
지금은 기존 문서가 docs/a2a/에 많이 남아 있다. 이건 실패가 아니라 URL 안정성을 위한 과도기 정책이다.
| 문서 상태 | 정책 |
|---|---|
| 이미 배포/공유된 A2A 문서 | 기존 URL 유지 |
| 새로 생기는 최상위 분류 문서 | docs/sk-intellix/에 작성 |
| 특정 도메인이 커지는 경우 | 이후 docs/ondevice/, docs/deviceagent/, docs/memory/, docs/vendor/로 단계 분리 |
| 기존 문서 이동 | 링크와 검증 비용을 감당할 수 있을 때만 수행 |
4. 분류 예시
| 문서 | 카테고리 | 이유 |
|---|---|---|
planner-routing.md |
A2A |
route family와 planner 판단 구조 |
vendor-llm-training/ |
SPEECH |
STT, 딕셔너리, 온디바이스/Cloud LLM, TTS, 운영 로그 분석 |
speaker-identity-a2a-service/ |
SPEAKER_IDENTITY |
화자 등록/식별과 speaker_context 기반 개인화/권한 |
framework-sdk/ |
FRAMEWORK_SDK |
A1 DeviceAgent API/runtime과 QSSI/UM/HAL/BSP 연결을 근거 기반으로 정리하는 상위 허브 |
framework-sdk/*.svg |
FRAMEWORK_SDK, VENDOR, VALIDATION |
AOSP layer, QSSI/UM build, runtime call, HAL/DTS/driver evidence 책임을 그림으로 설명 |
aosp-bsp.md, qcs6490-platform-vendor-brief.md |
AOSP_BSP, VENDOR, DEVICEAGENT |
QCS6490 platform vendor 업체 회의와 BSP bring-up 범위 |
vendor-meeting.md |
VENDOR |
업체 회의 전용 진입점 |
device-task-flow.md |
A2A, ONDEVICE, DEVICEAGENT |
Cloud plan이 device task로 내려가는 교차 경계 |
contracts.md |
ONDEVICE 중심 |
Cloud/On-device/DeviceAgent payload 경계 |
deviceagent-taskmanager-api-contract.md |
DEVICEAGENT, VENDOR |
업체가 구현해야 할 TaskManager API |
soc-taskmanager-framework/ |
DEVICEAGENT, VENDOR |
Cloud LLM 전용이 아닌 SoC 실행 프레임워크 기준 |
memory-db-sync.md |
MEMORY |
DB schema, sync cursor, delete/retention |
vendor-test-evidence-template.md |
VENDOR, VALIDATION |
업체 제출 증거 양식 |
global-wiki-operations.md |
OPERATIONS |
wiki 저장/빌드/전역 Codex 운영 |
5. 작성 규칙
새 문서를 만들 때는 아래 중 하나를 먼저 고른다.
SK-Intellix 전체
A2A
Experience Goal
Speech Recognition
Audio / SoundFlow
Speaker Identity
On-device Bridge
DeviceAgent / SoC
Framework / SDK
AOSP / BSP
Memory / Personalization
Vendor Handoff
Validation / Evidence
Operations
PoC
카테고리를 고른 뒤 문서 상단에 다음을 명확히 적는다.
이 문서는 어느 계층의 책임인가?
입력/출력/상태/이벤트가 무엇인가?
어느 repo/file/test가 근거인가?
완료로 보려면 어떤 evidence가 필요한가?
이번 Framework/SDK와 QCS6490 Platform Vendor 문서의 책임 경계는 다음처럼 본다.
| 항목 | owner로 표현할 것 | owner로 표현하지 말 것 |
|---|---|---|
| SK-Intellix Framework/SDK | DeviceAgent API/runtime 계약, 후보 SDK surface, event/reason code, release 판단 기준 | boot/logcat/dmesg 같은 device evidence 수집 자체 |
| 플랫폼 벤더 | overlay, vendor service, HAL backend, DTS/driver, device evidence 제출 | DeviceAgent public API owner |
| Validation/Release Gate | 제출 evidence를 계약과 연결해 합격/불합격 판단 | HAL/service 구현 owner |