thanatornPik/nextjs-skill-app-workshop

Project Onboarding Skill

ช่วย developer ใหม่เข้าใจ project นี้จาก clone ไปจนรัน local ได้ โดยต้องอ้างอิงจากไฟล์จริงใน repo ก่อนตอบ

Gotchas

• ห้ามเดา script ที่ไม่มีใน package.json
• ห้ามใช้คำสั่ง database destructive ระหว่าง onboarding เช่น npx prisma db push, npx prisma migrate deploy, npx prisma migrate dev
• ถ้าพูดถึง Docker ต้องตรวจทั้ง Dockerfile และ next.config.ts

Setup Step

ให้้ตรวจและรัน script นี้ก่อน .agents/skills/project-boarding-guide/scripts/check-onboarding.sh ถ้ารัน script ไม่ได้ ให้ตรวจเอง​:

• package.json
• .env.example
• prisma/schema.json
• Dockerfile
• next.config.ts

สำหรับ onboarding ทั่วไป ให้แนะนำเฉพาะคำสั่งเหล่านี้ที่ปลอดภัย:

npm install
cp .env.example .env
npx prisma generate
npm run lint
npm run dev

ถ้า user ถามเรื่อง database setup หรือ seed data โดยตรง ให้อ่านไฟล์นี้ references/database-setup.md

Project gotchas

อ่านรายละเอียดเพิ่มที่ references/project-notes.md

• Next.js App Router + TypeScript
• Prisma ใช้ custom output ไปที่ generated/prisma
• Prisma Client import จาก generated path ไม่ใช่ @prisma/client
• Dockerfile อาจใช้ .next/standalone; ต้องมี output: "standalone" ใน next.config.ts
• UI หลักเป็นภาษาไทย

Output format

ถ้าถามเกี่ยวกับ setup หรือตั้งค่าโปรเจกต์ ให้ใช้ template ใน assets/templates/setup-table.md เท่านั้น

ต้องมีอย่างน้อย:

• ภาพรวมสั้น ๆ
• ตารางขั้นตอน setup
• คำสั่งที่ต้องรัน
• ข้อควรระวังของ repo นี้