Files
web-alterflixhub/AGENTS.md
T
Bkk1234 319c271d23 feat: บทความ 2 หน้า + แชร์/ลิงก์ย่อ + PWA + แอนิเมชัน + SEO/AI + เอกสาร
- บทความจากหลังบ้าน: /for-film-lovers, /for-cinemas (ArticlePage + ArticleEditor แบบบล็อกย่อหน้า/รูป)
- แชร์: ปุ่มบนการ์ดและท้ายหน้ารายละเอียด · ลิงก์ย่อ /c/<slug> (302) · ธีมแก้วตาม DESIGN.md
- PWA: manifest/sw/offline + ถอดการล็อกซูม (WCAG 1.4.4) + touch target ≥44px
- แอนิเมชัน reveal: IntersectionObserver + gate ด้วย html.fx-motion · เคารพ prefers-reduced-motion
- ค้นหา: normalize/ตัดวรรณยุกต์ + AND หลายคำ + จัดอันดับ · รองรับ /?q= จาก SearchAction
- SEO: pageMeta (canonical/OG/Twitter) + JSON-LD (WebSite/Organization/BreadcrumbList/MovieTheater/Article)
- ไม่ฝังโดเมนในโค้ด: origin มาจาก request (x-forwarded-host/proto) ทั้ง canonical, sitemap, robots, ลิงก์แชร์
- กัน AI: robots.txt (Nitro route, บล็อก AI 21 ตัว) + ai.txt + OG image 1200x630
- เอกสาร: README สรุปโปรเจกต์, DESIGN.md (motion/PWA/SEO/ข้อมูล), architecture.html, admin-guide
- tests: 135 ผ่าน (16 ไฟล์)
2026-11-10 02:31:10 +07:00

5.8 KiB

App — Agent Guide

This starter ships as a blank Agent-Native app canvas — that describes its initial state, not necessarily its current one. See DEVELOPING.md before making any source code change.

Skills

Search with rg --hidden --follow; read the exact linked guide before deeper work. .agents/skills/build-an-app/SKILL.md — start here for vague requests to create a domain app. .agents/skills/adding-a-feature/SKILL.md — cross-area feature checklist. Data/integrations: .agents/skills/actions/SKILL.md, .agents/skills/storing-data/SKILL.md, .agents/skills/security/SKILL.md, .agents/skills/secrets/SKILL.md, .agents/skills/sharing/SKILL.md. UI: .agents/skills/frontend-design/SKILL.md, .agents/skills/shadcn-ui/SKILL.md, .agents/skills/client-side-routing/SKILL.md. Agent context/workflows: .agents/skills/context-awareness/SKILL.md, .agents/skills/real-time-sync/SKILL.md, .agents/skills/reliable-mutations/SKILL.md, .agents/skills/performance/SKILL.md, .agents/skills/delegate-to-agent/SKILL.md. Framework: .agents/skills/agent-native-docs/SKILL.md, .agents/skills/agent-native-toolkit/SKILL.md, .agents/skills/customizing-agent-native/SKILL.md.

Use local docs only (no web research): pnpm action docs-search --query "<topic>", pnpm action docs-search --slug "<slug>", pnpm action docs-search --list, pnpm action source-search --query "<pattern>", pnpm action source-search --path <path>, or pnpm action source-search --list. For external-agent integrations, read pnpm action docs-search --slug "external-agents".

This repo is a single standalone app (agent-native.scaffold.shape: "standalone"), not a workspace root. If the user asks for a workspace, a platform or suite of apps, a second app, an app shell or launcher, or Dispatch, read the multi-app-workspace skill before touching the repo layout.

Core rules

  • UI feedback: target 100 ms, never exceed 400 ms; acknowledge before network work.
  • Normal app data must flow through actions. Keep actions deterministic and focused; use agent chat/AgentSidebar for AI work and follow-ups in the same thread. Keep structured state in SQL and large files in configured storage; persist references only.
  • For external integrations, inspect the workspace/provider connection catalog first; reuse its scoped resolver. Never hardcode credentials, webhook URLs, or private/customer data.
  • Never fabricate. Report failures and recover; verify writes by reading the row or screen. Navigation is in <current-screen>; use view-screen for fresh visible-record details.
  • PWA: ห้ามลบ <link rel="manifest"> ใน app/root.tsx · ทุกครั้งที่ปล่อยเวอร์ชันให้ bump VERSION ใน public/sw.js (ขั้น activate จะลบแคชเก่าให้เอง) · ไอคอนแอปเป็น PNG (public/icon-192|512|maskable-512|180.png) ไม่ใช่ SVG

For custom branding, keep server/plugins/agent-native-email-branding.ts aligned: app.name appears in transactional email and optional app.logoUrl must be an absolute HTTPS URL.

Application state

  • navigation describes the view and selected ids. The default home view is home at / (blank app canvas). No agent rail or chat is mounted by default; add one only when the user asks.
  • Use navigate when supported and view-screen for a fresh read of visible details; basic navigation is already in <current-screen>.

Building a domain app

Choose the primary workflow and route before editing. Build on the blank canvas in app/routes/_index.tsx or add domain routes under app/routes/. This starter has no Chat route, sidebar, header, or agent rail; add only the navigation the product needs. Set app.homePath in the existing defineAppConfig in server/plugins/config.ts as DEVELOPING.md describes.

Use adding-a-feature for functional parity and frontend-design for a user-facing screen. Keep feature guidance here and update README.md as DEVELOPING.md describes. After all edits, run one typecheck, one doctor check, and one browser smoke of the primary workflow and its authenticated landing. Skip production build and extra test suites.

Before building common workspace or agent UI, read agent-native-toolkit; for supported customization, read customizing-agent-native.

  • 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

  • คู่มือใช้งานหลังบ้าน (ภาษาไทย ทีละงาน): docs/admin-guide.md · API reference: docs/api.md

  • เมื่อเพิ่ม/เปลี่ยนฟิลด์ใน Cinema, หมวดหมู่, หรือ flow ของหลังบ้าน → อัปเดต DESIGN.md + docs/architecture.html + docs/admin-guide.md พร้อมกัน (ห้ามปล่อยเอกสารตกรุ่น)

  • ห้ามเขียนทับ data/content/content.json ด้วย seed: readContent() โยน error เมื่อไฟล์เสีย และสำรอง .output/content.json.bakN ก่อนแก้ด้วยสคริปต์