SK-Intellix Engineering Knowledge Hub
이 페이지는 SK-Intellix 관련 Codex/wiki 산출물의 최상위 진입점이다.
기존에는 A2A 작업에서 시작했기 때문에 많은 문서가 SK-Intellix A2A Knowledge Hub 아래에 모여 있었다. 하지만 지금 다루는 범위는 Cloud A2A만이 아니라 온디바이스 브릿지, DeviceAgent/SoC TaskManager, 메모리/개인화, 업체 전달, llmwiki 운영까지 확장되었다.
따라서 이 페이지를 최상위 목차로 사용하고, A2A는 그 하위 도메인 중 하나로 관리한다.
먼저 볼 순서
- 5분 요약: 전체 판단과 남은 리스크를 빠르게 본다.
- 카테고리 선택: 지금 보고 싶은 영역이 A2A인지, 온디바이스인지, DeviceAgent/SoC인지 고른다.
- SoC 업체 구현: DeviceAgent/SoC 작업이면 SoC TaskManager Framework를 먼저 본다.
- 계약/구조 확인: payload, task, event, callback, memory sync 같은 경계 문서를 본다.
- 검증 상태 확인: dry-run, unit, ADB/실기기, 업체 evidence 중 무엇이 남았는지 본다.
- 업체 전달 기준 확인: SoC/DeviceAgent 업체가 구현해야 할 API와 제출 증거를 본다.
카테고리 지도
| 카테고리 | 시작 문서 | 역할 |
|---|---|---|
| 책형 목차 | SK-Intellix Book Shelf | 전체 자료를 본문/사례/검증/부록으로 읽는 순서 |
| 1차 책자 완료 기준 | SK-Intellix Book First-Cut Gate | 어디까지 정리되면 1차로 끊고 후속 작업으로 넘길지 판단 |
| 전체 분류 체계 | Knowledge Category Map | SK-Intellix 지식 카테고리 기준 |
| 소스/근거 색인 | Source and Evidence Catalog | 카테고리별 repo/source/test/evidence 연결 |
| 문서 이동 로드맵 | Document Migration Roadmap | A2A에 몰린 문서를 장기적으로 어떻게 분리할지 |
| A2A | A2A Category | Cloud planner/router/runtime |
| On-device Bridge | On-device Bridge Category | Cloud 응답을 device token/task/workflow로 연결 |
| DeviceAgent / SoC | DeviceAgent / SoC Category | TaskManager, callback, reason, domain execution. 핵심 work package는 SoC TaskManager Framework |
| Memory / Personalization | Memory Category | pair/session/day/week/profile memory |
| Vendor Handoff | Vendor Category | 업체 구현 범위, API 인수 기준, 테스트 증거 |
| Validation / Quality | Validation Category | evidence, benchmark, ADB/실기기 검증 |
| Wiki / Codex Operations | Operations Category | 전역 wiki root, Codex 창 공유, build/lint |
| Wiki Domain Deployment | SK-Intellix Wiki Domain Deployment | 로컬 llmwiki를 인증이 걸린 실제 도메인으로 배포하는 운영 구조 |
주요 문서 빠른 연결
| 도메인 | 시작 문서 | 목적 |
|---|---|---|
| 전체 요약 | A2A Executive Summary | 현재 구조, 결론, 리스크, 다음 액션을 5분 안에 파악 |
| 책자형 1차 컷 | SK-Intellix Book First-Cut Gate | 위키 구조화 작업을 어디서 끊고 다음 구현/검증 작업으로 전환할지 판단 |
| Cloud A2A / Planner | SK-Intellix A2A Knowledge Hub | route family, multi-step planner, runtime orchestration 이해 |
| Speech-LLM Context-Aware A2A | Speech-LLM Context-Aware A2A Architecture | STT, context, planner, Agent/Skill, 복합제어, event/memory feedback을 한 흐름으로 이해 |
| Cloud 판단 구조 | Planner and Routing | DEF/STT_NULL/FRG/ODL/SCH 등 family 판단과 2차 judge 기준 확인 |
| Cloud 실행/오케스트레이션 | Device Task Flow | planner output이 device task request로 내려가는 흐름 확인 |
| 온디바이스 브릿지 | Contract Matrix, Scenario Walkthroughs | Cloud 응답을 받아 sequential workflow와 device token/task로 연결 |
| DeviceAgent / SoC | DeviceAgent / SoC Category, SoC TaskManager Framework, SoC TaskManager Execution Subsystem | 실제 기기 실행, Cloud/MQTT/App/예약 ingress, TaskManager, callback, reason_code, planning context 책임 확인 |
| DeviceAgent API 계약 | DeviceAgent TaskManager API Contract | 업체가 맞춰야 할 submit/get/cancel/event payload 확인 |
| DeviceAgent 도메인 지도 | DeviceAgent / SoC Domain Map | moving, cleaning, map, schedule, interaction 도메인 연결 확인 |
| 19.comToMe | 19.comToMe Workflow Example, 19.comToMe DeviceAgent Contract | ComeToMe를 복합명령/task workflow 관점에서 구현할 때 필요한 계약 확인 |
| 메모리/개인화 | Memory and Personalization, Memory DB and Sync Contract | 단기/중기/장기 메모리, DB schema, sync/delete 정책 확인 |
| 업체 전달 | Vendor Handoff, DeviceAgent Vendor Implementation Package | SoC/DeviceAgent 업체에 줄 구현 범위와 제출물 확인 |
| 검증/품질 | Validation Guide, A2A Evidence Index | 어떤 주장이 어떤 소스/테스트/실기기 evidence로 증명되는지 확인 |
| 전역 위키 운영 | A2A Global Wiki Operations | 모든 Codex 창에서 같은 wiki root를 참조/갱신하는 운영 방식 확인 |
| 위키 도메인 배포 | SK-Intellix Wiki Domain Deployment | Caddy/Cloudflare Access/rsync 기반의 실제 도메인 배포 절차 확인 |
관리 단위
앞으로는 문서를 아래 단위로 나누어 관리한다.
| 관리 단위 | 현재 위치 | 향후 방향 |
|---|---|---|
| Engineering top hub | docs/sk-intellix/ |
SK-Intellix 전체 진입점 |
| A2A | docs/sk-intellix/a2a.md, docs/a2a/ |
A2A는 SK-Intellix 내부 대분류 중 하나 |
| On-device Bridge | docs/sk-intellix/ondevice-bridge.md |
관련 상세 문서는 기존 docs/a2a/ 링크 유지 |
| DeviceAgent / SoC | docs/sk-intellix/deviceagent-soc.md, docs/sk-intellix/soc-taskmanager-framework/ |
DeviceAgent/SoC 카테고리 아래에 업체 구현과 장기 프레임워크화 기준을 함께 관리 |
| Memory / Personalization | docs/sk-intellix/memory-personalization.md |
구현 단계 진입 시 별도 디렉터리 분리 가능 |
| Vendor Handoff | docs/sk-intellix/vendor-handoff.md |
업체별 deliverable이 늘어나면 별도 디렉터리 분리 가능 |
| Validation / Quality | docs/sk-intellix/validation-quality.md |
evidence와 test gate 중심 |
| Wiki Operations | docs/sk-intellix/operations.md |
전역 wiki/Codex 운영 |
현재는 기존 링크 안정성을 위해 파일을 대량 이동하지 않는다. 대신 이 최상위 허브에서 역할별/도메인별로 분기한다.
빠른 URL
Engineering Hub:
http://127.0.0.1:8767/docs/sk-intellix/
SoC TaskManager Framework:
http://127.0.0.1:8767/docs/sk-intellix/soc-taskmanager-framework/
A2A Category:
http://127.0.0.1:8767/docs/sk-intellix/a2a.html
A2A Hub:
http://127.0.0.1:8767/docs/a2a/
Global Wiki Operations:
http://127.0.0.1:8767/docs/a2a/global-wiki-operations.html
현재 판단
지금 문서 구조의 문제는 내용 부족보다 상위 분류 부재였다.
A2A가 출발점이었기 때문에 DeviceAgent/SoC, Memory, Vendor, Wiki Operations까지 모두 A2A 하위처럼 보였다.
이제부터는:
docs/sk-intellix/는 최상위 지식 허브다.docs/a2a/는 Cloud A2A와 그에 연결된 실행/계약 문서 묶음이다.- 책자형 1차 정리는 SK-Intellix Book First-Cut Gate를 기준으로 끊는다.
- 실제 파일 이동은 링크 안정성과 검증 비용 때문에 단계적으로만 한다.
- 새 대형 주제는 처음부터 별도 디렉터리로 만들고, 이 허브에서 연결한다.