SK-Intellix Source and Evidence Catalog
이 문서는 SK-Intellix 위키의 각 카테고리가 어떤 repository, source file, 설계 문서, test/evidence에 기대고 있는지 정리한다.
목적은 “문서가 잘 정리되어 있다”에서 끝내지 않고, 독자가 바로 다음 질문에 답할 수 있게 하는 것이다.
이 주장의 근거 source는 어디인가?
구현은 어느 repo에 있는가?
검증은 어떤 test 또는 artifact로 증명되는가?
아직 증거가 부족한 부분은 무엇인가?
1. 카테고리별 근거 요약
| 카테고리 | 대표 repo/source | 현재 evidence | 남은 공백 |
|---|---|---|---|
A2A |
~/work/8.cloudLLM/backend-cloud-llm-lambda/gemini/a2a |
planner/runtime/tools source, dry-run/verifier tools, wiki build/lint | 최신 full benchmark artifact, 실기기 E2E |
ONDEVICE |
~/work/2.A1_LLM_Aent/skmagic_ondeviceai_agent |
bridge 설계 문서, bundle sample, ForegroundService.kt, DeviceCommunicator.kt |
실제 단말 callback/logcat evidence |
DEVICEAGENT |
~/work/1.A1_SoC_new/SoC/a1-packages/apps/DeviceAgent, SoC TaskManager Framework |
TaskManager source, unit/instrumented test source, 업체 구현용 framework 문서 | 업체 구현 diff, 실제 device task callback trace, MQTT/App/예약 ingress evidence |
COMETOME |
~/work/19.comToMe |
ComeToMe 설계 문서, speaker recognition scenario, diagram | 실제 comeToMe method/stage/reason 구현 |
MEMORY |
gemini/a2a/shared_context, gemini/a2a/runtime/memory_context.py |
shared_context source 확인 | migration, sync worker, privacy/delete E2E |
VENDOR |
wiki vendor package/checklist/templates | API acceptance/test evidence template | 업체 제출 산출물 수집 |
VALIDATION |
gemini/a2a/tools/*, DeviceAgent tests |
verifier/audit/logcat tools source | ADB 연결 후 artifact 수집 |
OPERATIONS |
~/.codex/AGENTS.md, ~/.bashrc, ~/.profile, llmwiki root |
전역 wiki root, env var, build/lint 검증 | 기존 Codex 창 재시작 여부 |
2. A2A Source Map
기준 repo:
/home/silogood/work/8.cloudLLM/backend-cloud-llm-lambda
핵심 source:
| 영역 | 파일 |
|---|---|
| Planner API | gemini/a2a/planner/main_router_api.py |
| Planner prompt | gemini/a2a/planner/assets/main_router.system_prompt.txt |
| Planner schema | gemini/a2a/planner/assets/main_router.response_schema.json |
| Preclassifier | gemini/a2a/planner/preclassifier.py |
| Runtime orchestrator | gemini/a2a/runtime/orchestrator.py |
| Device task request 생성 | gemini/a2a/runtime/task_manager.py |
| Workflow event state | gemini/a2a/runtime/workflow_state.py |
| Device task mapper | gemini/a2a/runtime/device_task_mapper.py |
| Runtime contracts | gemini/a2a/runtime/contracts.py |
| Memory context | gemini/a2a/runtime/memory_context.py |
| Shared memory stores | gemini/a2a/shared_context/*.py |
| ODL bridge/contract | gemini/a2a/agents/odl/bridge_api.py, device_task_contract.py |
검증/도구:
| 목적 | 파일 |
|---|---|
| device task dry-run | gemini/a2a/tools/device_task_dry_run.py |
| task event contract 검증 | gemini/a2a/tools/task_event_contract_verifier.py |
| E2E readiness | gemini/a2a/tools/device_e2e_readiness.py |
| E2E runner | gemini/a2a/tools/device_e2e_runner.py |
| artifact validator | gemini/a2a/tools/device_e2e_artifact_validator.py |
| logcat evidence | gemini/a2a/tools/device_logcat_evidence.py |
| task event simulator | gemini/a2a/tools/task_event_simulator.py |
3. On-device Bridge Source Map
기준 repo:
/home/silogood/work/2.A1_LLM_Aent/skmagic_ondeviceai_agent
현재 직접 확인된 source:
| 영역 | 파일 |
|---|---|
| Foreground service | app/src/main/java/com/skmagic/ondeviceai/agent/service/ForegroundService.kt |
| Device communication | app/src/main/java/com/skmagic/ondeviceai/agent/service/DeviceCommunicator.kt |
| API device communication | app/src/main/java/com/skmagic/ondeviceai/agent/service/api/DeviceCommunicator.kt |
설계/계약 근거:
docs/strategy/short-term/a2a-device-task-bridge-2026-06-18/
주요 문서:
| 문서 | 의미 |
|---|---|
README.md |
Cloud -> bridge -> DeviceAgent 전체 연결 개요 |
INTEGRATION_CHECKLIST.md |
연동 체크리스트 |
SAMPLE_BUNDLES.md |
submitTask, submitWorkflow, onTaskEvent bundle sample |
TASK_EVENT_REASON_CODE_SPEC.md |
task event와 reason code 규약 |
VENDOR_DEVICEAGENT_TASKMANAGER_SPEC.md |
업체 전달용 DeviceAgent TaskManager spec |
device-task-bridge-architecture.svg |
bridge 구조도 |
01-responsibility-boundary.svg |
Cloud/Bridge/DeviceAgent 책임 경계 |
02-api-sequence-and-bundles.svg |
API sequence와 bundle |
04-task-event-replan-gate.svg |
event/replan gate |
주의:
- 기존 wiki 일부에는
CloudIntentWorkflowRunner.kt,DeviceIntentExecutor.kt,DeviceCommandSink.kt,CloudDeviceTaskRequests.kt,ManagedDeviceTask.kt같은 후보 파일명이 언급되어 있다. - 현재 확인 명령 기준으로는 위 파일들이 직접 발견되지 않았다.
- 따라서 이 파일들은 “구현 후보/문서상 개념”으로 보되, 실제 source 근거는 위 확인된 파일과 strategy docs를 기준으로 삼는다.
4. DeviceAgent / SoC Source Map
기준 repo:
/home/silogood/work/1.A1_SoC_new/SoC/a1-packages
핵심 source:
| 영역 | 파일 |
|---|---|
| API gateway | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/main/api/MainApi.java |
| TaskManager | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskManager.java |
| Event listener | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskEventListener.java |
| Reason contract | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskReasonContract.java |
| Planning context | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/DevicePlanningContextProvider.java |
| Ingress classifier | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskIngressClassifier.java |
| Bundle validation | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskBundleValidator.java |
| Policy registry | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskPolicyRegistry.java |
| Executor registry | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskExecutorRegistry.java |
| Movement executor | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/MovementTaskExecutor.java |
| Cleaning executor | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/CleaningAmpTaskExecutor.java |
테스트 source:
| 테스트 | 파일 |
|---|---|
| Unit | apps/DeviceAgent/app/src/test/java/com/sk/airbot/deviceagent/task/TaskManagerTest.java |
| Integration | apps/DeviceAgent/app/src/test/java/com/sk/airbot/deviceagent/task/TaskManagerIntegrationTest.java |
| Instrumented | apps/DeviceAgent/app/src/androidTest/java/com/sk/airbot/deviceagent/task/TaskManagerInstrumentedTest.java |
5. 19.comToMe Source Map
기준 repo:
/home/silogood/work/19.comToMe
근거 문서:
| 영역 | 파일 |
|---|---|
| System design | docs/strategy/short-term/com-to-me-system-design.md |
| Speaker recognition scenario | docs/strategy/short-term/com-to-me-speaker-recognition-service-scenario.md |
| Flow diagram | docs/diagrams/com-to-me-flow.mmd |
| Speaker recognition SVG | docs/diagrams/com-to-me-speaker-recognition-service.svg |
현재 상태:
- ComeToMe는 A2A 복합명령/DeviceAgent TaskManager 관점에서 중요한 예시다.
- 단, 실제
comeToMeTaskManager method, stage gate, reason payload는 업체/DeviceAgent 구현에서 확정되어야 한다.
6. Memory / Personalization Source Map
현재 확인된 Cloud source:
gemini/a2a/runtime/memory_context.py
gemini/a2a/shared_context/context_retriever.py
gemini/a2a/shared_context/short_term_store.py
gemini/a2a/shared_context/mid_term_pattern_store.py
gemini/a2a/shared_context/long_term_profile_store.py
gemini/a2a/shared_context/memory_promotion_gate.py
gemini/a2a/shared_context/preference_policy_store.py
남은 구현/evidence:
| 항목 | 필요한 증거 |
|---|---|
| DB schema | migration 파일, schema test |
| Sync cursor | Cloud/On-device sync fixture |
| 삭제 정책 | delete request -> local/cloud 삭제 trace |
| long-term promotion | candidate -> confirmed 정책 test |
| privacy | 민감정보 필터/보존기간 검증 |
7. Evidence Gate
| Gate | 의미 | 현재 상태 |
|---|---|---|
| G1 문서 연결 | 카테고리와 문서 링크가 연결됨 | 충족 |
| G2 source 연결 | repo/file 근거가 연결됨 | 대부분 충족 |
| G3 static 검증 | llmwiki build/lint 통과 |
충족 |
| G4 책자형 1차 컷 | 전체 장/카테고리/연결/후속 공백이 분리됨 | Book First-Cut Gate 기준 충족 |
| G5 dry-run/unit | Cloud/DeviceAgent test source와 일부 도구 존재 | 부분 충족 |
| G6 on-device 통합 | bridge -> DeviceAgent callback trace | 미충족 |
| G7 실기기 | ADB/logcat artifact | 미충족 |
| G8 업체 evidence | 업체 제출 산출물 | 미충족 |