ความสอดคล้อง

เวอร์ชัน 1.0 สถานะ: เสถียร เอกสารนี้นิยามว่าการที่ repository สอดคล้องกับ Deep Work Plan หมายถึงอะไร — นั่นคือ เป็น AI-first และเอเจนต์ขับเคลื่อนได้ คำสำคัญ MUST, MUST NOT, SHOULD, SHOULD NOT และ MAY ให้ตีความตามที่อธิบายไว้ใน RFC 2119

ความสอดคล้องมีอยู่เพื่อให้ “AI-first” เป็นคุณสมบัติที่เป็นวัตถุวิสัยและตรวจสอบได้ แทนที่จะเป็นความรู้สึก repository หนึ่งเป็นไปตามเกณฑ์ด้านล่างหรือไม่ก็ตาม sub-skill verify (/dwp-verify) ตรวจสอบเกณฑ์เหล่านี้โดยอัตโนมัติ

repository ที่สอดคล้อง

repository ที่สอดคล้องกับ DWP MUST เป็นไปตามทุกข้อต่อไปนี้ สิ่งประดิษฐ์ทุกอย่าง MUST ผ่านการให้เหตุผลสำหรับ repository — ปรับให้เข้ากับภาษา เฟรมเวิร์ก และคำสั่งจริงของมัน สตับทั่วไป เพลซโฮลเดอร์ หรือเนื้อหาที่คัดลอกมาจาก repository อื่นไม่เป็นไปตามเกณฑ์

1. AGENTS.md ที่ราก repository MUST มี AGENTS.md ที่รากซึ่งประกอบด้วย (ก) ดัชนีของเอกสาร (ข) กฎที่บังคับสำหรับ repository และ (ค) บล็อก Quick Commands ที่คำสั่ง มีอยู่จริงและรันได้ ใน repository นี้ คำสั่งเพลซโฮลเดอร์ (เช่น npm test ใน repository ที่ไม่ใช้ npm) MUST NOT ปรากฏ
2. CLAUDE.md แปลงไปยัง AGENTS.md CLAUDE.md MUST มีอยู่และแปลงไปยัง AGENTS.md (symlink หรือสิ่งเทียบเท่าที่รับประกันแหล่งความจริงเดียว) ทั้งสอง MUST NOT แตกต่างกัน
3. ลำดับชั้น docs/ repository MUST มีไดเรกทอรี docs/ ที่ครอบคลุมหมวดมาตรฐาน (สถาปัตยกรรม มาตรฐาน การทดสอบ คำสั่งสำหรับการพัฒนา ความปลอดภัย และการออนบอร์ดเอเจนต์) ด้วยเนื้อหาจริงที่เฉพาะกับ repository โมดูลที่ซับซ้อน SHOULD มี README.md ของตัวเอง
4. บ้าน .agents/ repository MUST มีไดเรกทอรี .agents/ พร้อม agents/, commands/ และ skills/ รวมถึงแคตตาล็อกภายใต้ .agents/docs/ ที่ ตรงกับสิ่งที่อยู่บนดิสก์ คำสั่ง dwp-* MUST เป็นตัวส่งต่อบาง ๆ ไปยัง skill ที่ติดตั้งไว้ พาธ .claude MUST แปลงไปยัง .agents
5. พื้นที่ทำงาน .dwp/ ที่ถูก gitignore repository MUST มีไดเรกทอรี .dwp/ พร้อม plans/ และ drafts/ และ .dwp/ MUST ถูก gitignore พื้นที่ scratch tmp/ SHOULD มีอยู่และ SHOULD ถูก gitignore
6. skill ของระเบียบวิธีแปลงได้ skill ของ Deep Work Plan MUST ถูกติดตั้งหรืออ้างอิงในลักษณะที่เอเจนต์ใน repository สามารถเรียกใช้ sub-skill ของมันได้

repository สอดคล้องอย่างสมบูรณ์โดยไม่มีส่วนเสริมใด ๆ ส่วนเสริม (devcontainer, Dailybot, dependency-upgrade) เป็นแบบเลือกเข้าร่วมและ MUST NOT จำเป็นต่อความสอดคล้อง

แผนที่มีรูปแบบที่ถูกต้อง

Deep Work Plan ใน .dwp/plans/ มีรูปแบบที่ถูกต้องเมื่อ

1. ทุกงาน MUST ประกาศ ขอบเขต, เกณฑ์การยอมรับ และ validation gate อย่างน้อยหนึ่งอย่าง (คำสั่งหรือการตรวจสอบที่ผ่านหรือไม่ผ่านอย่างเป็นวัตถุวิสัย) ที่ชัดเจน
2. แผน MUST บันทึกความคืบหน้าเพื่อให้งานรอดพ้นการขัดจังหวะและดำเนินต่อได้โดยเอเจนต์ตัวอื่น
3. แผน MUST รวมสองงานสุดท้ายที่บังคับ — การค้นพบ Skills และ Agents และรายงานสรุปสำหรับผู้บริหาร
4. งาน SHOULD ยึดโยงกลับไปยังเป้าหมายของแผนก่อนดำเนินการ เพื่อป้องกันการเบี่ยงเบนตลอดช่วงเวลายาวนาน

การตรวจสอบความสอดคล้อง

ความสอดคล้อง SHOULD ถูกตรวจสอบโดยอัตโนมัติแทนที่จะตรวจด้วยสายตา การรัน /dwp-verify ให้รายงานผ่าน/ไม่ผ่านเทียบกับเกณฑ์ด้านบน ได้แก่ การมีอยู่และเนื้อหาจริงของ AGENTS.md การแปลงของ CLAUDE.md หมวด docs/ การตรงกันของแคตตาล็อก .agents/ เทียบกับดิสก์ สถานะ gitignore ของ .dwp/ และ tmp/ และ — สำหรับแผน — ว่าทุกงานมีเกณฑ์การยอมรับและ validation gate

repository SHOULD ถูกตรวจสอบซ้ำหลังการออนบอร์ดและหลังแผนแต่ละแผนที่เสร็จสิ้น เพื่อให้ความสอดคล้องได้รับการดูแลรักษาแทนที่จะถูกยืนยันเพียงครั้งเดียว