เทมเพลตแผนและงาน

Deep Work Plan คือไดเรกทอรีของไฟล์ markdown รูปร่างของไดเรกทอรีนั้น — และของแต่ละไฟล์ภายใน — คือสิ่งที่ทำให้แผนทบทวนได้โดยทั้งมนุษย์และเอเจนต์

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

ไดเรกทอรีของแผน

.dwp/
plans/
PLAN_<slug>/
README.md เป้าหมาย · ตารางงาน · สถานะ
PROGRESS.md บันทึกการดำเนินงานแบบต่อท้ายเท่านั้น
1.task_<slug>.md ไฟล์งาน (สิบหัวข้อ)
2.task_<slug>.md

แผน DWP คือไดเรกทอรีของไฟล์ Markdown ประกอบด้วย README ที่สรุปภาพรวม บันทึก PROGRESS ที่ต่อท้ายได้อย่างเดียว และไฟล์หนึ่งไฟล์ต่อหนึ่งงาน

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

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

โครงสร้างไฟล์งาน

ไฟล์งานแต่ละไฟล์ตั้งชื่อว่า <n>.task_<slug>.md และเป็นไปตามโครงสร้างสิบส่วน ได้แก่ เป้าหมาย บริบท พื้นผิวที่แตะต้อง ขั้นตอน เกณฑ์การยอมรับ การตรวจสอบ ไฟล์ ส่วนพึ่งพิง ความเสี่ยง และการเสร็จสิ้นและ Log ส่วนต่าง ๆ ปรากฏตามลำดับนั้นเสมอ เพื่อให้ผู้อ่านทุกคนรู้ว่าควรมองหาที่ใด แต่ละงานยึดโยงกลับไปยังเป้าหมายของแผนก่อนลงมือ ซึ่งช่วยกันไม่ให้เอเจนต์เบี่ยงเบนไปตลอดช่วงเวลายาวนานหลายชั่วโมง

Final Review

ทุกแผนต้องจบด้วยงานบังคับเพียงหนึ่งเดียวพอดี นั่นคือ Final Review มันปิดแผนด้วยการตรวจสามรอบตามลำดับ — ไม่มีสิ่งใดในการตรวจความปลอดภัยถูกผ่อนปรน

การตรวจความปลอดภัย — ตรวจสอบทุกสิ่งที่แผนเปลี่ยนแปลงเพื่อหาความลับ ความเสี่ยงจาก injection และพื้นผิวการโจมตีใหม่ และคง docs/SECURITY.md ให้เป็นปัจจุบัน ความปลอดภัยไม่ใช่สายงานแยกที่ถูกแปะเพิ่มตอนท้าย ทุกแผนทิ้งการเปลี่ยนแปลงของตัวเองไว้ในสภาพที่ผ่านการตรวจสอบแล้ว และสิ่งที่พบในระดับวิกฤตจะปิดกั้นการเสร็จสิ้น
การตรวจสอบครบวงจรบนสถานะสุดท้าย — การตรวจสอบครบวงจรของ repository รันและผ่านบนสถานะที่เกี่ยวข้องสุดท้าย หลังการแก้ไขครั้งสุดท้าย
การกระทบยอดเรื่อง skill — ทุกงานได้บันทึกการจัดการเรื่อง skill ของตัวเองไว้แล้วขณะที่หลักฐานยังใหม่ การทบทวนนี้กระทบยอดบัญชีนั้น รายงานสรุปสำหรับผู้บริหารยังคงเรียกใช้ได้เมื่อร้องขอ

ข้อตกลงของ README และ PROGRESS

README.md ของแผนต้องมีชื่อเรื่อง (# Deep Work Plan: <name>) คำบอกกล่าวเป้าหมายแบบร้อยแก้ว ส่วนวัสดุต้นทางที่เป็นทางเลือก ตารางงาน (หมายเลข ชื่องาน ช่องทำเครื่องหมายสถานะ) และบรรทัดสถานะแผนในรูปแบบ <n>/<total> tasks complete

PROGRESS.md คือ log การทำงานแบบเพิ่มได้อย่างเดียว แต่ละรายการบันทึก timestamp แบบ ISO 8601 หมายเลขและชื่องาน สิ่งที่ทำไป และการเบี่ยงเบนหรือเหตุผลในการข้ามใด ๆ เพราะมันมีแต่จะเติบโตขึ้นเรื่อย ๆ มันจึงเป็นประวัติที่เชื่อถือได้ว่าแผนคลี่คลายไปอย่างไรจริง ๆ

หัวข้อและการอ้างอิงข้าม

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