Summary
The generated docs/AGENTS.md currently includes this entry:
- [Static](./static/llms.txt)
However, docs/static/llms.txt does not exist. The repository has a docs/static/ directory, but it appears to contain static assets rather than a documentation section with its own generated llms.txt file.
Where it seems to come from
docs/AGENTS.md is generated by scripts/agents.js, which calls discoverTopLevelSections() from scripts/lib/docs-utils.js.
discoverTopLevelSections() includes top-level directories unless they are listed in CONSTANTS.skipDirs. static is not currently in that skip list, so the generator treats docs/static/ as a docs section and emits a link to ./static/llms.txt.
Expected behavior
The generated AGENTS index should not link to ./static/llms.txt unless that file is generated/committed. If docs/static/ is only an asset directory, it should likely be skipped by the section discovery logic.
Reproduction
- Inspect
docs/AGENTS.md.
- Find the
Static entry under the LLM entry point section.
- Check that
docs/static/llms.txt is missing.
Possible fix
Add static to the docs generator skip list, or otherwise exclude asset-only directories from discoverTopLevelSections().
Summary
The generated
docs/AGENTS.mdcurrently includes this entry:However,
docs/static/llms.txtdoes not exist. The repository has adocs/static/directory, but it appears to contain static assets rather than a documentation section with its own generatedllms.txtfile.Where it seems to come from
docs/AGENTS.mdis generated byscripts/agents.js, which callsdiscoverTopLevelSections()fromscripts/lib/docs-utils.js.discoverTopLevelSections()includes top-level directories unless they are listed inCONSTANTS.skipDirs.staticis not currently in that skip list, so the generator treatsdocs/static/as a docs section and emits a link to./static/llms.txt.Expected behavior
The generated AGENTS index should not link to
./static/llms.txtunless that file is generated/committed. Ifdocs/static/is only an asset directory, it should likely be skipped by the section discovery logic.Reproduction
docs/AGENTS.md.Staticentry under the LLM entry point section.docs/static/llms.txtis missing.Possible fix
Add
staticto the docs generator skip list, or otherwise exclude asset-only directories fromdiscoverTopLevelSections().