From f3798e40da5828c10d0da46bad6fa7ae7b214a9d Mon Sep 17 00:00:00 2001 From: Bkk1234 Date: Sat, 14 Nov 2026 13:42:42 +0700 Subject: [PATCH] =?UTF-8?q?docs(agents):=20=E0=B9=81=E0=B8=81=E0=B9=89=20A?= =?UTF-8?q?GENTS.md=20=E0=B9=83=E0=B8=AB=E0=B9=89=E0=B8=95=E0=B8=A3?= =?UTF-8?q?=E0=B8=87=E0=B8=88=E0=B8=A3=E0=B8=B4=E0=B8=87=20+=20=E0=B8=81?= =?UTF-8?q?=E0=B8=8E=20cross-engine=20parity?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - SEO/AI: ไม่มี "SITE_URL แหล่งโดเมนเดียว" แล้ว — โดเมนจาก origin ของ request, robots เป็น Nitro route ไม่ใช่ public/ - เพิ่มกฎ cross-engine: vendor-specific CSS ต้องมีคู่ของอีกเอนจิน และห้ามผูกอนิเมชันกับคลาส fx-motion อย่างเดียว --- AGENTS.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 3149521..bfad180 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -43,7 +43,8 @@ Before building common workspace or agent UI, read `agent-native-toolkit`; for s - Guarded verification: run `pnpm agent-native:doctor`; fix findings before done. - แผนผังการทำงาน (Frontend / Backend / Data): `docs/architecture.html` — เอกสารประกอบ เปิดด้วยเบราว์เซอร์ ไม่ถูก build เข้าแอป; อัปเดตเมื่อโครง route/API/data เปลี่ยน -- SEO/AI: ข้อบังคับอยู่ใน `DESIGN.md` หัวข้อ "SEO และการป้องกัน AI" — `SITE_URL` คือแหล่งโดเมนเดียว, `app/lib/seo.ts` คือตัวสร้าง meta ทั้งหมด, `server/routes/sitemap.xml.ts` + `public/robots.txt` + `public/ai.txt` คือไฟล์สำหรับ crawler +- SEO/AI: ข้อบังคับอยู่ใน `DESIGN.md` หัวข้อ "SEO และการป้องกัน AI" — **ห้ามฝังโดเมนในโค้ด**: canonical/OG/JSON-LD/sitemap/robots/ลิงก์แชร์มาจาก origin ของ request (`app/lib/request-origin.ts` + `resolvePageOrigin()`), ตัวสร้าง meta คือ `app/lib/seo.ts`, ไฟล์ crawler คือ `server/routes/sitemap.xml.ts` + `server/routes/robots.txt.ts` (Nitro route — ไม่ใช่ `public/`) + `public/ai.txt` · งาน cross-engine (Chromium/Firefox/Safari) ดูหัวข้อ "Cross-engine parity" ใน `DESIGN.md` - คู่มือใช้งานหลังบ้าน (ภาษาไทย ทีละงาน): `docs/admin-guide.md` · API reference: `docs/api.md` +- Cross-engine parity: ทุกครั้งที่เพิ่ม CSS แบบ vendor-specific (`::-webkit-*`, `-webkit-mask-*`, `::-moz-*`) หรือสไตล์ของ native control ต้องใส่คู่ของอีกเอนจินในบล็อก "ความเท่ากันข้ามเอนจิน" (`app/global.css`, อยู่ใน `@layer base`) — **ตัวอนิเมชันห้ามผูกกับคลาส `fx-motion` อย่างเดียว** (เคยทำให้อนิเมชันหายทั้งเว็บ) · ข้อยกเว้นที่ตั้งใจปล่อยไว้ดูตารางใน `DESIGN.md` - เมื่อเพิ่ม/เปลี่ยนฟิลด์ใน `Cinema`, หมวดหมู่, หรือ flow ของหลังบ้าน → อัปเดต `DESIGN.md` + `docs/architecture.html` + `docs/admin-guide.md` พร้อมกัน (ห้ามปล่อยเอกสารตกรุ่น) - ห้ามเขียนทับ `data/content/content.json` ด้วย seed: `readContent()` โยน error เมื่อไฟล์เสีย และสำรอง `.output/content.json.bakN` ก่อนแก้ด้วยสคริปต์