From bd0e1b4dec58e3aa1ab3b984e9647c884215481f Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 3 Aug 2026 13:46:08 +0000 Subject: [PATCH] chore(rules): remove unfollowable docs-sync rule MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The rule mandated that public docs live in `web/content/docs/*.mdx` and that new pages be registered in `web/lib/docs-nav.ts` ("New pages go here, period"). This repo has no `web/` directory — the docs site moved to the agentrelay.com repo. It also warned against the top-level `docs/` directory, which no longer exists here either. The rule has no `paths:` frontmatter, so it applied globally: every agent working anywhere in this repo was handed doc instructions that cannot be carried out. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01Jmke9G9s7ftrN49opNmdx1 --- .claude/rules/docs-sync.md | 30 ------------------------------ 1 file changed, 30 deletions(-) delete mode 100644 .claude/rules/docs-sync.md diff --git a/.claude/rules/docs-sync.md b/.claude/rules/docs-sync.md deleted file mode 100644 index b7423b243..000000000 --- a/.claude/rules/docs-sync.md +++ /dev/null @@ -1,30 +0,0 @@ -# Documentation Rule - -## Public docs live in `web/content/docs/*.mdx` - -This is the single source of truth — the Next.js web app under -`web/` reads this directory directly to build the published docs -site. New pages go here, period. - -When you add a new page: - -- Create `web/content/docs/{slug}.mdx` with the standard frontmatter - (`title:` and `description:`). -- Add an entry to the navigation in `web/lib/docs-nav.ts` under the - appropriate group, OR to the `ALL_SLUGS` "hidden but routable" - list if it shouldn't appear in the sidebar. - -That's it. Don't create or update files in the top-level `docs/` -directory. - -## The top-level `docs/` directory is legacy - -It contains a partial mirror of a handful of MDX pages converted to -plain markdown. It was originally maintained as an "LLMs / CLI users -/ GitHub readers" alternate, but it drifted out of sync long ago -(5 pages survive vs 40+ in `web/content/docs/`) and is no longer -authoritative. Do not add new files to it, and do not "mirror" your -MDX changes into it. - -Existing pages there will be cleaned up separately. Treat the -directory as read-only legacy until that happens.