Slim Wurst agent template

Author: Frotty

AGENTS.md

@@ -15,6 +15,7 @@ This repo builds the Grill CLI and project setup tooling. The generated map-proj
 - Local helpers in `config/ProjectConfigModels.kt` should stay thin: typealiases plus immutable copy helpers for shared records.
 - `YamlHelper.dumpProjectConfig` intentionally serializes a pruned YAML map instead of the shared records directly. This preserves the old user-facing `wurst.build` behavior by omitting null/default nested fields.
 - `wbschema.json` should stay lenient and aligned with the shared config parser, especially for `scriptMode`, `wc3Patch`, and nullable legacy fields.
+- Compiler-owned agent references belong in `~/.wurst/wurst-compiler/agent-docs/`. Generated project notes should prefer those version-matched local files when present and retain an online fallback until compiler releases ship them.
 
 ## WC3 Patch And Core JASS
 

src/main/kotlin/file/SetupApp.kt

@@ -32,7 +32,7 @@ object SetupApp {
 
     private data class WurstProcessResult(val exitCode: Int, val output: List<String>)
 
-    internal const val AGENTS_TEMPLATE_VERSION = "2026-08-05"
+    internal const val AGENTS_TEMPLATE_VERSION = "2026-08-08"
     private const val AGENTS_TEMPLATE_MARKER_PREFIX = "<!-- WURST_AGENTS_TEMPLATE_VERSION:"
     private const val AGENTS_TEMPLATE_MARKER = "<!-- WURST_AGENTS_TEMPLATE_VERSION: $AGENTS_TEMPLATE_VERSION -->"
     private const val AGENTS_TEMPLATE_SOURCE_HINT = "WurstScript Warcraft III map project notes"

src/test/kotlin/AgentsTemplateTests.kt

@@ -0,0 +1,29 @@
+import org.testng.Assert
+import org.testng.annotations.Test
+import java.nio.file.Files
+import java.nio.file.Paths
+
+class AgentsTemplateTests {
+    private val templatePath = Paths.get("templates", "AGENTS.md")
+
+    @Test
+    fun testTemplateStaysTokenLean() {
+        val content = Files.readString(templatePath)
+        val wordCount = Regex("""\S+""").findAll(content).count()
+
+        Assert.assertTrue(wordCount <= 900, "AGENTS template grew to $wordCount words (limit: 900)")
+        Assert.assertTrue(content.length <= 7000, "AGENTS template grew to ${content.length} characters (limit: 7000)")
+    }
+
+    @Test
+    fun testLanguageDocsPreferCompilerMatchedLocalReference() {
+        val content = Files.readString(templatePath)
+        val localReference = "~/.wurst/wurst-compiler/agent-docs/WURST_LANGUAGE.md"
+        val onlineFallback = "https://wurstlang.org/manual.html"
+        val localIndex = content.indexOf(localReference)
+        val onlineIndex = content.indexOf(onlineFallback)
+
+        Assert.assertTrue(localIndex >= 0, "Missing compiler-matched local language reference")
+        Assert.assertTrue(onlineIndex > localIndex, "Online manual must remain a fallback after the local reference")
+    }
+}