The headline is about AGENTS.md being advisory and making it executable. Let me rewrite this to be punchy and specific.

Short summary

AGENTS.md files are advisory Markdown that agents can silently ignore. This article presents a system that makes AGENTS.md executable by requiring three properties: every claim carries an enforcement line with a live-firing gate, claims are tested against real rules, and the document body is generated from source-of-truth on every push. The approach inverts the normal doc-test relationship so documentation is downstream of tests, catching lies at pre-push time rather than weeks later.

• •AGENTS.md is advisory prose that agents can skip without any failure signal
• •Executable AGENTS.md requires enforcement lines, live-fired tests, and byte-gated generated regions
• •The getff repo demonstrates this with cargo-clippy and ESLint backends, including error codes for unenforceable rules

Generated with AI, which can make mistakes.