<div class="key-takeaways"><ul><li>เอกสารข้อกำหนดในคลังโค้ดมักถูกละเลยหากไม่มีระบบตรวจสอบอัตโนมัติรองรับ</li><li>เครื่องมือตรวจสอบที่ดีควรเริ่มต้นจากข้อผิดพลาดที่เคยเกิดขึ้นจริง</li><li>ระบบอนุญาตให้ข้อยกเว้นได้ผ่านคอมเมนต์เฉพาะเพื่อป้องกันการหลบเลี่ยงแบบไร้ร่องรอย</li><li>Agents Playbook ประกอบด้วยชุดตรวจสอบ 13 รายการที่ทำงานแบบไม่มี Dependency</li></ul></div><p>ในอดีตผู้พัฒนาเคยเขียนไฟล์แนะนำอย่าง <code>AGENTS.md</code> ขึ้นมาเป็นผลิตภัณฑ์สำเร็จรูป เพื่ออธิบายสถาปัตยกรรม สั่งห้ามการใช้บางสิ่ง บังคับให้ใช้ Named Exports และบอกให้ AI coding agent คอยดูแลขนาดไฟล์ให้เล็กอยู่เสมอเมื่อมีการเปลี่ยนแปลงสัญญา แต่ปัญหาคือแม้เอกสารจะยอดเยี่ยมเพียงใด พูลรีเควสต์ถัดมาก็ยังคงละเมิดข้อกำหนดเหล่านั้นอยู่ดี</p><p>ความล้มเหลวนี้ไม่ได้เกิดจากตัว AI เสมอไป เพราะกฎที่มีอยู่เพียงแค่ตัวหนังสือย่อมคาดหวังให้ผู้มีส่วนร่วมทุกคนไม่ว่าจะเป็นมนุษย์หรือระบบอัตโนมัติ จดจำและปฏิบัติตามได้ในจังหวะที่ถูกต้องเสมอ ส่งผลให้กระบวนการรีวิวกลายเป็นด่านแรกที่พบว่ากฎถูกละเมิด ผู้พัฒนาจึงเปลี่ยนแนวคิดใหม่โดยใช้เอกสารคำอธิบายควบคู่ไปกับระบบกลไกตรวจสอบอัตโนมัติที่เป็นรูปธรรม</p><div class="mb-20"><img class="img-bdrd-16" src="https://api.inewgen.co/uploads/coding_agent_ci_ms4woqho_inline_1_94661ccc67.jpg" alt="code editor configuration file" loading="lazy" /><p class="color-gray-500 text-sm mt-10">ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง</p></div><p>การตอบสนองที่ง่ายที่สุดคือการทำให้ทุกอย่างเป็นอัตโนมัติ แต่แนวทางดังกล่าวกลับสร้างปัญหาใหม่คือกองทัพการตรวจสอบที่ส่งเสียงแจ้งเตือนจนน่ารำคาญ ซึ่งไม่มีใครเข้าใจและทุกคนพยายามหาวิธีหลบเลี่ยง ดังนั้นแนวทางใหม่จึงเริ่มต้นจากความผิดพลาดที่เคยเกิดขึ้นจริงแล้ว เช่น เมื่อเอเจนต์พยายามใช้ชนิดข้อมูล <code>any</code> เพื่อเร่งให้โค้ด TypeScript ผ่านไปได้อย่างรวดเร็ว ในขณะที่กฎของคลังโค้ดกำหนดให้ใช้ <code>unknown</code> พร้อมทำการตรวจสอบชนิดและข้อมูลภายนอกขณะรันไทม์ แม้ผู้ตรวจสอบจะพบและให้แก้ไข แต่ข้อผิดพลาดเดิมก็ยังกลับมาอีกในสองพูลรีเควสต์ถัดมา</p><div class="ai-insight"><p>การเปลี่ยนผ่านจากการพึ่งพากฎที่เป็นตัวอักษรมาสู่การใช้เครื่องมือตรวจสอบอัตโนมัติ (Automated Gates) ถือเป็นหัวใจสำคัญในการพัฒนาซอฟต์แวร์ยุคที่ AI มีบทบาทสูง เนื่องจากมนุษย์มีข้อจำกัดด้านความใส่ใจในรายละเอียดปลีกย่อย การผูกกฎระเบียบเข้ากับระบบ CI จึงช่วยลดภาระทางความคิดและป้องกันข้อผิดพลาดที่มักเกิดขึ้นซ้ำๆ ได้อย่างมีประสิทธิภาพ</p></div><p>ผู้พัฒนาได้เผยแพร่ชุดคำสั่งตรวจสอบที่สามารถรันได้ทันทีจาก Agents Playbook ในรูปแบบ CLI แบบไม่มี Dependency เพื่อให้ผู้ใช้งานสามารถทดสอบระบบตรวจสอบเฉพาะส่วนได้ทันที ตัวอย่างเช่นเมื่อทดสอบกฎห้ามใช้ <code>any</code> ผ่านคำสั่ง:</p><p><code>npx --yes @agentskit/playbook@0.1.0 run no-any --cwd /tmp/playbook-gate-demo</code></p><p>ระบบจะทำการตรวจสอบและชี้จุดที่เกิดข้อผิดพลาดได้อย่างแม่นยำ พร้อมทั้งรองรับการระบุข้อยกเว้นแบบเฉพาะเจาะจงผ่านคอมเมนต์ เช่น <code>// allow-any: upstream SDK has no types</code> ซึ่งช่วยให้การตัดสินใจมีความโปร่งใสและสามารถนับจำนวนข้อยกเว้นได้โดยที่ตัวเลขไม่เพิ่มขึ้นอย่างไร้การควบคุม</p><div class="mb-20"><img class="img-bdrd-16" src="https://api.inewgen.co/uploads/coding_agent_ci_ms4woqho_inline_2_f5f1701461.jpg" alt="terminal command line interface" loading="lazy" /><p class="color-gray-500 text-sm mt-10">ภาพประกอบจากคลังภาพสต็อก ไม่ใช่ภาพจากเหตุการณ์จริง</p></div><p>ปัจจุบัน Agents Playbook มีชุดตรวจสอบอ้างอิงที่ทำงานแบบไม่มี Dependency ทั้งหมด 13 รายการ ครอบคลุมประเด็นสำคัญ เช่น ข้อมูลลับ ขนาดไฟล์ Named exports ข้อกำหนด ADR หรือ RFC การแปลภาษา โทนสีการออกแบบ HTML ดั้งเดิม และเจตนาของพูลรีเควสต์ เพื่อให้การควบคุมดูแลเชื่อมโยงกับหลักฐานที่ตรวจสอบได้จริง</p><p class="source-attribution">ที่มา: <img src="https://www.google.com/s2/favicons?domain=dev.to&sz=64" alt="Dev.to" class="source-logo" width="16" height="16" /> <a href="https://dev.to/agentskit/i-stopped-writing-rules-for-coding-agents-that-ci-could-not-enforce-5hn9" target="_blank" rel="noopener noreferrer">Dev.to</a></p>

