Simplify generated AGENTS.md to use live docs - #15384
Open
acoyfellow wants to merge 2 commits into
Open
Conversation
🦋 Changeset detectedLatest commit: 9e36881 The changes in this PR will be included in the next version bump. This PR includes changesets to release 1 package
Not sure what this means? Click here to learn what changesets are. Click here if you're a maintainer who wants to add another changeset to this PR |
workers-devprod
requested review from
a team and
dario-piotrowicz
and removed request for
a team
August 27, 2026 10:42
Contributor
|
Codeowners approval required for this PR:
Show detailed file reviewers |
@cloudflare/autoconfig
@cloudflare/build-output-utils
@cloudflare/codemods
@cloudflare/config
create-cloudflare
@cloudflare/deploy-helpers
@cloudflare/kv-asset-handler
miniflare
@cloudflare/pages-functions
@cloudflare/pages-shared
@cloudflare/unenv-preset
@cloudflare/vite-plugin
@cloudflare/vitest-plugin
@cloudflare/workers-auth
@cloudflare/workers-editor-shared
@cloudflare/workers-utils
wrangler
commit: |
dario-piotrowicz
approved these changes
Aug 28, 2026
dario-piotrowicz
left a comment
Member
There was a problem hiding this comment.
Approved with one small suggestion 🙂
workers-devprod
approved these changes
Aug 28, 2026
workers-devprod
left a comment
Contributor
There was a problem hiding this comment.
Codeowners reviews satisfied
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Tracks DEVX-2642 internally.
Summary
Create Cloudflare currently generates an
AGENTS.mdwith a fixed list of commands, products, limits, error guidance, and best-practice links. That content can become stale as Cloudflare products and documentation change.This change replaces the fixed inventory with a small retrieval instruction:
The root documentation index remains stable while product-specific guidance can change in the documentation without requiring a Create Cloudflare release. Asking agents to retrieve only the pages needed for the task also keeps generated context small.
This deliberately differs from #14775, which expands the generated file with Local Explorer endpoints. The intent here is to keep product instructions in the live documentation and keep the generated file as the durable entry point to that documentation.
Validation:
pnpm run test:ciinpackages/create-cloudflare: 261 tests passedpnpm run check:typeinpackages/create-cloudflarepnpm run buildinpackages/create-cloudflareoxlint --deny-warnings --type-awarefor the changed TypeScript filesoxfmt --checkfor the changed files