Skip to content

Generated AGENTS.md links to missing static/llms.txt #1806

Description

@omerbek

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

  1. Inspect docs/AGENTS.md.
  2. Find the Static entry under the LLM entry point section.
  3. 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().

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions