add guides for Cursor and Claude Code tools #3874
Conversation
✅ Deploy Preview for hyprnote-storybook canceled.
|
✅ Deploy Preview for hyprnote ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
![devin-ai-integration[bot]](https://avatars.githubusercontent.com/in/811515?s=60&v=4){kind=small}
| - [ ] [Homebrew](/handbook/onboarding/homebrew) — Mac package manager. You'll use this to install almost everything else. | ||
| - [ ] [Warp](/handbook/onboarding/warp) — Our recommended terminal. This is where you run commands. | ||
| - [ ] [Node.js & pnpm](/handbook/onboarding/node-and-pnpm) — JavaScript runtime and package manager. Required even if you never write code. | ||
| - [ ] [GitButler](/handbook/onboarding/gitbutler) — Our git client. Visual interface instead of raw git commands. | ||
|
|
||
| **Development Tools (Engineers + Technical Roles)** | ||
|
|
||
| - [ ] [Cursor](/handbook/onboarding/cursor) — AI-powered code editor. Our primary IDE recommendation. | ||
| - [ ] [Claude Code](/handbook/onboarding/claude-code) — AI coding assistant that runs in your terminal. |
There was a problem hiding this comment.
🔴 All internal handbook links use wrong URL prefix /handbook/ instead of /company-handbook/
Every internal link added in this PR uses the path prefix /handbook/onboarding/... (e.g., /handbook/onboarding/homebrew), but the actual route for handbook pages is /company-handbook/.... There is no route or redirect registered for /handbook/, so all these links will lead to 404 pages.
Root Cause and Impact
The web app's handbook route is defined at apps/web/src/routes/_view/company-handbook/$.tsx as /_view/company-handbook/$. All existing handbook pages that link to other handbook pages correctly use /company-handbook/ (e.g., apps/web/content/handbook/teams/0.one-team.mdx:13 uses (/company-handbook/teams/engineering/)).
However, all 7 new files and the modified 0.getting-started.mdx use /handbook/ instead. For example:
0.getting-started.mdx:24:[Homebrew](/handbook/onboarding/homebrew)should be[Homebrew](/company-handbook/onboarding/homebrew)3.tooling-checklist.mdx:7:[Getting Started](/handbook/onboarding/getting-started)should be[Getting Started](/company-handbook/onboarding/getting-started)- Every "Return to Tooling Checklist" link at the bottom of each guide page
- All prerequisite links in cursor, claude-code, warp, and node-and-pnpm pages
This affects approximately 27 links across 8 files. Every cross-reference between the new onboarding guide pages is broken.
Impact: New team members following the onboarding guide will hit broken links on every tool setup page, making the guides effectively non-navigable.
Prompt for agents
Replace all occurrences of `/handbook/onboarding/` with `/company-handbook/onboarding/` in every file under apps/web/content/handbook/onboarding/. The affected files are:
1. apps/web/content/handbook/onboarding/0.getting-started.mdx (lines 24-27, 31-32, 62)
2. apps/web/content/handbook/onboarding/3.tooling-checklist.mdx (lines 7, 11-14, 18-19)
3. apps/web/content/handbook/onboarding/4.homebrew.mdx (line 46)
4. apps/web/content/handbook/onboarding/5.cursor.mdx (lines 15-16, 67)
5. apps/web/content/handbook/onboarding/6.gitbutler.mdx (line 64)
6. apps/web/content/handbook/onboarding/7.claude-code.mdx (lines 15-17, 63)
7. apps/web/content/handbook/onboarding/8.warp.mdx (lines 30, 72)
8. apps/web/content/handbook/onboarding/9.node-and-pnpm.mdx (lines 17, 78)
For example, change `(/handbook/onboarding/homebrew)` to `(/company-handbook/onboarding/homebrew)` everywhere. The route is defined at apps/web/src/routes/_view/company-handbook/$.tsx and all other existing handbook pages correctly use /company-handbook/ as the prefix.
Was this helpful? React with 👍 or 👎 to provide feedback.
1 participant
Uh oh!
There was an error while loading. Please reload this page.