[create-cloudflare] Add best practices links to generated AGENTS.md

[irvinebroque]

No associated issue — this is a small content improvement to the generated AGENTS.md.

Summary

Updates the AGENTS.md content generated by create-cloudflare for new Workers projects to direct AI coding agents to fetch and understand the latest best practices before writing any code. Adds links to:

• Workers Best Practices
• Rules of Durable Objects
• Rules of Workflows

These are placed in the preamble, immediately after the initial retrieval directive ("STOP. Your knowledge..."), so agents encounter them before any other guidance.

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because: existing tests pass — the test asserts the output of getAgentsMd() is written to disk without checking specific content
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: this change adds links to existing public documentation pages

---

[changeset-bot]

🦋 Changeset detected

Latest commit: acbdb2d

The changes in this PR will be included in the next version bump.

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

[irvinebroque]

/bonk are you able to review in this repository? if so please review

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 3 additional findings.

[claude]

Claude finished @irvinebroque's task —— View job

---

Changeset Review

• Read changeset guidelines
• Review changeset file
• Post review results

---

✅ All changesets look good

The changeset .changeset/agents-md-best-practices.md passes all validation criteria:

• ✅ Version type: patch is appropriate for documentation improvements
• ✅ Changelog quality: Clear, descriptive explanation of what's being added
• ✅ Markdown headers: No h1/h2/h3 headers present
• ✅ No analytics changes
• ✅ Not a dependency update
• ✅ Not an experimental feature

[elithrar]

I would probably just let the agent discover these two - otherwise you’ll probably end up with a little bit of context bloat?

[irvinebroque]

/bonk please update this file to include the links to Workflows and Durable Objects, but do not instruct the agent as directly as you do for Workers. And move the Workflows and Durable Objects links to the bottom of the Agents.md. It should be made clear to the Agent that these are optional, and to be referenced if the app that the user is building uses Workflows or Durable Objects

[irvinebroque]

Oh no bonk 😭

[irvinebroque]

22c4e57

[pkg-pr-new]

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@12563

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@12563

miniflare

npm i https://pkg.pr.new/miniflare@12563

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@12563

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@12563

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@12563

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@12563

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@12563

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@12563

wrangler

npm i https://pkg.pr.new/wrangler@12563

commit: acbdb2d