Skip to content

docs: no links to internal systems in this public repository - #70

Open
Swimburger wants to merge 1 commit into
cloudflare:mainfrom
Swimburger:agents-no-internal-links
Open

Swimburger wants to merge 1 commit into
cloudflare:mainfrom
Swimburger:agents-no-internal-links

Conversation

@Swimburger

Copy link
Copy Markdown

This repository is public, but much of the work on it happens alongside Cloudflare-internal systems, and links to those have already slipped into a pull request once. This adds the rule to the instructions coding agents read:

  • AGENTS.md: a new Public Repository section. No links to Cloudflare-internal systems in anything that becomes public: files, commit messages, branch names, and pull request and issue text. Bare ticket IDs such as FORGE-1 are fine. It also says what to do if an internal link is pushed anyway: a later commit doesn't remove it from history, so tell the maintainers.
  • CLAUDE.md: imports AGENTS.md, for agents that read CLAUDE.md rather than AGENTS.md.

The section describes internal systems in general terms rather than listing their hostnames, since listing them here would publish them.

@Swimburger
Swimburger force-pushed the agents-no-internal-links branch from 2c99022 to ed11bc6 Compare October 26, 2026 21:13
@Swimburger
Swimburger marked this pull request as ready for review October 26, 2026 21:14
Comment thread CLAUDE.md

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

We don't need this claude started reading agents.md

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.

3 participants