ก่อนแก้โปรเจกต์ ให้ Claude Code สรุปโครงสร้างและไฟล์สำคัญอย่างไร

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

เตรียมโปรเจกต์ก่อนเริ่มสำรวจ

① เปิด Claude Code จากโฟลเดอร์โปรเจกต์
เริ่ม Claude Code ในโฟลเดอร์ Repository ที่ต้องการให้ตรวจ เพื่อให้บริบทเริ่มต้นตรงกับงาน

② ตรวจสถานะ Git ก่อน
ใช้ git status --short ดูว่ามีไฟล์ที่แก้ค้างอยู่หรือไม่ วิธีนี้ช่วยแยกงานเดิมออกจากการเปลี่ยนแปลงที่จะทำภายหลัง

③ ระบุเป้าหมายการสำรวจ
ถ้าต้องการแก้ฟีเจอร์ใดในภายหลัง ให้บอกชื่อฟีเจอร์หรือปัญหานั้น เพื่อให้ Claude Code เน้นไฟล์ที่เกี่ยวข้อง ไม่ต้องสรุปทุกไฟล์ในโปรเจกต์

ควรให้ Claude Code สรุปเรื่องใดบ้าง

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

Prompt ให้สรุปโครงสร้างก่อนแก้ไข

ช่วยสำรวจโครงสร้าง Repository นี้ก่อนเริ่มแก้โค้ด

ตอนนี้ยังไม่ต้องแก้ไขหรือลบไฟล์ และอย่ารันคำสั่งที่เปลี่ยนแปลงโปรเจกต์

สรุปข้อมูลต่อไปนี้:
① โฟลเดอร์หลักและหน้าที่
② จุดเริ่มต้นของแอปหรือบริการ
③ ไฟล์ตั้งค่าและคำสั่งติดตั้ง รัน และทดสอบที่พบ
④ ไฟล์สำคัญที่เกี่ยวข้องกับ [ฟีเจอร์หรือปัญหาที่จะทำ]
⑤ เส้นทางการทำงานของฟีเจอร์ ตั้งแต่รับข้อมูลจนถึงแสดงผลหรือบันทึก
⑥ ข้อจำกัดหรือข้อมูลที่ยังยืนยันไม่ได้

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

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

จัดผลสำรวจให้พร้อมใช้ก่อนเริ่มแก้

หลังได้สรุปแล้ว ให้ตรวจไฟล์สำคัญที่ Claude Code อ้างถึง จากนั้นจดบันทึกคำสั่งรัน วิธีทดสอบ และส่วนที่ต้องระวังไว้ หากต้องการให้เครื่องมือใช้แนวทางโปรเจกต์อย่างต่อเนื่อง สามารถจัดทำไฟล์ CLAUDE.md สำหรับคำแนะนำของโปรเจกต์ โดยใส่ข้อมูลที่ตรวจสอบแล้ว เช่น รูปแบบโค้ดและคำสั่งทดสอบ

อย่าใส่ API Key รหัสผ่าน หรือข้อมูลลับไว้ในไฟล์คำแนะนำ และควรตรวจเนื้อหาก่อนบันทึกหรือ Commit ทุกครั้ง

สรุป

ก่อนแก้โปรเจกต์ ให้ Claude Code สรุปโฟลเดอร์ จุดเริ่มต้น ไฟล์ตั้งค่า และเส้นทางการทำงานของส่วนที่สนใจ โดยกำชับว่าอย่าแก้ไฟล์และให้อ้างอิงโค้ดจริง การตรวจผลสำรวจก่อนเริ่มงานช่วยสร้างภาพรวมที่ชัดขึ้น และทำให้กำหนดขอบเขตการแก้ไขได้แม่นยำกว่าเดิม