แผน Lite
เวอร์ชัน 5.0.0. สถานะ: เสถียร เอกสารนี้ระบุรูปแบบแผน Lite ที่เปิดตัวควบคู่กับ ข้อกำหนด DWP: รูปแบบแผนสำหรับงานขนาดเล็กถึงขนาดกลางที่มีขอบเขตชัดเจน ซึ่งถูกทำให้เป็นรูปธรรมโดยตรง โดยไม่มีขั้นตอนร่างที่ดำเนินการไม่ได้ คำสำคัญ MUST, MUST NOT, SHOULD, SHOULD NOT และ MAY ให้ตีความตามที่อธิบายไว้ใน RFC 2119
รูปแบบและวงจรชีวิต
แผน MUST เป็นหนึ่งในสองรูปแบบ ซึ่งถูกบันทึกไว้ครั้งเดียวใน manifest.json เป็น plan_format: Full เก็บหนึ่งไฟล์ต่อหนึ่งงานภายใต้ <n>.task_<slug>.md; Lite เก็บบันทึกงานที่กระชับและดำเนินการได้แบบ inline ใน README.md แต่ละรายการอยู่หลัง anchor ที่เสถียรอย่าง {#task-N} แผน Lite ไม่ใช่แผน Full แบบบางส่วนหรือแบบไม่เป็นทางการ: บันทึกงานทุกรายการยังคง MUST พกเป้าหมาย พื้นผิวที่แตะต้อง เกณฑ์การยอมรับ validation gate และ log การเสร็จสิ้น ในโครงสร้างเชิงบรรทัดฐานแบบเดียวกับที่ โครงสร้างงาน นิยามไว้สำหรับ Full
สี่แกนที่อธิบายสถานะของแผน และ MUST ถูกติดตามอย่างเป็นอิสระ ไม่ปะปนกัน:
| แกน | ค่า | ความหมาย |
|---|---|---|
| รูปแบบ | lite, full |
บันทึกงานอยู่ที่ไหน |
| การทำให้เป็นรูปธรรม | materializing, ready, promoting |
โฟลเดอร์แผนกำลังถูกเขียน เสร็จสมบูรณ์แล้ว หรืออยู่ระหว่างการเลื่อนขั้น |
| การอนุมัติ | pending, approved, pre_approved |
มีมนุษย์ทบทวนแผนแล้วหรือไม่ หรือโหมด trust อนุมัติล่วงหน้าให้แล้ว |
| การดำเนินการ | pending, in_progress, blocked, completed |
ความคืบหน้าต่อหนึ่งงานและโดยรวม |
create แบบมีการแนะนำเขียนข้อเสนอที่รอการอนุมัติซึ่งทบทวนได้ — ไม่ว่าจะเป็น Lite หรือ Full ก็ตาม มันคือแผนจริงอยู่แล้ว ไม่ใช่ร่างที่ทิ้งได้ trust ทำให้แผนที่พร้อมแล้วและได้รับอนุมัติล่วงหน้าเป็นรูปธรรมโดยตรง แล้วคืนการควบคุมทันที create และการเลื่อนขั้นไม่เคยดำเนินงานจริงของผลิตภัณฑ์ คำขอ execute หรือ resume ที่ชัดเจนอนุมัติขอบเขตปัจจุบันที่พร้อมแล้วของแผน และ MUST บันทึกการอนุมัตินั้นก่อนเริ่มงาน หากไม่มีคำขอนั้น ข้อเสนอ pending จะไม่สามารถดำเนินการได้ และการเลื่อนขั้นที่ยังค้างอยู่ MUST ถูกกู้คืนก่อนงานของผลิตภัณฑ์
การสร้างและการเลือกรูปแบบ
/dwp-create รองรับความตั้งใจในการวางแผนทุกขนาด ไม่ใช่แค่งานขนาดใหญ่ งานขนาดเล็กที่มีขอบเขตชัดเจน — ความกังวลเดียว ประมาณหนึ่งรอบการทำงาน ไม่ต้องประสานงาน — คือเป้าหมายของแผน Lite ส่วนงานหลายขั้นตอนที่มีขอบเขตจริงจะใช้ Full เป็นค่าเริ่มต้น ตาม ความเข้มงวดตามสัดส่วน การแก้ไขโดยตรง คำอธิบาย การตรวจสถานะ การ resume หรือคำขอที่ระบุชัดว่าไม่ต้องการแผน ต่างคงเส้นทางของตนเองไว้ และไม่กลายเป็นแผนเลย
lite และ full คือความชอบด้านรูปแบบ; trust และ auto คือตัวเลือกการโต้ตอบที่แยกต่างหาก และตัวเลือกทั้งสองประเภทนี้ MAY ปรากฏที่ปลายด้านใดของคำขอก็ได้ ในลำดับใดก็ได้:
/dwp-create trust fix the label
/dwp-create lite trust fix the label
/dwp-create fix the label trust lite
/dwp-create fix the migration full trustการระบุตัวเลือกเดิมซ้ำเป็น idempotent; การขอ lite และ full พร้อมกันเป็นข้อผิดพลาด -- จบการแยกวิเคราะห์ตัวเลือก
เมื่อไม่มีการระบุความชอบด้านรูปแบบ create จะแนะนำหนึ่งอย่างพร้อมอธิบายเหตุผล คำขอ Full อย่างชัดเจนชนะเสมอ คำขอ Lite อย่างชัดเจนจะได้รับการยอมรับ เว้นแต่ความต้องการหรือ validation gate ของงานนั้นจะไม่พอดีกับบันทึกแบบ inline ที่กระชับ — ในกรณีนั้น create จะบันทึกไว้ว่าทำไมจึงต้องใช้ Full แทน การเลือกนี้ MUST บันทึกขอบเขตที่สังเกตได้ ส่วนพึ่งพิง รายละเอียดคำสั่งที่จำเป็น และสิ่งที่ยังไม่ทราบซึ่งอยู่เบื้องหลังการตัดสินใจนั้นไว้ — เป็นการตัดสินใจที่ตรวจสอบได้ ไม่ใช่การรับประกันที่ใช้ได้กับทุกโมเดลหรือทุกเอเจนต์
แผน Lite พกการตัดสินใจเรื่องการขนาน (parallelization) แบบเดียวกับที่ Full ทำ: บรรทัด Execution: sequential — {rationale} หรือส่วน Team Agents Configuration โดยมี Team Agents Metadata ต่อหนึ่งงานแนบตรงเข้ากับบันทึกงานที่ยึดโยงไว้ (anchored) แทนที่จะเป็นไฟล์งานแยกต่างหาก การตัดสินใจนี้ไม่เคยเงียบใน Lite เช่นกัน — แผน Lite ระบุมันไว้เหมือนกับที่แผน Full จะทำทุกประการ
การเลื่อนขั้นและความเข้ากันได้
แผน Lite MAY ถูกเลื่อนขั้นเป็น Full ได้ทุกเมื่อ ผ่าน /dwp-refine promote {plan_name} (ดู dwp-refine) การเลื่อนขั้นเกี่ยวข้องกับรูปแบบเท่านั้น: มันบันทึกความตั้งใจ เขียนไฟล์งานปลายทาง ตรวจสอบว่าทุกความต้องการและ gate ที่บันทึก Lite เคยพกไว้ยังคงถูกครอบคลุม สลับสำเนาที่เป็นทางการจากบันทึก README แบบ inline ไปเป็นไฟล์งาน แล้วจึงล้างเครื่องหมายที่กำลังดำเนินอยู่ execute และ resume MUST ปฏิเสธที่จะดำเนินต่อในขณะที่เครื่องหมายการเลื่อนขั้นยังคงถูกตั้งไว้ หมายเลขงานและหลักฐานการเสร็จสิ้นที่บันทึกไว้แล้ว MUST NOT ถูกเขียนทับโดยการเลื่อนขั้น ขอบเขตใหม่ที่ค้นพบระหว่างการเลื่อนขั้นจะผ่าน refine แทน และทำให้เฉพาะหลักฐานที่ได้รับผลกระทบเป็นโมฆะเท่านั้น
การเลื่อนขั้นไม่เคยทำงานย้อนกลับโดยอัตโนมัติ: แผน Full จะไม่ถูกยุบกลับเป็น Lite อย่างเงียบ ๆ แผนที่เขียนขึ้นภายใต้เวอร์ชัน spec ก่อนหน้า — รวมถึงแผน Full แบบ v1 ที่ไม่มีฟิลด์ plan_format เลย — จะคงรูปแบบที่บันทึกไว้และยังคงสอดคล้อง เซสชัน refine MAY ย้ายมันอย่างตั้งใจ แต่ไม่มีสิ่งใดทำเช่นนั้นโดยปริยาย
plan_format ของ manifest.json ไม่เปลี่ยนแปลงได้เมื่อเขียนแล้ว การเลื่อนขั้นจะเปลี่ยน format ของ state.json และล้างเครื่องหมาย promotion ของมัน และไม่เคยเขียนทับ manifest ดูฟิลด์ plan_format, format, materialization, approval, promotion และ locator ที่แน่ชัด รวมถึง URL schema เวอร์ชัน v2 ของทั้งหมด ได้ที่ สถานะแผน