ปฏิบัติการ
บันทึกและจำกัดขอบเขตทางลัดทางเทคนิคที่ตั้งใจ
ทะเบียนที่มีขอบเขตซึ่งผูกการลดทอนแต่ละรายการกับเจ้าของ ตัวกระตุ้น การควบคุม การหมดอายุ และการตรวจสอบ แทนการซ่อนไว้เป็นงานเก็บกวาดทั่วไป
กระบวนการ
ทำตามลำดับนี้
- บันทึกทางลัด การตัดสินใจที่ทางลัดนั้นเปิดทางให้ วันที่ ขอบเขตระบบ ผู้ที่ยอมรับ และหลักฐานที่มีในเวลานั้น
- จัดหมวดหนี้เป็นความปลอดภัย ความเชื่อถือ การดูแลรักษา การปฏิบัติตาม ต้นทุน หรือแรงกดดันการส่งมอบ และอธิบายความล้มเหลวหรือต้นทุนที่เกิดขึ้นจริง
- กำหนดการควบคุม การตรวจสอบ วิธีแก้ขัดชั่วคราว ข้อจำกัดข้อมูลหรือบริการ และสัญญาณที่สังเกตได้ซึ่งจะทำให้ทางลัดไม่ปลอดภัย
- กำหนดเจ้าของงาน วันที่ทบทวน เงื่อนไขการถอน ความพึ่งพา และเส้นทางการยอมรับสำหรับความเสี่ยงที่ยังลดไม่ได้
- ตามรอยว่าทางลัดส่งผลต่อการเปลี่ยนแปลงในอนาคต การตอบสนองต่อเหตุการณ์ การเริ่มใช้งาน และการปฏิบัติตามอย่างไร แล้วจัดลำดับตามความเสี่ยงที่ใช้งานจริง ไม่ใช่ความเป็นระเบียบทั่วไป
- กำหนดการชำระหนี้ การเปลี่ยนทดแทน หรือการยอมรับอย่างชัดเจน และบันทึกการตัดสินใจกับหลักฐานโดยไม่เปลี่ยนข้อยกเว้นให้กลายเป็นข้อกำหนดอย่างเงียบ ๆ
- ทบทวนบัญชี ทำเครื่องหมายรายการที่ล่าช้าหรือสะสม แล้วส่งสถานะปัจจุบัน หลักฐาน ความเสี่ยงที่ยอมรับ และความเสี่ยงที่ยังไม่ได้แก้ไขกลับเจ้าของงาน
เตรียมสิ่งนี้
ข้อมูลที่แมวจะขอ
- คำอธิบายและเหตุผลของทางลัด
- บริการหรือคลังโค้ดที่ได้รับผลกระทบ
- เจ้าของความเสี่ยงและผู้มีอำนาจยอมรับ
- หลักฐานการตรวจสอบและการทบทวน
เราเตอร์ + playbook เดียว
จัดเส้นทางก่อน เลือกอันเดียว
Cat Paw โหลด playbook เดียวต่องาน ไม่ผสมหลายอัน เริ่มที่เราเตอร์นี้ เส้นทางที่เหลือเป็นตัวเลือกเฉพาะ workflow
- เราเตอร์:
minimal-code-pack skills/minimal-code-pack/technical-shortcut-debt-ledger/SKILL.md
เส้นเขต
ขอบเขตเดินทางไปกับพรอมต์
- ก่อนเริ่ม ให้ตรวจสอบเครื่องมือ บัญชี สิทธิ์ และพื้นที่ทำงานจริง ห้ามอ้างว่ามีเครื่องมือ บัญชี แหล่งข้อมูล หรือความสามารถที่ไม่พร้อมใช้งาน
- ใช้ Latch/target-workspace สำหรับโค้ดส่วนตัว ผลงาน การตรวจสอบสด หรือข้อมูลที่ไม่เป็นสาธารณะ หากไม่มีสิทธิ์เข้าถึง ให้หยุดที่ขอบเขตและรายงานสิ่งกีดขัด แทนการเดา
- หยุดเพื่อขออนุมัติอย่างชัดเจนก่อนการดำเนินการภายนอกที่มีผลกระทบ แล้วส่งกลับหลักฐาน ความเสี่ยงที่ยังไม่ได้แก้ไข สมมติฐาน และการดำเนินการใดที่ยังรอการอนุมัติ
เสร็จหมายถึง
จุดจบที่ตรวจได้
บัญชีให้ทุกทางลัดที่ตั้งใจมีความเสี่ยงอย่างมีขอบเขต มาตรการควบคุม เจ้าของงาน เงื่อนไขหมดอายุหรือการยอมรับ สัญญาณการตรวจสอบ และสถานะปัจจุบันที่มีหลักฐานรองรับ
แหล่งที่มา
กระบวนการนี้มาจากไหน
- github.com/DietrichGebert/ponytail/tree/e3ba2aa6f1e6f0bc4d69eb09c9f0d0a93af56156/
- martinfowler.com/bliki/TechnicalDebt.html
- sre.google/sre-book/release-engineering/
แหล่งที่มาตั้งรูปแบบของ workflow โพสต์ Reddit และชุมชน ถ้ามี ให้ถือเป็นเรื่องเล่าจากผู้ปฏิบัติ ไม่ใช่ข้อเท็จจริงสากล