Developer Onboarding
Full per-developer setup for the CleverCase team — from clone to first successful build.
CleverCase Developer Onboarding
Per-developer setup for the CleverCase team (not platform operators).
One-Command Setup (recommended)
Your team lead will provide a Tailscale auth key and AWS credentials. Once you have those:
# 1. Clone the repo
git clone git@github.com:rakontevr-ai/clevercase-v2.git
cd clevercase-v2
# 2. Install all dependencies (Brewfile: Node, Colima, Docker, kubectl, Tailscale, Cursor)
brew bundle install --file=Brewfile
# 3. Bootstrap (joins Tailscale, starts Colima, npm install, clevercase setup)
./scripts/bootstrap-developer.sh --tailscale-key tskey-auth-XXXX
# 4. Add AWS credentials (~/.aws/credentials) — team lead provides separately
# 5. Refresh package access and install
npm run setup:codeartifact
npm install
# 6. Pull secrets and start
npx clevercase secrets pull
npx clevercase start
# 7. Verify
./scripts/verify-setup.sh
npx clevercase doctorUse --minimal on 16GB Macs: ./scripts/bootstrap-developer.sh --minimal --tailscale-key …
Brewfile (what gets installed)
| Category | Packages |
|---|---|
| Core | node@24, git, git-lfs, jq, awscli, gh, wget |
| Containers | colima, docker, docker-compose, docker-buildx |
| Kubernetes | kubernetes-cli (kubectl) |
| DB clients | libpq (psql), redis |
| Desktop | Tailscale, Cursor |
The bootstrap script handles Colima start, Docker CLI plugins, and PATH for keg-only formulae.
What You Need From Your Team Lead
| Item | How you get it |
|---|---|
| GitHub access | Team lead adds you to rakontevr-ai/clevercase-v2 |
| Tailscale key | tskey-auth-... (one-time, expires 24h) |
| AWS credentials | Access key + secret (for @rakontevr packages) |
| Secrets access | Granted after clevercase secrets pull |
Manual Setup (if bootstrap doesn't fit)
Prerequisites
- macOS 13+ (Apple Silicon or Intel)
- Node.js 24+ (
brew install node@24) - Git + SSH access to
rakontevr-ai/clevercase-v2 - Tailscale (
brew install --cask tailscale) - Cursor IDE (
brew install --cask cursor) - AWS CLI (
brew install awscli)
Steps
- Clone:
git clone git@github.com:rakontevr-ai/clevercase-v2.git && cd clevercase-v2 - Join Tailscale:
sudo tailscale up --auth-key=<key> --accept-routes - Configure CodeArtifact:
npm run setup:codeartifact - Install:
npm install - Setup CLI:
npx clevercase setup - Pull secrets:
npx clevercase secrets pull - Start:
npx clevercase start - Verify:
npx clevercase doctor
Cursor IDE + MCP
clevercase setup configures the Rakontevr MCP server with tenant scope. This gives you:
- AI assistance scoped to CleverCase domain
- Compliance rules auto-loaded
- Code completion with legal domain context
Verify: npx clevercase doctor
Network Access (Tailscale)
| Resource | Access |
|---|---|
| CleverCase services | ✅ ports 443, 8443, 3000, 5432 |
| Gravislaw services | ✅ all ports |
| DGX cluster | ❌ proxied only (via service layer) |
| AWS infrastructure | ❌ proxied only |
Docs
| Doc | URL |
|---|---|
| Package docs | https://docs.rakontevr.com/docs/packages |
| CleverCase architecture | https://docs.rakontevr.com/docs/architecture/clevercase-architecture |
| Security trust center | https://docs.rakontevr.com/docs/architecture/security-trust-center |
| FAQ | https://docs.rakontevr.com/docs/reference/faq |
What you should NOT do
- Run
rak db safe-migratefrom client repo (platform operators only) - Import paths outside
clevercase-v2/in standalone builds - Log case narratives, client PII, or document bodies
- Share your Tailscale auth key with others (one key per person)
Troubleshooting
| Problem | Fix |
|---|---|
npm install fails with 401 | Run npm run setup:codeartifact (AWS token expired) |
| Tailscale "not connected" | sudo tailscale up --auth-key=<key> --accept-routes |
clevercase secrets pull denied | Ask team lead to grant your email access |
| Cursor MCP not working | npx clevercase setup then restart Cursor |
Related
- CLEVERCASE-ONBOARDING.md — operator provisioning
- getting-started.md — quick reference
- packages.md — Rakontevr packages CleverCase uses
- DEVELOPER-WORKFLOW-QUICK-REFERENCE.md — daily workflow