[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78EMABJD3XMZYDBZ4TAN84W":3,"skill-same:01M78EMABJD3XMZYDBZ4TAN84W":53},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":46},"01M78EMABJD3XMZYDBZ4TAN84W","setup-ts-deep-modules",null,"ติดตั้ง dependency-cruiser เข้า repo TypeScript เพื่อให้แต่ละ package เป็น deep module — implementation ถูกซ่อนไว้ใน subfolder เข้าถึงได้ผ่านไฟล์ entry point เท่านั้น สำหรับให้ user เรียกใช้เอง","Boom-Vitt\u002Fskills-thai","Boom-Vitt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F169876956?v=4","01M78EJ7J23WSZJ2R2WTZGGAPR","Vittawat","01M78EJ7JPKFWHN7WJ94HE7F9R",5,"MIT","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fin-progress\u002Fsetup-ts-deep-modules\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: setup-ts-deep-modules\ndescription: ติดตั้ง dependency-cruiser เข้า repo TypeScript เพื่อให้แต่ละ package เป็น deep module — implementation ถูกซ่อนไว้ใน subfolder เข้าถึงได้ผ่านไฟล์ entry point เท่านั้น สำหรับให้ user เรียกใช้เอง\ndisable-model-invocation: true\n---\n\n# Setup TS Deep Modules\n\nทำให้ทุก package ใน repo นี้เป็น **deep module** (module ที่มีพฤติกรรมเยอะแต่ interface เล็ก): พฤติกรรมจำนวนมากอยู่หลัง interface ที่เล็ก พื้นผิว public ของ package คือ **entry points** ของมัน — ไฟล์ที่อยู่ที่ root ของ package — และทุกอย่างใน subfolder ถูกซ่อนไว้ skill นี้ติดตั้ง [dependency-cruiser](https:\u002F\u002Fgithub.com\u002Fsverweij\u002Fdependency-cruiser) พร้อมกฎที่ทำให้ entry points เป็นทางเข้าเดียว แล้วพิสูจน์ว่ากฎกัดจริง\n\nสำหรับ vocabulary (deep module, interface, seam, depth) ให้รัน skill `\u002Fcodebase-design` — และใช้ภาษาของมันตลอดทั้งงาน\n\n## รูปทรงที่กฎนี้บังคับ\n\n```\nsrc\u002Fpackages\u002F\n  \u003Cname>\u002F\n    index.ts        ← an entry point (public). Import this from outside.\n    client.ts       ← another entry point. Packages may expose SEVERAL.\n    lib\u002F            ← implementation: hidden from outside, free to import each other.\n    tests\u002F          ← co-located tests + fixtures (a subfolder, so private).\n```\n\nพื้นผิว public คือ**ไฟล์ที่ root** ของ package — ไม่ใช่ `index.ts` ตัวใดตัวหนึ่งที่ถูกกำหนดไว้ ตามธรรมเนียมแล้ว implementation อยู่ใน `lib\u002F` และ test อยู่ใน `tests\u002F` ทำให้ทุก package มีรูปทรงสองโฟลเดอร์เหมือนกันหมด แต่ตัวกฎเองเป็นกฎทั่วไป: *อะไรก็ตาม*ใน subfolder *ไหนก็ตาม*ถือเป็น private ดังนั้นคุณไม่ต้องไปขยาย config เพื่อเพิ่มโฟลเดอร์เลย\n\nกฎสี่ข้อ ทั้งหมดเป็นระดับ `error`:\n\n1. **Entry-point boundary** — code ที่อยู่นอก package (app code หรือ package อื่น) import ได้เฉพาะ entry points ของ package นั้น (ไฟล์ที่ root) ห้ามแตะอะไรใน subfolder เด็ดขาด\n2. **Intra-package freedom** — ไฟล์ภายใน package เดียวกัน import กันเองได้อย่างอิสระ\n3. **Tests through the entry points** — ไฟล์ใต้ `\u003Cpkg>\u002Ftests\u002F` import ได้เฉพาะ entry points ของ package ใด ๆ กับ fixture ใน `tests\u002F` ของตัวเอง แต่ห้าม import internals ใน subfolder ของ package ไหนทั้งนั้น (แม้แต่ของตัวเอง) integration test ข้าม package ทำได้ แต่ deep import ทำไม่ได้\n4. **No cycles** — ห้ามมี dependency cycle\n\n**Entry points ไม่ใช่ barrel** เพราะพื้นผิว public คือไฟล์ root *ทุกไฟล์* package หนึ่งจึงเปิด entry point เล็ก ๆ ได้หลายตัว (`index.ts`, `client.ts`, `server.ts`) แทนที่จะบีบทุกอย่างผ่าน `index.ts` ยักษ์ตัวเดียว barrel file ที่ re-export ทั้ง subtree เป็นสิ่งที่ไม่แนะนำ — ทำ entry point ให้เล็กและซ่อน implementation ไว้ใน subfolder\n\nส่วนเรื่อง layering (package ไหนพึ่ง package ไหนได้บ้าง) เป็น*คนละ*ประเด็น และถูกทิ้งไว้เป็น stub แบบ comment ใน config ให้ repo นี้เติมเอง\n\n## ขั้นตอน\n\n### 1. ตรวจสภาพแวดล้อม\n\n- **Package manager** — `pnpm-lock.yaml` → pnpm, `yarn.lock` → yarn, `bun.lockb` → bun, นอกนั้นคือ npm ใช้ตัวที่ตรวจพบกับทุกคำสั่งด้านล่าง (`pnpm`\u002F`yarn`\u002F`npm run`\u002F`bunx`)\n- **Packages root** — ถ้ามี `src\u002F` ให้ใช้ `src\u002Fpackages` ไม่งั้นใช้ `packages` ถ้า repo มีธรรมเนียมอื่นที่ชัดเจนอยู่แล้ว ให้ยืนยันตัวเลือกกับ user ก่อน\n- **Config เดิม** — เช็คว่ามีไฟล์ `.dependency-cruiser.*` อยู่ไหม ถ้ามี **ห้าม**เขียนทับ: ให้ merge กฎสี่ข้อกับ options เข้าไป แล้วบอก user ว่าเพิ่มอะไรไปบ้าง\n\n**เสร็จเมื่อ:** รู้ครบทั้ง package manager, packages root และสถานะของ config เดิม\n\n### 2. ติดตั้ง dependency-cruiser\n\nติดตั้ง `dependency-cruiser` เป็น devDependency ด้วย package manager ที่ตรวจพบ\n\n**เสร็จเมื่อ:** `dependency-cruiser` อยู่ใน `devDependencies`\n\n### 3. เขียน config\n\nคัดลอก [`dependency-cruiser.config.cjs`](.\u002Fdependency-cruiser.config.cjs) ไปไว้ที่ root ของ repo ในชื่อ `.dependency-cruiser.cjs` ตั้ง `PACKAGES_ROOT` เป็น root ที่ตรวจพบในขั้น 1 ตัวกฎอิงจากความลึกของ path และไม่ผูกกับนามสกุลไฟล์ จึงไม่ต้องปรับอะไรอย่างอื่นอีก\n\n**เสร็จเมื่อ:** `.dependency-cruiser.cjs` มีอยู่จริงพร้อม `PACKAGES_ROOT` ที่ถูกต้อง และมีกฎ forbidden ครบทั้งสี่ข้อ\n\n### 4. ต่อเข้ากับชุด check\n\n- เพิ่ม script `lint:boundaries`: `depcruise \u003Cpackages-root>` (หรือ `depcruise src`)\n- พับมันเข้าไปในคำสั่ง check รวมของ repo — ตัวที่รัน typecheck อยู่แล้ว (เช่น script `check` \u002F `ci` \u002F `validate`) **ห้าม**แตะ `tsconfig` หรือเพิ่ม path alias\n- ถ้าไม่มี script รวม ให้เพิ่ม `lint:boundaries` แล้วบอก user ให้เอาไปใส่ใน CI\n\n**เสร็จเมื่อ:** `lint:boundaries` มีอยู่และรันเป็นส่วนหนึ่งของคำสั่งเดียวกับ typecheck\n\n### 5. Scaffold package ตัวอย่าง\n\nสร้าง `\u003Cpackages-root>\u002Fexample\u002F` แบบ commit เข้า repo เป็น template ให้คัดลอกไปใช้:\n\n- `index.ts` — entry point ตัวหนึ่ง export ฟังก์ชันหนึ่งตัวที่ delegate ไปยังไฟล์ภายใน (เพื่อให้เห็นชัดว่า package นี้ *deep* จริง ไม่ใช่แค่ pass-through)\n- `lib\u002Fimpl.ts` — ไฟล์ภายในที่อยู่ใน **subfolder** ถูก import โดย `index.ts` และเข้าถึงจากภายนอกไม่ได้\n- `tests\u002Fexample.test.ts` — import **เฉพาะ** `..\u002Findex` (entry point) และ assert กับฟังก์ชัน public\n\nบอก user ว่านี่คือ template ตั้งต้นไว้คัดลอกหรือลบทิ้งก็ได้\n\n**เสร็จเมื่อ:** package ตัวอย่างมีอยู่จริง เปิดพฤติกรรมผ่าน entry point ที่ root และซ่อน `impl` ไว้ใน subfolder\n\n### 6. พิสูจน์ว่ากฎกัดจริง\n\nนี่คือเกณฑ์ความสำเร็จของ skill ทั้งตัว — config ที่ไม่ fail ตอนมีการละเมิดคือของไร้ค่า\n\n1. รัน `lint:boundaries` มันต้อง**ผ่าน**บน example ที่สะอาด\n2. เพิ่ม deep import ชั่วคราวเข้าไปใน `tests\u002Fexample.test.ts` (เช่น `import { thing } from \"..\u002Flib\u002Fimpl\"`) แล้วรัน `lint:boundaries` อีกครั้ง — มันต้อง **fail** ด้วยกฎ `tests-through-entrypoints`\n3. เอา deep import ออก รันอีกรอบ — มันต้อง**ผ่าน**\n\n**เสร็จเมื่อ:** คุณเห็นด้วยตาว่าผ่าน แล้ว fail บน deep import แล้วกลับมาผ่านอีกครั้ง ถ้าขั้น 2 ไม่ fail แปลว่ากฎยังต่อไม่ถูก — แก้ให้เสร็จก่อนจบงาน\n\n### 7. บันทึกธรรมเนียมเป็นเอกสาร\n\nเขียน `README.md` **ในโฟลเดอร์ packages** (`\u003Cpackages-root>\u002FREADME.md`) — วางไว้ข้าง ๆ packages ที่มันกำกับ — ครอบคลุม: layout แบบ `src\u002Fpackages\u002F\u003Cname>\u002F` (entry points ที่ root, `lib\u002F` สำหรับ implementation, `tests\u002F` สำหรับ test), กติกา \"import ผ่าน entry points ของ package (ไฟล์ที่ root) เท่านั้น\" และวิธีรัน `lint:boundaries` **ระบุชัด ๆ ว่าไม่แนะนำ barrel file** — ให้เปิด entry point เล็ก ๆ หลายตัวแทนการ re-export ทั้ง subtree ผ่าน index ตัวเดียว เขียนให้กระชับ: snippet ให้คัดลอก บวกกฎสี่ข้อ ข้อละหนึ่งย่อหน้า\n\nจากนั้นเพิ่ม **context pointer** ชี้ไปหามันจากไฟล์ agent-instructions ของ repo — `CLAUDE.md` ถ้ามี ไม่งั้นใช้ `AGENTS.md` (สร้าง `AGENTS.md` ถ้าไม่มีทั้งคู่) บรรทัดเดียวก็พอ เช่น `Packages are deep modules — see [src\u002Fpackages\u002FREADME.md](.\u002Fsrc\u002Fpackages\u002FREADME.md) before adding or importing one.` นี่แหละคือสิ่งที่ทำให้ agent ค้นพบกฎ boundary เอง แทนที่จะเดินสะดุดมัน\n\n**เสร็จเมื่อ:** `\u003Cpackages-root>\u002FREADME.md` มีอยู่จริงและไม่แนะนำ barrel และ `CLAUDE.md`\u002F`AGENTS.md` ของ repo มีลิงก์ไปหามัน\n\n## หมายเหตุ\n\n- back-reference `$1` ใน config (การ match แบบ group ของ dependency-cruiser) คือสิ่งที่ทำให้ package เข้าถึง internals ของตัวเองได้ในขณะที่คนนอกทำไม่ได้ — อย่าคลี่มันออกเป็นกฎแยกรายต่อ package\n- public กับ private ตัดสินด้วย**ความลึก**: ไฟล์ที่ root ของ package คือ entry points ส่วนอะไรก็ตามใน subfolder คือ private โฟลเดอร์ตามธรรมเนียมคือ `lib\u002F` (implementation) กับ `tests\u002F` แต่กฎไม่ได้ hardcode ชื่อพวกนี้ — subfolder ไหนก็ private หมด ดังนั้นเพิ่มโฟลเดอร์ใหม่ก็ไม่ต้องแก้ config เลย ส่วนการเพิ่ม entry point ก็แค่เพิ่มไฟล์ที่ root — ไม่ต้องมี barrel\n- Packages เป็นแบบ**แบน**: มีลูกชั้นเดียวใต้ root โดยตรง internals ของ package จะซ้อนลึกแค่ไหนก็ได้ แต่ package ห้ามมี package อื่นซ้อนอยู่ข้างใน\n- ใช้ `.cjs` (ไม่ใช่ `.js`) เพื่อให้ `module.exports` ของ config ทำงานได้แม้ใน repo ที่เป็น `\"type\": \"module\"`\n","# Setup TS Deep Modules\n\nทำให้ทุก package ใน repo นี้เป็น **deep module** (module ที่มีพฤติกรรมเยอะแต่ interface เล็ก): พฤติกรรมจำนวนมากอยู่หลัง interface ที่เล็ก พื้นผิว public ของ package คือ **entry points** ของมัน — ไฟล์ที่อยู่ที่ root ของ package — และทุกอย่างใน subfolder ถูกซ่อนไว้ skill นี้ติดตั้ง [dependency-cruiser](https:\u002F\u002Fgithub.com\u002Fsverweij\u002Fdependency-cruiser) พร้อมกฎที่ทำให้ entry points เป็นทางเข้าเดียว แล้วพิสูจน์ว่ากฎกัดจริง\n\nสำหรับ vocabulary (deep module, interface, seam, depth) ให้รัน skill `\u002Fcodebase-design` — และใช้ภาษาของมันตลอดทั้งงาน\n\n## รูปทรงที่กฎนี้บังคับ\n\n```\nsrc\u002Fpackages\u002F\n  \u003Cname>\u002F\n    index.ts        ← an entry point (public). Import this from outside.\n    client.ts       ← another entry point. Packages may expose SEVERAL.\n    lib\u002F            ← implementation: hidden from outside, free to import each other.\n    tests\u002F          ← co-located tests + fixtures (a subfolder, so private).\n```\n\nพื้นผิว public คือ**ไฟล์ที่ root** ของ package — ไม่ใช่ `index.ts` ตัวใดตัวหนึ่งที่ถูกกำหนดไว้ ตามธรรมเนียมแล้ว implementation อยู่ใน `lib\u002F` และ test อยู่ใน `tests\u002F` ทำให้ทุก package มีรูปทรงสองโฟลเดอร์เหมือนกันหมด แต่ตัวกฎเองเป็นกฎทั่วไป: *อะไรก็ตาม*ใน subfolder *ไหนก็ตาม*ถือเป็น private ดังนั้นคุณไม่ต้องไปขยาย config เพื่อเพิ่มโฟลเดอร์เลย\n\nกฎสี่ข้อ ทั้งหมดเป็นระดับ `error`:\n\n1. **Entry-point boundary** — code ที่อยู่นอก package (app code หรือ package อื่น) import ได้เฉพาะ entry points ของ package นั้น (ไฟล์ที่ root) ห้ามแตะอะไรใน subfolder เด็ดขาด\n2. **Intra-package freedom** — ไฟล์ภายใน package เดียวกัน import กันเองได้อย่างอิสระ\n3. **Tests through the entry points** — ไฟล์ใต้ `\u003Cpkg>\u002Ftests\u002F` import ได้เฉพาะ entry points ของ package ใด ๆ กับ fixture ใน `tests\u002F` ของตัวเอง แต่ห้าม import internals ใน subfolder ของ package ไหนทั้งนั้น (แม้แต่ของตัวเอง) integration test ข้าม package ทำได้ แต่ deep import ทำไม่ได้\n4. **No cycles** — ห้ามมี dependency cycle\n\n**Entry points ไม่ใช่ barrel** เพราะพื้นผิว public คือไฟล์ root *ทุกไฟล์* package หนึ่งจึงเปิด entry point เล็ก ๆ ได้หลายตัว (`index.ts`, `client.ts`, `server.ts`) แทนที่จะบีบทุกอย่างผ่าน `index.ts` ยักษ์ตัวเดียว barrel file ที่ re-export ทั้ง subtree เป็นสิ่งที่ไม่แนะนำ — ทำ entry point ให้เล็กและซ่อน implementation ไว้ใน subfolder\n\nส่วนเรื่อง layering (package ไหนพึ่ง package ไหนได้บ้าง) เป็น*คนละ*ประเด็น และถูกทิ้งไว้เป็น stub แบบ comment ใน config ให้ repo นี้เติมเอง\n\n## ขั้นตอน\n\n### 1. ตรวจสภาพแวดล้อม\n\n- **Package manager** — `pnpm-lock.yaml` → pnpm, `yarn.lock` → yarn, `bun.lockb` → bun, นอกนั้นคือ npm ใช้ตัวที่ตรวจพบกับทุกคำสั่งด้านล่าง (`pnpm`\u002F`yarn`\u002F`npm run`\u002F`bunx`)\n- **Packages root** — ถ้ามี `src\u002F` ให้ใช้ `src\u002Fpackages` ไม่งั้นใช้ `packages` ถ้า repo มีธรรมเนียมอื่นที่ชัดเจนอยู่แล้ว ให้ยืนยันตัวเลือกกับ user ก่อน\n- **Config เดิม** — เช็คว่ามีไฟล์ `.dependency-cruiser.*` อยู่ไหม ถ้ามี **ห้าม**เขียนทับ: ให้ merge กฎสี่ข้อกับ options เข้าไป แล้วบอก user ว่าเพิ่มอะไรไปบ้าง\n\n**เสร็จเมื่อ:** รู้ครบทั้ง package manager, packages root และสถานะของ config เดิม\n\n### 2. ติดตั้ง dependency-cruiser\n\nติดตั้ง `dependency-cruiser` เป็น devDependency ด้วย package manager ที่ตรวจพบ\n\n**เสร็จเมื่อ:** `dependency-cruiser` อยู่ใน `devDependencies`\n\n### 3. เขียน config\n\nคัดลอก [`dependency-cruiser.config.cjs`](.\u002Fdependency-cruiser.config.cjs) ไปไว้ที่ root ของ repo ในชื่อ `.dependency-cruiser.cjs` ตั้ง `PACKAGES_ROOT` เป็น root ที่ตรวจพบในขั้น 1 ตัวกฎอิงจากความลึกของ path และไม่ผูกกับนามสกุลไฟล์ จึงไม่ต้องปรับอะไรอย่างอื่นอีก\n\n**เสร็จเมื่อ:** `.dependency-cruiser.cjs` มีอยู่จริงพร้อม `PACKAGES_ROOT` ที่ถูกต้อง และมีกฎ forbidden ครบทั้งสี่ข้อ\n\n### 4. ต่อเข้ากับชุด check\n\n- เพิ่ม script `lint:boundaries`: `depcruise \u003Cpackages-root>` (หรือ `depcruise src`)\n- พับมันเข้าไปในคำสั่ง check รวมของ repo — ตัวที่รัน typecheck อยู่แล้ว (เช่น script `check` \u002F `ci` \u002F `validate`) **ห้าม**แตะ `tsconfig` หรือเพิ่ม path alias\n- ถ้าไม่มี script รวม ให้เพิ่ม `lint:boundaries` แล้วบอก user ให้เอาไปใส่ใน CI\n\n**เสร็จเมื่อ:** `lint:boundaries` มีอยู่และรันเป็นส่วนหนึ่งของคำสั่งเดียวกับ typecheck\n\n### 5. Scaffold package ตัวอย่าง\n\nสร้าง `\u003Cpackages-root>\u002Fexample\u002F` แบบ commit เข้า repo เป็น template ให้คัดลอกไปใช้:\n\n- `index.ts` — entry point ตัวหนึ่ง export ฟังก์ชันหนึ่งตัวที่ delegate ไปยังไฟล์ภายใน (เพื่อให้เห็นชัดว่า package นี้ *deep* จริง ไม่ใช่แค่ pass-through)\n- `lib\u002Fimpl.ts` — ไฟล์ภายในที่อยู่ใน **subfolder** ถูก import โดย `index.ts` และเข้าถึงจากภายนอกไม่ได้\n- `tests\u002Fexample.test.ts` — import **เฉพาะ** `..\u002Findex` (entry point) และ assert กับฟังก์ชัน public\n\nบอก user ว่านี่คือ template ตั้งต้นไว้คัดลอกหรือลบทิ้งก็ได้\n\n**เสร็จเมื่อ:** package ตัวอย่างมีอยู่จริง เปิดพฤติกรรมผ่าน entry point ที่ root และซ่อน `impl` ไว้ใน subfolder\n\n### 6. พิสูจน์ว่ากฎกัดจริง\n\nนี่คือเกณฑ์ความสำเร็จของ skill ทั้งตัว — config ที่ไม่ fail ตอนมีการละเมิดคือของไร้ค่า\n\n1. รัน `lint:boundaries` มันต้อง**ผ่าน**บน example ที่สะอาด\n2. เพิ่ม deep import ชั่วคราวเข้าไปใน `tests\u002Fexample.test.ts` (เช่น `import { thing } from \"..\u002Flib\u002Fimpl\"`) แล้วรัน `lint:boundaries` อีกครั้ง — มันต้อง **fail** ด้วยกฎ `tests-through-entrypoints`\n3. เอา deep import ออก รันอีกรอบ — มันต้อง**ผ่าน**\n\n**เสร็จเมื่อ:** คุณเห็นด้วยตาว่าผ่าน แล้ว fail บน deep import แล้วกลับมาผ่านอีกครั้ง ถ้าขั้น 2 ไม่ fail แปลว่ากฎยังต่อไม่ถูก — แก้ให้เสร็จก่อนจบงาน\n\n### 7. บันทึกธรรมเนียมเป็นเอกสาร\n\nเขียน `README.md` **ในโฟลเดอร์ packages** (`\u003Cpackages-root>\u002FREADME.md`) — วางไว้ข้าง ๆ packages ที่มันกำกับ — ครอบคลุม: layout แบบ `src\u002Fpackages\u002F\u003Cname>\u002F` (entry points ที่ root, `lib\u002F` สำหรับ implementation, `tests\u002F` สำหรับ test), กติกา \"import ผ่าน entry points ของ package (ไฟล์ที่ root) เท่านั้น\" และวิธีรัน `lint:boundaries` **ระบุชัด ๆ ว่าไม่แนะนำ barrel file** — ให้เปิด entry point เล็ก ๆ หลายตัวแทนการ re-export ทั้ง subtree ผ่าน index ตัวเดียว เขียนให้กระชับ: snippet ให้คัดลอก บวกกฎสี่ข้อ ข้อละหนึ่งย่อหน้า\n\nจากนั้นเพิ่ม **context pointer** ชี้ไปหามันจากไฟล์ agent-instructions ของ repo — `CLAUDE.md` ถ้ามี ไม่งั้นใช้ `AGENTS.md` (สร้าง `AGENTS.md` ถ้าไม่มีทั้งคู่) บรรทัดเดียวก็พอ เช่น `Packages are deep modules — see [src\u002Fpackages\u002FREADME.md](.\u002Fsrc\u002Fpackages\u002FREADME.md) before adding or importing one.` นี่แหละคือสิ่งที่ทำให้ agent ค้นพบกฎ boundary เอง แทนที่จะเดินสะดุดมัน\n\n**เสร็จเมื่อ:** `\u003Cpackages-root>\u002FREADME.md` มีอยู่จริงและไม่แนะนำ barrel และ `CLAUDE.md`\u002F`AGENTS.md` ของ repo มีลิงก์ไปหามัน\n\n## หมายเหตุ\n\n- back-reference `$1` ใน config (การ match แบบ group ของ dependency-cruiser) คือสิ่งที่ทำให้ package เข้าถึง internals ของตัวเองได้ในขณะที่คนนอกทำไม่ได้ — อย่าคลี่มันออกเป็นกฎแยกรายต่อ package\n- public กับ private ตัดสินด้วย**ความลึก**: ไฟล์ที่ root ของ package คือ entry points ส่วนอะไรก็ตามใน subfolder คือ private โฟลเดอร์ตามธรรมเนียมคือ `lib\u002F` (implementation) กับ `tests\u002F` แต่กฎไม่ได้ hardcode ชื่อพวกนี้ — subfolder ไหนก็ private หมด ดังนั้นเพิ่มโฟลเดอร์ใหม่ก็ไม่ต้องแก้ config เลย ส่วนการเพิ่ม entry point ก็แค่เพิ่มไฟล์ที่ root — ไม่ต้องมี barrel\n- Packages เป็นแบบ**แบน**: มีลูกชั้นเดียวใต้ root โดยตรง internals ของ package จะซ้อนลึกแค่ไหนก็ได้ แต่ package ห้ามมี package อื่นซ้อนอยู่ข้างใน\n- ใช้ `.cjs` (ไม่ใช่ `.js`) เพื่อให้ `module.exports` ของ config ทำงานได้แม้ใน repo ที่เป็น `\"type\": \"module\"`\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","97984d244d381a97b3637b4bd699369ba8e51ac0","skills\u002Fin-progress\u002Fsetup-ts-deep-modules",1,"https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai","https:\u002F\u002Fgithub.com\u002FBoom-Vitt","boombignose.org","🐼 AI ภาษาไทยแบบโอเพนซอร์ส · Claude Code skills & plugins · BoomBigNose Lab (Thai dialect ASR) · YouTube @BoomBigNose","2026-10-22 18:20:06",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":24},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Boom-Vitt\u002Fskills-thai --skill setup-ts-deep-modules",{"tool":40,"command":41},"bunx","bunx skills add Boom-Vitt\u002Fskills-thai --skill setup-ts-deep-modules",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Boom-Vitt\u002Fskills-thai --skill setup-ts-deep-modules","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fin-progress\u002Fsetup-ts-deep-modules\u002FSKILL.md",[47],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"dependency-cruiser.config.cjs","SCRIPT","脚本",3732,"https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fin-progress\u002Fsetup-ts-deep-modules\u002Fdependency-cruiser.config.cjs",[54,61,68,75,82,89],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M78ENEAFFV60T0N5AZ71D4G5","writing-great-skills","อ้างอิงสำหรับการเขียนและแก้ไข skill ให้ดี — คำศัพท์และหลักการที่ทำให้ skill ทำงานได้อย่างคาดเดาได้","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-great-skills\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M78ENCCQYAY3NW5VC0B1QCE0","teach","สอน skill หรือ concept ใหม่ให้ผู้ใช้ ภายใน workspace นี้","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M78ENA816K7VBBWJ7J9897QN","handoff","บีบอัดบทสนทนาปัจจุบันให้เป็นเอกสาร handoff สำหรับให้ agent ตัวอื่นรับช่วงต่อ","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M78EN896S7B63SXKPDEDGMBC","grilling","ซักถาม user อย่างไม่ปรานีเกี่ยวกับแผนหรือ design ใช้เมื่อ user อยาก stress-test แผนก่อนลงมือสร้าง หรือใช้ trigger phrase ใด ๆ ที่มีคำว่า 'grill'","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M78EN6PYS1E3T9QTPZ9J10EN","grill-me","บทสัมภาษณ์แบบไม่ปล่อยผ่าน เพื่อทำให้ plan หรือ design คมขึ้น","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrill-me\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M78EN4A7TXNABFXQWHK2FS01","obsidian-vault","ค้นหา สร้าง และจัดการ note ใน Obsidian vault ด้วย wikilinks และ index note ใช้เมื่อ user อยากหา สร้าง หรือจัดระเบียบ note ใน Obsidian","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fobsidian-vault\u002FSKILL.md",[],[]]