ข้อกำหนด DWP

เวอร์ชัน 1.0 สถานะ: เสถียร เอกสารนี้คือข้อกำหนดเชิงบรรทัดฐานสำหรับระเบียบวิธี Deep Work Plan (DWP) คำสำคัญ MUST, MUST NOT, SHOULD, SHOULD NOT และ MAY ให้ตีความตามที่อธิบายไว้ใน RFC 2119

นิยาม

Deep Work Plan คือสิ่งประดิษฐ์แบบ markdown ล้วนที่มีโครงสร้าง ซึ่งอธิบายงานวิศวกรรมที่ซับซ้อนโดยแยกย่อยเป็นหน่วยงานตามลำดับและทบทวนได้ ออกแบบมาเพื่อให้เอเจนต์เขียนโค้ด AI ที่ทำงานอย่างอิสระสร้าง ดำเนินการ และดูแลรักษา

DWP ขับเคลื่อนด้วยข้อกำหนด แผนคือข้อกำหนด และเอเจนต์ MUST ดำเนินการเทียบกับเกณฑ์การยอมรับและ validation gate ที่ชัดเจนของมันแทนที่จะด้นสด ข้อกำหนด — ไม่ใช่บทสนทนาแชต — คือแหล่งความจริงที่ยั่งยืน งานจึงตรวจสอบได้และดำเนินต่อได้ข้ามเซสชันและข้ามเอเจนต์ มันยังเป็น harness engineering ที่ทำให้พกพาได้ บริบท control loop guardrail และสถานะที่ดำเนินต่อได้ซึ่งทำให้เอเจนต์เชื่อถือได้ถูกติดตั้งลงใน repository เองในรูปของ markdown ธรรมดา เอเจนต์ที่สอดคล้องตัวใดก็ MAY ขับเคลื่อน repository ได้โดยไม่ต้องมีเฟรมเวิร์กเฉพาะเครื่องมือ

โครงสร้างแผน

แผน MUST เป็นไดเรกทอรีภายใต้ .dwp/plans/ ที่ตั้งชื่อว่า PLAN_<slug>/ ไดเรกทอรีนั้น MUST ประกอบด้วย

• README.md — ภาพรวมแผน เป้าหมาย ตารางงาน และสถานะ
• หนึ่งไฟล์ต่อหนึ่งงาน ตั้งชื่อว่า <n>.task_<slug>.md
• PROGRESS.md — log การทำงานที่บันทึกต่อเนื่อง

โครงสร้างงาน

ไฟล์งาน

1. 01 เป้าหมาย
2. 02 บริบท
3. 03 ขั้นตอน
4. 04 เกณฑ์การยอมรับ
5. 05 การตรวจสอบ
6. 06 ไฟล์
7. 07 การพึ่งพา
8. 08 ความเสี่ยง
9. 09 การเสร็จสิ้นและบันทึก

ไฟล์งานแต่ละไฟล์ MUST มีเก้าส่วนนี้ตามลำดับ

1. เป้าหมาย — คำบอกกล่าวหนึ่งย่อหน้าว่างานนี้บรรลุอะไร
2. บริบท — ภูมิหลัง ลิงก์ และเหตุผลที่งานนี้มีอยู่
3. ขั้นตอน — การกระทำที่เป็นรูปธรรมและเรียงลำดับซึ่งต้องทำ
4. เกณฑ์การยอมรับ — เช็กลิสต์ของเงื่อนไขที่นิยามว่าเสร็จ
5. การตรวจสอบ — คำสั่งหรือการทดสอบที่ต้องรันเพื่อยืนยัน
6. ไฟล์ — พาธที่คาดว่าจะถูกสร้างหรือแก้ไข
7. ส่วนพึ่งพิง — งานอื่นหรือเงื่อนไขเบื้องต้นภายนอก
8. ความเสี่ยง — สิ่งที่อาจผิดพลาดและการบรรเทา
9. การเสร็จสิ้นและ Log — เครื่องหมายสถานะพร้อมบันทึกตามลำดับเวลา

ลูปดำเนินงาน

DWP นิยามห้าปฏิบัติการ

• create — สร้างแผนใหม่จากเป้าหมาย
• execute — ดำเนินแผนทีละงาน
• refine — แก้ไขแผนที่มีอยู่
• resume — ดำเนินแผนที่ถูกขัดจังหวะต่อ
• status — รายงานสถานะแผนโดยไม่ดำเนินการ

พื้นที่ทำงานผลลัพธ์

พื้นที่ทำงานเอาต์พุต

• .dwp/ git ละเว้น · ทิ้งได้
• drafts/ การจัดเตรียมร่างที่ขัดเกลาแล้ว
• plans/
• PLAN_<name>/
• README.md
• PROGRESS.md
• <n>.task_<slug>.md
• analysis_results/ รายงาน
• EXECUTIVE_REPORT.md รายงานผู้บริหาร

สิ่งประดิษฐ์ทั้งหมดของ DWP MUST อยู่ภายใต้ไดเรกทอรี .dwp/ ที่ถูก gitignore ที่รากของ repository

การกำหนดเวอร์ชัน

ข้อกำหนดนี้ใช้การกำหนดเวอร์ชันเชิงความหมาย