diff --git a/.gitea/workflows/ai-agent.yml b/.gitea/workflows/ai-agent.yml
index dfa5be4..cb40ba4 100644
--- a/.gitea/workflows/ai-agent.yml
+++ b/.gitea/workflows/ai-agent.yml
@@ -1,5 +1,5 @@
 name: ai-agent
-run-name: ai-agent · #${{ github.event.issue.number }}
+run-name: "ai-agent · #${{ github.event.issue.number }}"   # quotes required: bare # starts a YAML comment
 # Standard caller for the shared AI-agent workflow (ffaerber/agents). Copy this file VERBATIM into
 # any repo that should get the agents — it is identical in every repo. All logic + scripts live in
 # agents/.gitea/workflows/; scripts are fetched from @main at run time. The `jobs.agent` wrapper is
diff --git a/README.md b/README.md
index a3869d5..ff1ed4e 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,7 @@ it is the source of truth, and `agents` itself uses the same file:
 
 ```yaml
 name: ai-agent
-run-name: ai-agent · #${{ github.event.issue.number }}
+run-name: "ai-agent · #${{ github.event.issue.number }}"   # quotes required: bare # starts a YAML comment
 # Standard caller for the shared AI-agent workflow (ffaerber/agents). Copy this file VERBATIM into
 # any repo that should get the agents — it is identical in every repo. All logic + scripts live in
 # agents/.gitea/workflows/; scripts are fetched from @main at run time. The `jobs.agent` wrapper is