diff --git a/packaging/flatpak/net.catcrafts.CrafterBuild.metainfo.xml b/packaging/flatpak/net.catcrafts.CrafterBuild.metainfo.xml
index 3cf4c41..95a0a53 100644
--- a/packaging/flatpak/net.catcrafts.CrafterBuild.metainfo.xml
+++ b/packaging/flatpak/net.catcrafts.CrafterBuild.metainfo.xml
@@ -25,6 +25,22 @@
   </provides>
   <content_rating type="oars-1.1"/>
   <releases>
+    <release version="4.0.0" date="2026-10-31">
+      <description>
+        <p>New</p>
+        <ul>
+          <li>A project keeps its agent instructions in <code>AGENTS.template.md</code>, and <code>crafter-build</code> and <code>crafter-build test</code> write <code>AGENTS.md</code> from it with the dependencies' notes merged in: after the template's text, or between its marker lines. <code>AGENTS.md</code> is build output, so it goes into .gitignore, and a fresh clone has none until its first build. A project with a committed <code>AGENTS.md</code> moves over with <code>git mv AGENTS.md AGENTS.template.md</code> and <code>echo /AGENTS.md &gt;&gt; .gitignore</code>. An <code>AGENTS.md</code> no build wrote, such as a committed one still beside a new template, is never replaced; every build warns until it is deleted.</li>
+        </ul>
+        <p>Fixes</p>
+        <ul>
+          <li>A build no longer changes a file the project commits. The dependency notes lived in a section of the committed <code>AGENTS.md</code>, so a dependency that edited its notes, an unpinned one that moved on, or a flag that pulled one in showed up in the project's diff as a change nobody made.</li>
+        </ul>
+        <p>Breaking</p>
+        <ul>
+          <li>Without an <code>AGENTS.template.md</code>, a build leaves <code>AGENTS.md</code> alone. A section 3.0.0 kept in it is no longer updated, and every build warns about it until the file is moved to the template or the section is deleted.</li>
+        </ul>
+      </description>
+    </release>
     <release version="3.0.0" date="2026-10-31">
       <description>
         <p>New</p>