Summary
The llms.txt index file contains manually written blurbs that describe the contents of each generated bundle (e.g., in scripts/generate-llms-full.js). Since AI reads these blurbs in llms.txt to understand file contents, it's important they accurately reflect what each file contains.
Currently, these blurbs are hardcoded and risk becoming stale as content changes.
Proposed improvement
During the llms.txt generation process, use AI to dynamically generate accurate blurbs based on the actual content of each generated file — rather than relying on static, manually maintained descriptions.
This would keep blurbs in sync automatically and improve the quality of AI-readable metadata over time.
Context
Raised in PR #900 discussion — not a blocker for the current PR, but noted as a future improvement once AI can be hooked into the publication process.
Summary
The
llms.txtindex file contains manually written blurbs that describe the contents of each generated bundle (e.g., inscripts/generate-llms-full.js). Since AI reads these blurbs inllms.txtto understand file contents, it's important they accurately reflect what each file contains.Currently, these blurbs are hardcoded and risk becoming stale as content changes.
Proposed improvement
During the
llms.txtgeneration process, use AI to dynamically generate accurate blurbs based on the actual content of each generated file — rather than relying on static, manually maintained descriptions.This would keep blurbs in sync automatically and improve the quality of AI-readable metadata over time.
Context
Raised in PR #900 discussion — not a blocker for the current PR, but noted as a future improvement once AI can be hooked into the publication process.