new-relo
CLAUDE.md1 starsChanged todayMITView on GitHub
One Cloudflare Worker: a live production site for Crosby, Texas. Current conditions and forecasts, plus a dated record of the town's weather, floods, burn bans and school dates. Every page is served in English and Mexican Spanish, beside a JSON API, an MCP server and RSS feeds. No framework and no runtime dependencies: fetch, KV, D1 and static assets only. - One change per PR, verified live before the next. An audit's non-critical findings share one PR, two at most.…
In this repository3 other files it gives its agents.
- deploySkill
- kvSkill
- verify-siteSkill
The file
We split this CLAUDE.md into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 52
Verify a new upstream from the deployed Worker before building on it: a temporary /debug-<name>-canary route, npx wrangler deploy, curl it …
≈ “Common” is an estimate: at least 1 in 5 of the 27,641 CLAUDE.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
crosbynews.com
One Cloudflare Worker: a live production site for Crosby, Texas. Current
conditions and forecasts, plus a dated record of the town's weather, floods,
burn bans and school dates. Every page is served in English and Mexican
Spanish, beside a JSON API, an MCP server and RSS feeds. No framework and no
runtime dependencies: fetch, KV, D1 and static assets only.
Checks
| Syntax | find src -name '*.js' -print0 | xargs -0 -n1 node --check |
| One test | node scripts/test-routes.mjs (every scripts/test-*.mjs and check-*.mjs runs alone: pure Node, no install, no network) |
| All tests | for f in scripts/check-*.mjs scripts/test-*.mjs; do node "$f" >/dev/null 2>&1 || echo "FAIL $f"; done (about a minute) |
| Build | npm ci && npx wrangler deploy --dry-run |
| Deploy | CI on push to main: D1 migrations, then the Worker. By hand: /deploy |
| Live | /verify-site after every deploy |
Workflow
- One change per PR, verified live before the next. An audit's non-critical findings share one PR, two at most.
- Open and squash-merge the PR yourself. The two required checks are
"Syntax check" and "Build check (dry-run)", and the branch must be up to
date with
main. - A merge deletes the head branch. Start the next change with
git fetch origin main && git checkout -B <branch> origin/main. A session cannot delete branches or change repo settings (403): don't retry. - A new Worker version takes 1–2 minutes to reach every edge, and a cache-buster does not help. Sample a live check several times before calling it either way.
- Live checks send a bot User-Agent so they are not counted as visits:
Mozilla/5.0 (compatible; CrosbyNewsVerifyBot/1.0; +https://crosbynews.com/). - Wrangler authenticates with
CLOUDFLARE_API_TOKENandCLOUDFLARE_ACCOUNT_ID;CLOUDFLARE_ZONE_API_TOKENis the wider zone-scoped token. Neverwrangler login. A permission error after adding a binding means the token lacks it: say so, a session cannot widen it. - The backlog is GitHub Issues labelled
backlog; session task lists do not persist. In a run nobody is watching (the@claudeworkflow, a routine), a question prompt can go unanswered: write the decision out in text.
Tests
- Mutation-test every new check: commit first, break the code, confirm the
test fails, restore with
git checkout -- <file>. Never restore from a copy, and never mutate uncommitted work. Readgit show --stat HEADbefore pushing a multi-file commit. - A check that reuses the code under test cannot falsify it. Assert literal values written out by hand; to test a parser, extract from the upstream with a looser pattern and diff.
- Verify a new upstream from the deployed Worker before building on it: a
temporary
/debug-<name>-canaryroute,npx wrangler deploy, curl it live, then restore from git and redeploy. A curl from the container proves nothing (Google News answers containers and refuses Worker IPs). - A new test must be added to
.github/workflows/deploy.ymlto run in CI.
Where the rest is written down
docs/pages/, docs/endpoints/ and docs/ops/ record current expected
state, one file per page, route or topic. Overwrite the matching file in the
same PR as the change it describes, along with any rule below or
.claude/skills/*/SKILL.md the change makes stale. docs/audit/ and
docs/investigations/ are dated and never edited.
The invariants live in .claude/rules/. Each file loads when a matching file
is opened; read the one for your area first when planning, or in a session
where it has not loaded.
| Working on | Rule file |
A page, a route, an endpoint, /es | pages-and-routes.md |
| What a page says or looks like: translation, timestamps, search signals, the look, the wording | content.md |
| KV feeds, the D1 record, migrations, gauge and history pages | data.md |
src/assets/, public/, icons | assets.md |
| The MCP server and its tool list | mcp.md |
Request counting and /privacy | privacy.md |
Workflows, wrangler.jsonc, dependencies | ci.md |
Outside the repository's files
- Production KV: load
/kvbefore any write or delete. Several keys must never be hand-edited, andwrangler kvreads local state without--remote. - Production D1:
npx wrangler d1 execute crosby-record --remote --command "SELECT …". - Cloudflare zone: HSTS is deliberately not preloaded (owner decision). Never
paste a TXT record from a Cloudflare DCV email; re-read the certificate
pack first. www → apex and http → https are one zone Redirect rule, not
Worker code. Audit the edge with a browser User-Agent and an HTML
Acceptheader: Cloudflare once injected a tracker a default curl never saw.docs/ops/cloudflare-zone.md,docs/ops/domain.md. - DNS:
node scripts/dmarc.mjsrewrites the DMARC record with oneruaand would drop the second recipient Cloudflare added, so PATCH the live record for a policy change (docs/ops/email-auth.md). DNS-AID SVCB records:node scripts/dns-aid.mjs(docs/ops/dns-aid.md). - Several GitHub repo toggles are dashboard-only for a session, and
ghreaches REST but not GraphQL here.docs/ops/github-security.md.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

