Skip to content

chore(rules): remove unfollowable docs-sync rule - #1421

Merged
willwashburn merged 1 commit into
mainfrom
claude/agent-relay-skills-review-a8mgtd
Aug 3, 2026
Merged

chore(rules): remove unfollowable docs-sync rule#1421
willwashburn merged 1 commit into
mainfrom
claude/agent-relay-skills-review-a8mgtd

Conversation

@willwashburn

@willwashburn willwashburn commented Aug 3, 2026

Copy link
Copy Markdown
Member

Summary

Deletes .claude/rules/docs-sync.md, which instructs agents to do something impossible in this repo.

The rule says public docs live in web/content/docs/*.mdx, that the Next.js app "under web/" reads that directory, and that new pages must be registered in web/lib/docs-nav.ts — "New pages go here, period." It then warns against touching the top-level docs/ directory.

Neither directory exists:

$ ls -d web docs
ls: cannot access 'web': No such file or directory
ls: cannot access 'docs': No such file or directory

The docs site now lives in the agentrelay.com repo (web/content/docs/, web/lib/docs-nav.ts) — the rule is a leftover from before that split.

It also has no paths: frontmatter, unlike every other rule in .claude/rules/, so it applied globally: any agent working anywhere in this repo was handed doc instructions with no valid target.

This is the first of several PRs from a review of the Agent Relay skills and plugins across relay, skills, and agentrelay.com.

Test Plan

  • Confirmed no web/ or docs/ directory exists in this repo
  • Grepped for referencing files — the only remaining mentions are in .agentworkforce/trajectories/ archives, which are historical records and intentionally left untouched
  • Tests added/updated — n/a, removes an agent instruction file with no code or build dependency

Screenshots

n/a


Generated by Claude Code

Review in cubic

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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jmke9G9s7ftrN49opNmdx1
@coderabbitai

coderabbitai Bot commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 797107f0-771a-4e61-abb8-53d509fa69d2

📥 Commits

Reviewing files that changed from the base of the PR and between 8a687a0 and bd0e1b4.

📒 Files selected for processing (1)
  • .claude/rules/docs-sync.md
💤 Files with no reviewable changes (1)
  • .claude/rules/docs-sync.md

📝 Walkthrough

Walkthrough

The pull request deletes .claude/rules/docs-sync.md, which defined documentation ownership, navigation updates, and legacy documentation restrictions.

Changes

Cohort / File(s) Summary
Documentation rule removal
.claude/rules/docs-sync.md
Deletes the documentation synchronization rule and its 30 lines of guidance.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Suggested reviewers: khaliqgant

Poem

A rabbit hops where old rules lay,
The docs-sync guide has gone away.
No pages shift, no links renew,
The archive note is gone there too.
I twitch my nose and say, “Done!”

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly states that the obsolete, unfollowable documentation synchronization rule was removed.
Description check ✅ Passed The description follows the template and explains the obsolete rule, its invalid paths, scope issue, and verification steps.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/agent-relay-skills-review-a8mgtd

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

No issues found across 1 file

Re-trigger cubic

@willwashburn
willwashburn merged commit 919e6c0 into main Aug 3, 2026
28 checks passed
@willwashburn
willwashburn deleted the claude/agent-relay-skills-review-a8mgtd branch August 3, 2026 14:06
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.

2 participants