Skip to content

feat: add focused LLM slice files (llms-api.txt, llms-node-ops.txt)#802

Open
crtahlin wants to merge 3 commits into
ethersphere:masterfrom
crtahlin:feat/llm-slice-files
Open

feat: add focused LLM slice files (llms-api.txt, llms-node-ops.txt)#802
crtahlin wants to merge 3 commits into
ethersphere:masterfrom
crtahlin:feat/llm-slice-files

Conversation

@crtahlin
Copy link
Copy Markdown
Collaborator

Summary

Adds two task-specific documentation bundles so AI coding agents can load only what's relevant instead of the full 630KB llms-full.txt:

  • llms-api.txt (220KB, 20 docs) — API usage, uploads, stamps, feeds, chunks, encryption, developer tooling
  • llms-node-ops.txt (225KB, 22 docs) — installation, configuration, monitoring, staking, backups, upgrades, FAQ

Uses docusaurus-plugin-llms customLLMFiles — glob patterns auto-include new pages, no manual maintenance.

Also adds discovery links in static/llms.txt and extends the validation script.

Refs: ethersphere/DevRel#840

Maintenance

  • Auto-maintained: slice patterns use directory globs, so new docs added under docs/develop/ or docs/bee/installation/ are automatically included
  • Validation: scripts/validate-llms-txt.mjs logs referenced slice files
  • No manual file curation needed — the plugin generates from patterns at build time

Test plan

  • npm run build succeeds — both files generated
  • llms-api.txt: 20 documents, correct header/rootContent
  • llms-node-ops.txt: 22 documents, correct header/rootContent
  • static/llms.txt references both slices
  • Validation script detects slice references

Add two task-specific documentation bundles via docusaurus-plugin-llms
customLLMFiles, so AI agents can load only the docs relevant to their task
instead of the full 630KB llms-full.txt:

- llms-api.txt (220KB, 20 docs): API usage, uploads, stamps, feeds, chunks,
  encryption, developer tooling
- llms-node-ops.txt (225KB, 22 docs): installation, configuration, monitoring,
  staking, backups, upgrades, FAQ

Both use glob patterns so new pages added under those directories are
automatically included — no manual maintenance needed.

Also adds slice file references to static/llms.txt for agent discovery,
and extends the validation script to log referenced slice files.

Refs: ethersphere/DevRel#840
@netlify
Copy link
Copy Markdown

netlify Bot commented May 13, 2026

Deploy Preview for test-twitter-preview-testing-3 ready!

Name Link
🔨 Latest commit 85f186f
🔍 Latest deploy log https://app.netlify.com/projects/test-twitter-preview-testing-3/deploys/6a04852d78610100087620a1
😎 Deploy Preview https://deploy-preview-802--test-twitter-preview-testing-3.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant