SK-Intellix Wiki Structure Map
이 문서는 SK-Intellix 위키 전체의 정보 구조를 정의한다.
역할은 단순 목차가 아니라, “어느 페이지가 어떤 레벨의 책임을 갖고, 독자가 어떤 순서로 들어가야 하는지”를 고정하는 것이다.
1. 구조 원칙
이 위키는 아래 5개 레벨로 관리한다.
| Level | 이름 | 역할 | 대표 문서 |
|---|---|---|---|
| L0 | Entry | 전체 진입점. 어디서 시작할지 고른다. | Engineering Hub |
| L1 | Book Spine | 책처럼 읽는 순서와 1차 컷 기준을 잡는다. | Book Shelf, Book First-Cut Gate |
| L2 | Domain Chapters | A2A, Speech, Speaker Identity, On-device, DeviceAgent, Framework/SDK, AOSP/BSP, Memory, Vendor, Validation, Operations를 나눈다. | Category Map, Domain Document Map |
| L3 | Detail Pages | 각 도메인의 설계, 계약, 예시, source, API, SVG를 설명한다. | A2A detail docs, SoC TaskManager Framework |
| L4 | Evidence / Operation | 검증, 배포, 문서 품질, 남은 공백을 관리한다. | Source and Evidence Catalog, Operations |
이 구조의 핵심은 다음과 같다.
Engineering Hub
-> Wiki Structure Map
-> Book Shelf
-> First-Cut Gate
-> Domain Chapter
-> Detail Page
-> Evidence / Operation
2. 각 페이지의 책임 경계
| 페이지 | 해야 하는 일 | 하지 말아야 하는 일 |
|---|---|---|
| Engineering Hub | 모든 사용자의 첫 진입점 제공 | 상세 구현을 길게 설명하지 않음 |
| Wiki Structure Map | 위키 정보 구조와 레벨 정의 | 개별 API 세부를 반복하지 않음 |
| Book Shelf | 책처럼 읽는 순서 제공 | 완료/미완료 판정 자체를 길게 하지 않음 |
| First-Cut Gate | 1차 baseline과 후속 작업 경계 고정 | 전체 목차 역할을 대체하지 않음 |
| Category Map | 도메인 분류 기준 정의 | 각 도메인 내부 순서를 모두 나열하지 않음 |
| Domain Category | 해당 도메인의 핵심 질문/책임/입출력 안내 | 다른 도메인의 구현 책임을 가져오지 않음 |
| Detail Page | 설계/계약/예시/API/source를 구체화 | 최상위 독자 경로를 재정의하지 않음 |
| Evidence Catalog | source/test/artifact 근거 연결 | 아키텍처 설명을 중복하지 않음 |
| Operations | wiki build/lint/deploy/전역 Codex 운영 | 제품 아키텍처 판단을 하지 않음 |
3. 권장 읽기 순서
처음 읽는 사람은 아래 순서가 가장 자연스럽다.
| 순서 | 문서 | 읽는 이유 |
|---|---|---|
| 1 | Engineering Hub | 전체 진입점과 현재 큰 분류를 본다. |
| 2 | Wiki Structure Map | 이 위키의 레벨과 페이지 책임을 이해한다. |
| 3 | Architecture Rationale and Benefits | 왜 이 구조가 필요하고 구축하면 어떤 이점이 있는지 본다. |
| 4 | Book Shelf | 책처럼 읽을 실제 순서를 잡는다. |
| 5 | Book First-Cut Gate | 어디까지가 1차 baseline이고 어디부터 후속 작업인지 구분한다. |
| 6 | Speech-LLM Context-Aware A2A Architecture | Speech/STT부터 planner/agent/복합제어까지 한 흐름을 본다. |
| 7 | Category Map | A2A, Speech, Speaker Identity, On-device, DeviceAgent, AOSP/BSP, Memory, Vendor, Validation의 경계를 본다. |
| 8 | 필요한 Domain Category | 담당 영역으로 들어간다. |
| 9 | Detail Page | 실제 계약, source, 예시, SVG를 확인한다. |
| 10 | Source and Evidence Catalog | 문서 주장의 source/test/evidence를 확인한다. |
4. 도메인별 흐름
도메인 장은 아래 방향으로 이어진다.
| 도메인 | 이전 장에서 받는 것 | 다음 장으로 넘기는 것 |
|---|---|---|
| Speech Recognition | raw speech/STT input | processed text, local token, fallback/rewrite 후보 |
| A2A | speech/context/current utterance 또는 proactive signal | route family, steps, device task request, agent handoff |
| Speaker Identity | voice segment, embedding, speaker score | speaker_context, authority/memory owner |
| Reactive / Proactive | user speech 또는 signal bundle | reactive turn, proactive decision, feedback loop |
| On-device Bridge | Cloud plan/device request | local workflow, token/task 전달, progress/event report |
| DeviceAgent / SoC | task/workflow bundle | native 실행, callback, reason_code, device context |
| Framework / SDK | DeviceAgent API/runtime source | SDK 후보 계약, service hub/API release 기준 |
| AOSP / BSP | product package/HAL/board change | build image, HAL/DTS/device evidence |
| Memory / Personalization | turn/result/event summary | 다음 turn context, profile candidate/confirmed |
| Vendor Handoff | 설계/계약/API 요구 | 업체 구현물, test evidence, open question closure |
| Validation / Quality | source/test/artifact | 완료/미완료/gap 판정 |
| Operations | docs/source/site/deploy scripts | build/lint/deploy, 다른 Codex 창 공유 |
5. 독자별 진입점
| 독자 | 시작 위치 | 바로 다음 |
|---|---|---|
| 전체 의사결정자 | Engineering Hub | Book First-Cut Gate |
| 신규 개발자 | Wiki Structure Map | Book Shelf |
| Cloud A2A 담당 | A2A Category | Speech-LLM Context-Aware A2A Architecture |
| 음성인식 담당 | Speech Recognition Module | LLM 운영 Wiki |
| 화자인식 담당 | Speaker Identity Service | Speaker Identity Entry Points |
| Proactive 담당 | Reactive and Proactive Operation | gemini/a2a/proactive/, proactive request/feedback schema |
| On-device 담당 | On-device Bridge Category | Contract Matrix |
| DeviceAgent/SoC 업체 | DeviceAgent / SoC Category | SoC TaskManager Framework |
| AOSP/BSP 담당 | AOSP and BSP Category | QCS6490 Platform Vendor Brief |
| 업체 회의 담당 | Vendor Meeting Entry | Vendor Handoff |
| Memory 담당 | Memory Category | Memory DB and Sync Contract |
| QA/SQA | Validation Category | Source and Evidence Catalog |
| 문서 찾는 사람 | Document Finder | Domain Document Map |
| 위키/배포 운영자 | Operations Category | Wiki Domain Deployment |
6. 현재 구조 판단
현재 위키는 아래 상태로 본다.
| 항목 | 판정 |
|---|---|
| 최상위 진입점 | 있음 |
| 책자형 순서 | 있음 |
| 1차 컷 기준 | 있음 |
| 도메인 분류 | 있음 |
| 도메인별 상세 문서 | 있음 |
| source/evidence 연결 | 있음 |
| build/lint/deploy 운영 | 있음 |
| 실제 제품 E2E evidence | 아직 부족 |
따라서 지금부터는 구조를 계속 바꾸기보다, 후속 작업이 생길 때 이 구조 안의 올바른 위치에 문서와 증거를 추가한다.