Skip to content

docs: add agentic files guide#2319

Open
Jonas Elfering (keulinho) wants to merge 11 commits into
mainfrom
codex/agentic-files-docs
Open

docs: add agentic files guide#2319
Jonas Elfering (keulinho) wants to merge 11 commits into
mainfrom
codex/agentic-files-docs

Conversation

@keulinho

@keulinho Jonas Elfering (keulinho) commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add a Storefront template guide for the new agentic files feature.
  • Document default files, public path derivation, template extension patterns, custom file templates, and Administration description snippets.
  • Explain Agentic Commerce plugin compatibility, including core-feature mode, fallback serving on older Shopware versions, and automatic enablement for UCP-enabled sales channels.

Related links

Checklist

  • I reviewed affected links, code samples, and cross-references, including PageRef references where relevant.
  • I added or updated redirects in .gitbook.yaml if pages were moved, renamed, or deleted.
  • I updated .wordlist.txt (and sorted it) if spellcheck flags new legitimate terms.
  • Any required dependent changes in downstream modules have already been merged and published.
  • This pull request is ready for review.

Notes

No redirects are required because this PR only adds a new page. Local validation: git diff --check.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds new Storefront documentation for the “agentic files” feature, explaining how plugins/themes extend and ship public AI-assistant-facing files (e.g., /llms.txt, /agents.md) and how this behaves across core support vs. Agentic Commerce plugin fallback.

Changes:

  • Added a new “Agentic Files” guide covering template paths → public paths, Twig extension patterns, custom file templates, and Administration snippet descriptions.
  • Linked the new guide from the Storefront Templates index.
  • Updated .wordlist.txt with new terms used in the documentation.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
guides/plugins/plugins/storefront/templates/index.md Adds navigation entry to the new Agentic Files guide.
guides/plugins/plugins/storefront/templates/agentic-files.md New guide documenting agentic files usage, extension points, variables, and plugin compatibility behavior.
.wordlist.txt Adds spellcheck allowlist entries for new terminology introduced in the guide.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread guides/plugins/plugins/storefront/templates/agentic-files.md Outdated
Comment thread guides/plugins/plugins/storefront/templates/agentic-files.md Outdated
Comment thread guides/plugins/plugins/storefront/templates/agentic-files.md Outdated
@Isengo1989 Micha Hobert (Isengo1989) added the Undocumented Feature Feature which is not documented yet and is considered for documentation label Jun 18, 2026
Comment thread guides/plugins/plugins/storefront/templates/agentic-files.md Outdated
@shopware-dev-docs-connector

shopware-dev-docs-connector Bot commented Jun 22, 2026

Copy link
Copy Markdown

Developer Docs healthcheck

Status: Completed with success.
Repository: shopware/docs
Commit: 8038572
Preview: https://developer-documentation-8ujhq5jfm-shopware-frontends.vercel.app
Workflow run: #4204

@Isengo1989 Micha Hobert (Isengo1989) left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thx for the PR Jonas Elfering (@keulinho) 💯

Jonas Elfering (keulinho) and others added 11 commits June 22, 2026 14:54
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Micha Hobert <m.hobert@shopware.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feedback-required Undocumented Feature Feature which is not documented yet and is considered for documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants