From 07b92d854257a4c4ba127842bc75684f89d48c99 Mon Sep 17 00:00:00 2001
From: Markus Neusinger <2921697+MarkusNeusinger@users.noreply.github.com>
Date: Sat, 25 Jul 2026 23:59:31 +0200
Subject: [PATCH 1/2] fix(ci): keep ruff off Markdown so a minor bump stops
 breaking lint

ruff is pinned as >=0.15.21 with no upper bound; CI resolved 0.16.0,
which formats Python code blocks inside Markdown. Twenty tracked .md
files went unformatted overnight and every PR's Lint job turned red.

Excluding *.md is the fix rather than reformatting those files: nine of
them are prompts/library/*.md, whose code snippets steer generation, so
a quote-style rewrite there changes pipeline behaviour under the guise
of formatting.
---
 CHANGELOG.md   | 8 ++++++++
 pyproject.toml | 6 ++++++
 2 files changed, 14 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1177c6b133..e652ccad05 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -129,6 +129,14 @@ aggregate instead: an italic *Catalog* line at the end of the version section an
 
 ### Fixed
 
+- **CI lint went red on every PR after a ruff minor bump** — `pyproject.toml` pins
+  `ruff>=0.15.21` without an upper bound, CI resolved **0.16.0**, and that version started
+  formatting Python code blocks inside Markdown: 20 tracked `.md` files suddenly "would be
+  reformatted", none of them touched by the PR that hit it. Ruff's exclude list now carries
+  `*.md`. Deliberately not fixed by reformatting those files — nine of them are
+  `prompts/library/*.md`, whose snippets steer code generation, so rewriting quote style there
+  is a pipeline change wearing a formatting costume. Verified against both 0.15.21 and 0.16.0
+  (`format --check` + `check` clean on 148 files).
 - **A GitHub API brown-out could strand implementation PRs permanently — the hand-off calls
   are now retried** — on 2026-07-24 (~16:05–16:26 UTC) GitHub returned HTTP 502 on the
   workflow-dispatch endpoint and HTTP 504 on GraphQL, and four `radar-basic` PRs fell out of
diff --git a/pyproject.toml b/pyproject.toml
index ddf7ec08ae..0d6e725717 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -127,6 +127,12 @@ exclude = [
     "temp",
     "plots",
     "scripts",
+    # ruff 0.16 formats Python code blocks inside Markdown. Twenty tracked .md
+    # files change under it — including prompts/library/*.md, whose snippets
+    # steer code generation, so a quote-style rewrite there would be a pipeline
+    # change disguised as formatting. Ruff owns this repo's Python, not its
+    # prose; formatting the docs stays a deliberate, separate decision.
+    "*.md",
 ]
 
 [tool.ruff.lint]

From cee41bcbc7370326f88d6dc566bd8a4159aedee3 Mon Sep 17 00:00:00 2001
From: Markus Neusinger <2921697+MarkusNeusinger@users.noreply.github.com>
Date: Sun, 26 Jul 2026 00:07:19 +0200
Subject: [PATCH 2/2] docs: reference the PR in the changelog entry

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e652ccad05..4dc728dc3a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -136,7 +136,7 @@ aggregate instead: an italic *Catalog* line at the end of the version section an
   `*.md`. Deliberately not fixed by reformatting those files — nine of them are
   `prompts/library/*.md`, whose snippets steer code generation, so rewriting quote style there
   is a pipeline change wearing a formatting costume. Verified against both 0.15.21 and 0.16.0
-  (`format --check` + `check` clean on 148 files).
+  (`format --check` + `check` clean on 148 files) (#9899).
 - **A GitHub API brown-out could strand implementation PRs permanently — the hand-off calls
   are now retried** — on 2026-07-24 (~16:05–16:26 UTC) GitHub returned HTTP 502 on the
   workflow-dispatch endpoint and HTTP 504 on GraphQL, and four `radar-basic` PRs fell out of