From 366fa5ef2982b3de96f975319d2f87b1732d0785 Mon Sep 17 00:00:00 2001 From: Olivier Biot Date: Mon, 31 Aug 2026 09:31:35 +0800 Subject: [PATCH 1/2] llms.txt: say 2D, 2.5D and 3D in the header too MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The plugin manifests, the router skill and the shipped AGENTS.md were widened to name all three in 20.3.0; the generated index kept the old "2.5D HTML5 game engine" line, so the one artifact written specifically for agents was the one still implying the engine does only 2.5D. Docs-only — llms.txt is published from docs/ by docs.yml, not shipped in the npm package, so this needs no release. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_012Aa37KGXZcnVrbn1yG4j1N --- packages/melonjs/scripts/generate-llms-txt.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/melonjs/scripts/generate-llms-txt.ts b/packages/melonjs/scripts/generate-llms-txt.ts index d8153427f..7b45788fd 100644 --- a/packages/melonjs/scripts/generate-llms-txt.ts +++ b/packages/melonjs/scripts/generate-llms-txt.ts @@ -224,7 +224,7 @@ const describe = (html: string): { summary: string; deprecated: boolean } => { const lines: string[] = [ "# melonJS", "", - "> melonJS is an open source 2.5D HTML5 game engine, rendering on WebGPU, WebGL 2 or Canvas with automatic fallback and no runtime dependencies. This file indexes the complete generated API reference.", + "> melonJS is an open source HTML5 game engine covering 2D, 2.5D and 3D, rendering on WebGPU, WebGL 2 or Canvas with automatic fallback and no runtime dependencies. This file indexes the complete generated API reference.", "", "Three rules produce code that runs and is wrong, so they are worth stating up front:", "", From e16cef761fedf9127312e12ca66a7c81f6131a93 Mon Sep 17 00:00:00 2001 From: Olivier Biot Date: Mon, 31 Aug 2026 11:24:38 +0800 Subject: [PATCH 2/2] llms.txt: point at the shipped AGENTS.md from the guides block MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit An agent reaching llms.txt is usually one that fell back to the index — and outside Claude Code, that is an agent reading AGENTS.md from a project root. The guides block listed the skills directory, wiki, examples and changelog but not the ready-made file it would actually copy. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_012Aa37KGXZcnVrbn1yG4j1N --- packages/melonjs/scripts/generate-llms-txt.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/melonjs/scripts/generate-llms-txt.ts b/packages/melonjs/scripts/generate-llms-txt.ts index 7b45788fd..d7c5d03a4 100644 --- a/packages/melonjs/scripts/generate-llms-txt.ts +++ b/packages/melonjs/scripts/generate-llms-txt.ts @@ -236,7 +236,7 @@ const lines: string[] = [ "", "## Guides", "", - "- [Agent skills](https://github.com/melonjs/melonJS/tree/master/packages/melonjs/skills): task-oriented guides shipped in the npm package under `melonjs/skills/`, one per subsystem. Start with `melonjs/SKILL.md`.", + "- [Agent skills](https://github.com/melonjs/melonJS/tree/master/packages/melonjs/skills): task-oriented guides shipped in the npm package under `melonjs/skills/`, one per subsystem. Start with `melonjs/SKILL.md`; `melonjs/skills/AGENTS.md` is a ready-made project-root instruction file if you follow that convention.", "- [Wiki](https://github.com/melonjs/melonJS/wiki): hand-written guides — rendering API, Tiled workflows, 3D, upgrade notes.", "- [Examples](https://melonjs.github.io/melonJS/examples/): runnable demos; sources under `packages/examples/src/examples/`.", "- [Changelog](https://github.com/melonjs/melonJS/blob/master/packages/melonjs/CHANGELOG.md): what changed and when, including breaking changes.",