[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBANVTP59GV32VYME7QTQ1":3,"skill-same:01M6CBANVTP59GV32VYME7QTQ1":54},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":28,"updatedAt":29,"install":30,"resources":43},"01M6CBANVTP59GV32VYME7QTQ1","03-ssot",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F03-ssot\u002FSKILL.md",[],[18],"03 ssot","2026-11-10 10:12:30",false,"# 03-ssot — Unity\n\nStatus: ACTIVE\nAppliesTo: v11\nParentSSOT: skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md\n\n---\n\n## Scope\n\n이 문서는 **Unity UPM 패키지 구조, 빌드 동기화, 게이트** 관련 SSOT를 정의한다.\n\n**중복 금지:** 공통 용어\u002F플레이스홀더\u002F입력 분리\u002F머지 규칙은 [Root SSOT](..\u002F..\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md)가 정본이며, 이 문서는 재정의하지 않는다.\n\n**Sync 정책:** UPM 경로\u002F동기화\u002F미러 규칙은 [Unity Policy](..\u002F01-policy\u002FSKILL.md)가 정본이다.\n\n---\n\n## UPM 전역 설정 (upmConfig) — Hard Rule\n\n**`upmConfig`는 `{projectConfigJson}` (예: `input\u002Fbuild_config.json`)에 존재해야 한다.**\n\n`{buildInputJson}` (예: `build_input.json`)에 `upmConfig`가 존재하면 **FAIL**.\n\n```json\n\u002F\u002F {projectConfigJson} 예시 구조\n{\n  \"configVersion\": 1,\n  \"upmConfig\": {\n    \"sourceDir\": \"..\u002Fframework-cs\u002Fupm\",\n    \"packageDir\": \"..\u002Fframework-cs\u002Fapps\u002FUnityExample\u002FPackages\"\n  }\n}\n```\n\n| 필드 | 의미 | 필수 |\n|------|------|------|\n| `sourceDir` | UPM 소스 루트 — 수동 관리 패키지 (upm) | ✅ |\n| `packageDir` | Unity Packages 루트 (UnityExample\u002FPackages) | ✅ |\n\n`upmConfig`가 없거나 필드가 누락되면 빌더는 **하드 실패(throw Error)**한다.\n\n---\n\n## 필수 검증 대상 패키지 (Hard Rule)\n\nSync 후 아래 패키지는 반드시 upm ↔ Packages 일치를 검증한다:\n\n- `com.devian.foundation` — Core + 모듈 타입 Editor + 도메인\u002F프로토콜\u002F수동 샘플 (Samples~: CommonPackage, SoundPackage, GamePackage, MobilePackage, GameProtocol, UIPackage)\n\n> Sync 규칙 자체는 [Unity Policy](..\u002F01-policy\u002FSKILL.md) §SSOT 원칙이 정본이다.\n\n---\n\n## UPM 동기화 충돌 정책 (Hard Rule)\n\nupm에 **동일 `package.json.name`이 있으면 무조건 빌드 FAIL**.\n\n- 예외 없음 — 충돌 해결: 패키지 이름 변경 또는 하나 제거\n\n---\n\n## Foundation 패키지 구조 (Hard Rule)\n\n**`com.devian.foundation`은 모듈 래핑 + 모듈 타입 Editor + Samples~(도메인\u002F프로토콜\u002F수동 샘플)를 제공한다.**\n\n| 구분 | 경로 | 설명 |\n|------|------|------|\n| Foundation 패키지 | `framework-cs\u002Fupm\u002Fcom.devian.foundation` | Core(모듈) + 모듈 타입 Editor + Samples~ |\n\n**패키지 내부 폴더 구조:**\n\n```\ncom.devian.foundation\u002F\n  Runtime\u002F\n    Module\u002F                     # devian\u002F10-module 래핑 (순수 C#)\n      Devian.Core.asmdef        # noEngineReferences: true\n  Editor\u002F\n    Devian.Unity.Editor.asmdef  # Complex\u002FVersionNumber Drawer\n  Samples~\u002F                     # 도메인\u002F프로토콜\u002F수동 샘플\n    CommonPackage\u002F\n    SoundPackage\u002F\n    GamePackage\u002F\n    MobilePackage\u002F\n    GameProtocol\u002F\n    UIPackage\u002F\n```\n\n**패키지 내부 asmdef:**\n\n| asmdef | 위치 | namespace | 역할 |\n|--------|------|-----------|------|\n| `Devian.Core` | `Runtime\u002FModule\u002F` | `Devian` | 순수 C# 런타임 (UnityEngine 의존 없음) |\n| `Devian.Unity.Editor` | `Editor\u002F` | `Devian.Unity` | 모듈 타입 Drawer (Complex\u002FVersionNumber) |\n\n> **asmdef 분리 정책:**\n> - `Devian.Core`는 `noEngineReferences: true`로 UnityEngine 참조를 금지한다.\n> - Unity 런타임 컴포넌트는 `com.devian.foundation\u002FSamples~\u002FCommonPackage\u002F`(`Devian.Samples.CommonPackage` asmdef)에 위치한다.\n\n---\n\n## Hard Rule: Base UPM package is com.devian.foundation only\n\n- `com.devian.core`, `com.devian.unity` UPM 패키지는 존재하지 않는다.\n- 모든 `com.devian.*` 패키지의 dependencies에서 `com.devian.core`, `com.devian.unity` 사용은 금지이며, 반드시 `com.devian.foundation`을 사용한다.\n- 위반 시 빌드는 즉시 FAIL이다.\n\n---\n\n## Sample Package 상수 (Hard Rule)\n\n- 샘플 패키지 대상은 `com.devian.foundation` 하나뿐이며, 빌더 내부 상수(`UPM_FOUNDATION`)로 고정한다.\n- 설정 파일(`{projectConfigJson}`)에 `samplePackages` 키는 **불필요하며 존재하지 않는다.**\n- `staticUpmPackages` 키도 금지이며 존재 시 빌드 FAIL.\n\n---\n\n## foundationVersion — Foundation 패키지 버전 (Hard Rule)\n\n### 목적\n\n`com.devian.foundation`의 버전을 `{projectConfigJson}`에서 단일 관리한다.\n빌더가 이 값으로 `package.json`의 `version` 필드를 덮어쓰고, SampleSync 경로 해석에도 사용한다.\n\n### 설정\n\n```json\n\"foundationVersion\": \"0.1.0\"\n```\n\n- `{projectConfigJson}`에 **필수**로 지정한다.\n- 생략 시 빌드 **FAIL**.\n\n### 빌더 동작\n\n1. **package.json 동기화**: `com.devian.foundation\u002Fpackage.json`의 `version` 필드를 `foundationVersion` 값으로 덮어쓴다.\n2. **DEFAULT_VERSIONS 대체**: 빌더 내부 `DEFAULT_VERSIONS` 상수를 이 값으로 대체한다.\n3. **sampleFolder 경로**: `{sampleFolder}\u002F{displayName}\u002F{foundationVersion}\u002F{sampleName}\u002F`으로 해석한다.\n\n### SSOT 원칙\n\n- `foundationVersion`이 버전의 **단일 정본**이다.\n- `package.json`의 `version` 필드는 빌더가 매 빌드 시 동기화하는 **파생 값**이다.\n- 빌더 코드에 버전을 하드코딩하지 않는다.\n\n---\n\n## sampleFolder — Assets\u002FSamples Generated 동기화 (Hard Rule)\n\n### 목적\n\n빌드 시 테이블\u002F프로토콜\u002Fcontract(JSON)에서 생성되는 코드(`Generated\u002F` 폴더)를 `Assets\u002FSamples` 경로에도 동기화한다.\n수동 코드(non-generated)의 전체 패치는 이 동기화의 범위가 아니다.\n\n### 설정\n\n```json\n\"sampleFolder\": \"..\u002Fframework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\"\n```\n\n- `{projectConfigJson}`에 선택적으로 지정한다.\n- 생략 시 이 동기화 단계를 건너뛴다 (기존 호환성 유지).\n\n### 경로 해석\n\n```\n{sampleFolder}\u002F{displayName}\u002F{version}\u002F{sampleName}\u002F\n```\n\n| 플레이스홀더 | 출처 | 예시 |\n|-------------|------|------|\n| `{sampleFolder}` | `{projectConfigJson}` 설정 값 | `..\u002Fframework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples` |\n| `{displayName}` | `com.devian.foundation\u002Fpackage.json` → `displayName` | `Devian Foundation` |\n| `{version}` | `{projectConfigJson}` → `foundationVersion` | `0.1.0` |\n| `{sampleName}` | `Samples~\u002F` 하위 폴더명 (= `package.json` samples[].path 기준) | `CommonPackage`, `GameProtocol` 등 |\n\n### 동기화 범위 (Generated Only)\n\n**빌드가 생성하는 `Generated\u002F` 폴더만 동기화한다.** 수동 코드는 건드리지 않는다.\n\n복사 대상:\n- `Runtime\u002FGenerated\u002F**` — `.cs` 파일만 복사 (`.meta` 보존)\n- `Editor\u002FGenerated\u002F**` — `.cs` 파일만 복사 (`.meta` 보존)\n\n### 동기화 조건\n\n- **대상 Sample 폴더가 존재할 때만** 동기화한다.\n- `{sampleFolder}\u002F{displayName}\u002F{version}\u002F{sampleName}\u002F`이 존재하지 않으면 skip (아직 Unity에서 Import하지 않은 상태).\n- Generated 폴더 자체가 없는 Sample (예: `MobilePackage`, `UIPackage` — 수동 코드만 있음)은 자연히 skip.\n\n### .meta 보존 정책\n\n- `.cs` 파일만 덮어쓴다. 기존 `.meta` 파일은 건드리지 않는다.\n- 새 `.cs` 파일이 추가되어 `.meta`가 없으면 Unity가 다음 실행 시 자동 생성한다.\n- 빌더가 `.meta`를 생성\u002F삭제\u002F수정하지 않는다.\n\n### 실행 시점\n\nPhase 4 (Sync: upm → packageDir) 이후에 실행한다.\n\n### 전체 패치 (수동 코드 포함)\n\n수동 코드를 포함한 전체 패치는 다음 두 경우에만 수행한다:\n- Unity Package Manager에서 수동 Import\n- 사용자가 3-path-mirror 전체 복사를 명시적으로 요청\n\n---\n\n## Unity C# Compatibility Gate (Hard Rule)\n\n**Unity C# 문법 제한은 [05-unity-csharp-compat](..\u002F05-unity-csharp-compat\u002FSKILL.md)가 정본이다.**\n\n이 문서에서는 금지 패턴\u002F검사 경로를 재정의하지 않는다.\n\n---\n\n## Table ID Inspector 생성물 Gate (Hard Rule)\n\n**Table ID Inspector 생성물은 `.json` 확장자 필터를 사용해야 한다.**\n\n검사 대상 경로:\n- `framework-cs\u002Fupm\u002F**\u002FEditor\u002FGenerated\u002F*.cs`\n- `framework-cs\u002Fapps\u002F**\u002FPackages\u002F**\u002FEditor\u002FGenerated\u002F*.cs`\n\n**Hard FAIL:**\n- 위 대상에서 문자열 `\".ndjson\"` 발견 시 **FAIL**\n- 정본: `.EndsWith(\".json\"` 형태여야 함\n\n---\n\n## See Also\n\n- [Root SSOT](..\u002F..\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md) — 공통 용어\u002F플레이스홀더\u002F머지 규칙\n- [Unity Policy](..\u002F01-policy\u002FSKILL.md) — UPM Sync\u002F미러\u002F경로 규칙\n- [Unity Bundles](..\u002F02-unity-bundles\u002FSKILL.md) — 패키지 묶음\u002Fasmdef\u002F의존 방향\n- [Unity C# Compat](..\u002F05-unity-csharp-compat\u002FSKILL.md) — C# 문법 제한\n- [Package Policy](..\u002F04-package-policy\u002FSKILL.md) — package.json 메타데이터\u002FSamples~ 정책\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F03-ssot","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add devwinsoft\u002Fdevian --skill 03-ssot",{"tool":36,"command":37},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 03-ssot",{"tool":39,"command":40},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 03-ssot","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F03-ssot\u002FSKILL.md",true,[44,50],{"path":45,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":48,"sourceHtmlUrl":49},"SOURCE.md","REFERENCE","参考文档",345,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fchains\u002Fmystenlabs-move-patterns\u002FSOURCE.md",{"path":51,"resourceType":46,"resourceTypeDesc":47,"sizeBytes":52,"sourceHtmlUrl":53},"TRUST.auto.yaml",2217,"https:\u002F\u002Fgithub.com\u002Fjiayaoqijia\u002Fcryptoskill\u002Fblob\u002Fmain\u002Fskills\u002Fchains\u002Fmystenlabs-move-patterns\u002FTRUST.auto.yaml",[55,61,69,77,86,93],{"skillNo":56,"name":57,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[57],{"skillNo":62,"name":63,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[67,68],"archive","90 project archive",{"skillNo":70,"name":71,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[75,76],"management","30 env management",{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[83,84,85],"push","page","19 page push send",{"skillNo":87,"name":88,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":19},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[84,92],"18 page savedata",{"skillNo":94,"name":95,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[84,99],"17 page deobfuscate"]