diff --git a/.changeset/agents-md-best-practices.md b/.changeset/agents-md-best-practices.md new file mode 100644 index 000000000000..98be1721f1f8 --- /dev/null +++ b/.changeset/agents-md-best-practices.md @@ -0,0 +1,9 @@ +--- +"create-cloudflare": patch +--- + +Add best practices documentation links to generated AGENTS.md + +The AGENTS.md file generated for new Workers projects now directs AI coding agents to +fetch and understand the latest best practices before writing code, including Workers +best practices, Durable Objects rules, and Workflows rules. diff --git a/packages/create-cloudflare/src/agents-md.ts b/packages/create-cloudflare/src/agents-md.ts index 93bae35c0d1b..0436bc6243da 100644 --- a/packages/create-cloudflare/src/agents-md.ts +++ b/packages/create-cloudflare/src/agents-md.ts @@ -40,4 +40,11 @@ https://developers.cloudflare.com/workers/runtime-apis/nodejs/ Retrieve API references and limits from: \`/kv/\` · \`/r2/\` · \`/d1/\` · \`/durable-objects/\` · \`/queues/\` · \`/vectorize/\` · \`/workers-ai/\` · \`/agents/\` + +## Best Practices (conditional) + +If the application uses Durable Objects or Workflows, refer to the relevant best practices: + +- Durable Objects: https://developers.cloudflare.com/durable-objects/best-practices/rules-of-durable-objects/ +- Workflows: https://developers.cloudflare.com/workflows/build/rules-of-workflows/ `;