เขียนไฟล์บริบท (AGENTS.md)

สิ่งเดียวที่ให้ผลตอบแทนสูงสุดที่คุณทำได้คือการเขียน ไฟล์บริบท ที่ AI อ่านโดยอัตโนมัติ เครื่องมือต่างกันมองหาชื่อไฟล์ต่างกัน — AGENTS.md, CLAUDE.md, .cursorrules หรือ .github/copilot-instructions.md — แต่แนวคิดเหมือนกันทุกประการ นั่นคือเอกสารที่มีชีวิตซึ่งบอก AI ว่าโปรเจกต์ ของคุณ ทำงานอย่างไร และคุณอยากให้มันประพฤติตัวอย่างไร

หากไม่มีไฟล์นี้ AI จะต้องเดา หากมี AI จะเลิกจัดรูปแบบโค้ดของคุณใหม่ เลิกคิดค้นไลบรารีที่คุณไม่ได้ใช้ และเลิกอธิบายซ้ำถึงการตัดสินใจที่คุณทำไปแล้ว ลองนึกภาพมันเป็นเอกสารปฐมนิเทศสำหรับเพื่อนร่วมทีมใหม่ที่ฉลาดล้ำแต่ความจำเสื่อมโดยสิ้นเชิงระหว่างแต่ละเซสชัน — ทุกสิ่งที่พวกเขาต้องรู้เพื่อทำงานได้ผลต้องอยู่ในที่ที่พวกเขาจะอ่านทุกครั้ง

ตัวอย่างไฟล์เริ่มต้นที่ใช้งานได้จริง

# Project: Invoice Manager

## What this is
A small web app for freelancers to create and track invoices.

## Tech stack
- TypeScript + React (Vite)
- Tailwind for styling
- SQLite via Prisma
- Vitest for tests

## Commands
- Install: `npm install`
- Run dev server: `npm run dev`
- Run tests: `npm test`
- Lint: `npm run lint`

## Conventions
- Use functional components and hooks; no class components.
- Keep components small; one component per file.
- Write a test for every new function in `src/lib`.
- Never edit files in `src/generated/` — they are auto-generated.

## Don'ts
- Don't add new dependencies without flagging it first.
- Don't commit secrets; use environment variables.

รักษาไฟล์ให้สั้นและทันสมัยอยู่เสมอ ไฟล์บริบทที่ยาวขึ้นจนถึงพันบรรทัดจะไม่ถูกอ่านอย่างละเอียดอีกต่อไป ไม่ว่าจะโดยคุณหรือโดยโมเดล ดังนั้นจงตัดทอนมันอย่างขะมักเขม้นพอ ๆ กับที่คุณเพิ่มเติมมันเข้าไป เมื่อ AI สันนิษฐานผิดซ้ำ ๆ เรื่องเดิม นั่นคือสัญญาณให้คุณเพิ่มบรรทัดหนึ่ง เมื่อกฎข้อหนึ่งไม่ตรงกับความเป็นจริงอีกต่อไป จงลบมันก่อนที่มันจะเริ่มชักนำเอเจนต์ให้เข้าใจผิดอย่างจริงจัง

มีรูปแบบไม่กี่อย่างที่แยกไฟล์บริบทที่ใช้งานได้ผลออกจากไฟล์ที่ถูกเมิน

• เจาะจงและเป็นรูปธรรม "ใช้ตามธรรมเนียมของเรา" นั้นไร้ประโยชน์ "ใช้ zod สำหรับการตรวจสอบข้อมูล เราไม่ใช้ yup" คือกฎที่ AI ทำตามได้จริง
• ระบุสิ่งที่ห้ามทำให้ชัดเจนพอ ๆ กับสิ่งที่ควรทำ โมเดลกระตือรือร้นที่จะช่วยเหลือ ซึ่งหมายความว่ามันจะเพิ่มดีเพนเดนซีหรือเขียนคอนฟิกใหม่อย่างเต็มใจ เว้นแต่คุณจะบอกไม่ให้ทำ
• ชี้ไปยังตัวอย่าง "ทำตามสไตล์ของ src/features/invoices" ให้โมเดลที่เป็นรูปธรรมให้ AI ลอกเลียนแทนที่จะเป็นคำสั่งกำกวมที่ต้องตีความเอง

จงปฏิบัติต่อไฟล์บริบทเหมือนบันทึกของบทเรียนทุกอย่างที่คุณไม่อยากพูดซ้ำ มันคือการลงทุนที่ถูกที่สุดและยั่งยืนที่สุดในทั้งบทนี้