<div class="key-takeaways"><ul><li>Repository instruction documents are often ignored without automated enforcement mechanisms.</li><li>Effective automated gates should always originate from real failures that already happened.</li><li>Explicit inline comments allow tracked exceptions without invisible bypasses.</li><li>Agents Playbook features 13 zero-dependency reference gates covering common repository governance needs.</li></ul></div><p>The author previously treated repository instructions in files like <code>AGENTS.md</code> as the finished product, explaining the architecture, banning certain patterns, requiring named exports, and instructing coding agents to keep files small. However, despite an excellent document, the very next pull request could still violate those exact rules.</p><p>This failure is not always the agent's fault, as a rule existing only as prose requires every contributor to remember it at precisely the right moment. Review becomes the first place the repository discovers the rule was ignored, prompting a shift toward treating instructions as explanations and gates as enforcement.</p><div class="mb-20"><img class="img-bdrd-16" src="https://api.inewgen.co/uploads/coding_agent_ci_ms4woqho_inline_1_94661ccc67.jpg" alt="code editor configuration file" loading="lazy" /><p class="color-gray-500 text-sm mt-10">Stock photo for illustration only, not from the actual event</p></div><p>The tempting response of automating everything creates a wall of noisy checks that nobody understands and everyone learns to bypass. Instead, the new approach starts with a failure that has already happened, such as an agent using <code>any</code> to quickly push a TypeScript change through, violating the repository rule requiring <code>unknown</code> and runtime input validation.</p><div class="ai-insight"><p>Transitioning from prose rules to automated checks represents a crucial evolution in software engineering alongside AI coding assistants. Because human review bandwidth is limited, binding policies directly to CI pipelines eliminates cognitive fatigue and stops repetitive mistakes before they reach human reviewers.</p></div><p>The developer published the executable gates from Agents Playbook as a zero-dependency CLI. For instance, testing the <code>no-any</code> rule locally using:</p><p><code>npx --yes @agentskit/playbook@0.1.0 run no-any --cwd /tmp/playbook-gate-demo</code></p><p>allows the command to exit non-zero and point directly to the violation. Furthermore, the reference gate accepts explicit same-line exceptions such as <code>// allow-any: upstream SDK has no types</code>, making the decision visible and allowing repositories to maintain a baseline count of escape hatches.</p><div class="mb-20"><img class="img-bdrd-16" src="https://api.inewgen.co/uploads/coding_agent_ci_ms4woqho_inline_2_f5f1701461.jpg" alt="terminal command line interface" loading="lazy" /><p class="color-gray-500 text-sm mt-10">Stock photo for illustration only, not from the actual event</p></div><p>The Playbook currently includes 13 zero-dependency reference gates covering concerns such as secrets, file size, named exports, ADR requirements, internationalization, design tokens, native HTML, and PR intent, keeping governance closely attached to verifiable evidence.</p><p class="source-attribution">Source: <img src="https://www.google.com/s2/favicons?domain=dev.to&sz=64" alt="Dev.to" class="source-logo" width="16" height="16" /> <a href="https://dev.to/agentskit/i-stopped-writing-rules-for-coding-agents-that-ci-could-not-enforce-5hn9" target="_blank" rel="noopener noreferrer">Dev.to</a></p>

medium_coding-agent-ci-ms4woqho.jpg

small_coding-agent-ci-ms4woqho.jpg

thumbnail_coding-agent-ci-ms4woqho.jpg

Inewgen

Inewgen

#Agents Playbook

I Stopped Writing Rules for Coding Agents That CI Could Not Enforce

Inewgen