จัดโครงสร้างโปรเจกต์ของคุณให้ AI สำรวจได้

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

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

ผังโครงสร้างทั่วไปที่เป็นมิตรกับ AI อาจมีลักษณะดังนี้

my-app/
├── AGENTS.md            # project rules & context for the AI
├── README.md            # what the project is, how to run it
├── .env.example         # documents needed secrets (no real values)
├── .gitignore           # excludes .env, build output, node_modules
├── package.json         # scripts: dev, test, lint, build
├── src/
│   ├── features/
│   │   └── invoices/    # code + tests for one feature, together
│   ├── lib/             # shared helpers
│   └── index.ts         # entry point
└── tests/               # cross-cutting / integration tests

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