← Docs hub

SK-Intellix Domain Reading Order

이 문서는 SK-Intellix 위키의 도메인 간 읽는 순서와 도메인 내부 문서 배열 규칙을 정의하는 기준점이다. 문서가 저장된 폴더 순서나 작성 날짜가 아니라, 독자가 이해하고 판단하는 논리 순서로 자료를 연결한다.

핵심 원칙
먼저 시스템이 왜 필요한지 이해하고, 다음으로 구조와 계약을 확인하며, 실제 소스와 증거를 본 뒤 운영·로드맵으로 끝낸다. 구현 기록이나 최신 테스트 결과를 개요보다 먼저 읽게 하지 않는다.

1. 왜 다시 정리했는가

기존 위키는 도메인 분류 자체는 갖추고 있었지만 다음 문제가 있었다.

• 일부 허브는 질문별 링크와 구현 문서가 한 표에 섞여 있었다.
• 일부 허브는 대표 문서만 연결해 실제 존재하는 자료가 노출되지 않았다.
• 최신 검증 보고서가 처음 읽는 문서보다 먼저 배치된 경우가 있었다.
• A2A와 TaskManager는 링크가 과밀했지만 On-device, Validation, Operations는 자료량에 비해 진입점이 빈약했다.
• SoundFlow/Audio와 Experience처럼 독립된 논리가 필요한 영역이 다른 도메인의 부속 자료처럼 보였다.
• URL 안정성을 위해 docs/a2a/에 남아 있는 문서의 논리 소유권이 화면에서 명확하지 않았다.

2026-08-05 감사 범위는 docs/a2a/와 docs/sk-intellix/의 Markdown 215개다. 파일을 이동하지 않고 허브와 읽기 순서를 다시 연결하는 방식으로 정리한다.

2. 모든 도메인에 적용하는 7단계

각 도메인 landing page는 아래 순서를 기본으로 사용한다.

모든 도메인이 일곱 단계를 억지로 채울 필요는 없다. 다만 문서가 존재한다면 이 순서대로 배치하고, 단계가 비어 있으면 자료 없음이 아니라 현재 공백으로 명시한다.

3. 전체 도메인 읽기 Spine

처음 접하는 독자는 다음 순서로 읽는다.

제품과 목표
  -> 입력과 사용자
  -> 판단과 계획
  -> 연결과 실행
  -> 플랫폼과 하드웨어
  -> 검증과 전달

이 순서는 조직도나 저장소 순서가 아니다. 한 사용자 발화가 물리 실행과 증거로 닫히는 순서이며, 필요한 경우 독자는 자신의 역할에 맞는 도메인부터 시작한다.

4. 역할별 빠른 진입

5. 도메인별 내부 읽기 순서

5.1 A2A

Category
  -> Product PRD / Before-After
  -> System Overview
  -> Planner / Semantic Boundary
  -> Contract / Device Task Flow
  -> Source / Scenario
  -> Benchmark / Baseline
  -> Backlog / Research

상세 링크는 A2A Category와 A2A Knowledge Hub에서 본다.

5.2 Experience

AS-IS / TO-BE
  -> Usability
  -> Existing Planner Integration
  -> Workflow Foundations
  -> Supervisor
  -> Academic Deep Dive
  -> Live Slice / Runtime Closure

Experience는 A2A의 새 route family가 아니라 여러 도메인의 결과를 보존하는 sidecar다. Experience Goal Category에서 경계를 확인한 뒤 Experience Goal AS-IS/TO-BE를 읽는다.

5.3 On-device Bridge

Category
  -> End-to-End Data Flow
  -> Contract Matrix
  -> Device Task Flow
  -> Callback Completion
  -> Source Map
  -> TTS Lifecycle / APK Release
  -> Validation

상세 링크는 On-device Bridge에서 본다.

5.4 DeviceAgent / TaskManager

Category / Strategic Transition
  -> Architecture / Design Policy
  -> API / MQTT / AAR Contract
  -> MainApi Insertion / Executor Wiring
  -> Lifecycle / Scheduling / PUI
  -> Closure Matrix / Audits / Live E2E
  -> Monitor / Vendor Workbook / Roadmap

상세 링크는 DeviceAgent / SoC와 SoC TaskManager Framework에서 본다.

5.5 Framework / AOSP

Framework Hub
  -> System Design
  -> SDK Contract
  -> TaskManager Integration
  -> QCS6490 Platform Brief
  -> QSSI / UM / HAL / Driver
  -> Release Evidence
  -> Transformation Roadmap

상세 링크는 Framework / SDK와 AOSP / BSP에서 본다.

5.6 Speech / Audio

Speech Category
  -> Product Voice Architecture
  -> On-device Source / Dictionary
  -> Cloud Fallback / Rewrite
  -> TTS / State Lifecycle
  -> E2E Log Analysis
  -> SoundFlow / Acoustic Evidence
  -> Field Runbook / Vendor Request

상세 링크는 Speech Recognition Module과 Audio / SoundFlow에서 본다.

5.7 Identity / Memory

Identity Entry
  -> Enrollment / Speaker Context Contract
  -> Privacy / Authority
  -> Memory Management
  -> TaskManager Integration
  -> Test / Evidence Audit
  -> Service Roadmap

상세 링크는 Speaker Identity와 Memory / Personalization에서 본다.

5.8 Validation / Vendor / Operations

Validation Policy
  -> Contract / Traceability
  -> Unit / Benchmark
  -> Integration / Real Device
  -> Gap / Release Gate
  -> Vendor Acceptance
  -> Wiki Build / Publish

상세 링크는 Validation, Vendor, Operations에서 본다.

6. 문서 배치 규칙

새 문서나 기존 문서를 허브에 연결할 때 다음 규칙을 따른다.

1. Primary domain은 하나만 지정한다.
2. 파일 경로보다 문서의 책임과 독자 질문을 우선한다.
3. 도메인 허브에서 반드시 7단계 중 하나에 배치한다.
4. 최신 검증 보고서는 구조·계약 문서 뒤에 둔다.
5. worklog는 구현 가이드보다 뒤에 둔다.
6. roadmap은 현재 상태와 검증 공백을 설명한 뒤에 둔다.
7. cross-domain 문서는 각 허브에 중복 링크할 수 있지만 primary owner는 하나다.
8. 기존 공개 URL은 이동하지 않고 논리 링크만 고친다.
9. 문서가 추가되면 coverage test와 Domain Document Map을 함께 갱신한다.

7. 문서 책임 구분

8. 완료 기준

정보구조 정리는 링크 수가 많다고 끝난 것이 아니다.

• 모든 대상 문서가 하나 이상의 도메인 허브 또는 하위 허브에 노출된다.
• 각 도메인에서 첫 문서와 최신 검증 문서가 구분된다.
• 제품·설계·구현·검증 문서가 논리 순서대로 배치된다.
• 도메인 간 이동 경로가 한 단계 안에서 제공된다.
• 링크와 실제 파일 존재를 자동 테스트한다.
• build, lint, sensitive scan, canonical URL 검증을 통과한다.

관련 문서

• SK-Intellix Engineering Hub
• SK-Intellix Category Map
• SK-Intellix Book Shelf
• SK-Intellix Domain Document Map
• SK-Intellix Document Finder