Add Claude Code compatibility via symlinks to Cursor rules

[mangelajo]

Creates .claude/rules/ directory with symlinks to existing .cursor/rules/ files, enabling both Cursor and Claude Code users to share the same project guidelines without duplication.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Updated internal development guidelines and rules documentation.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

This pull request adds reference links in two Claude rule documentation files, directing readers to corresponding Cursor rule documentation files. Each file receives a single-line reference to its Cursor counterpart without modifying any functional behavior.

Changes

Cohort / File(s)	Summary
Documentation cross-references ​.claude/rules/creating-new-drivers.md, ​.claude/rules/project-structure.md	Adds single-line references to corresponding Cursor rule files (../../.cursor/rules/creating-new-drivers.mdc and ../../.cursor/rules/project-structure.mdc respectively)

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• Add some cursor rules to help our AI assistants #642: Introduces the companion Cursor rule files (.cursor/rules/*) that these Claude rule files now reference, establishing the bidirectional documentation linking structure.

Suggested reviewers

• kirkbrauer
• bennyz
• NickCao

Poem

📚✨ A rabbit hopped through doc files bright,
Linking rules from left to right,
From Claude's home to Cursor's door,
Now readers find what they explore! 🐰

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: adding symlinks in a .claude/rules/ directory that point to existing .cursor/rules/ files for Claude Code compatibility.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch claude-compat

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between fa0a3b5 and 9df76b4.

📒 Files selected for processing (2)

• .claude/rules/creating-new-drivers.md (1 hunks)
• .claude/rules/project-structure.md (1 hunks)

🧰 Additional context used

🧠 Learnings (1)

📚 Learning: 2025-11-27T09:58:41.875Z

Learnt from: CR
Repo: jumpstarter-dev/jumpstarter PR: 0
File: .cursor/rules/creating-new-drivers.mdc:0-0
Timestamp: 2025-11-27T09:58:41.875Z
Learning: When creating a new driver, use the driver creation script: `./__templates__/create_driver.sh` with format: `./__templates__/create_driver.sh <driver_package> <DriverClass> "<Author Name>" "<authoremail.com>"`

Applied to files:

• .claude/rules/creating-new-drivers.md

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (7)

• GitHub Check: build
• GitHub Check: pytest-matrix (macos-15, 3.11)
• GitHub Check: pytest-matrix (ubuntu-24.04, 3.12)
• GitHub Check: pytest-matrix (macos-15, 3.13)
• GitHub Check: pytest-matrix (ubuntu-24.04, 3.11)
• GitHub Check: pytest-matrix (ubuntu-24.04, 3.13)
• GitHub Check: e2e

🔇 Additional comments (1)

.claude/rules/creating-new-drivers.md (1)

1-1: The implementation is correct. These are actual git symlinks (confirmed by git object type 120000), not plain text files. The symlinks properly point to the corresponding .mdc files in .cursor/rules/, and symlinks can legitimately have file extensions—the extension is part of the symlink's name, not its target. The .md extension for the symlink names (versus .mdc for the actual Cursor rules files) is intentional and provides tool compatibility without issues.

Likely an incorrect or invalid review comment.

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[mangelajo]

This is the solution that claude code suggested that offered less duplication @kirkbrauer WDYT?

[netlify]

✅ Deploy Preview for jumpstarter-docs ready!

Name	Link
🔨 Latest commit	9df76b4
🔍 Latest deploy log	https://app.netlify.com/projects/jumpstarter-docs/deploys/693893e83433cc0008fbee4f
😎 Deploy Preview	https://deploy-preview-777--jumpstarter-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[kirkbrauer]

@mangelajo I think this looks like a good solution. We might also want to add a CLAUDE.md or a generic version so we can have multiple agents understand the codebase, especially for creating/testing drivers.