This document is the repo-level quick-start for coding agents. Use it for monorepo orientation, shared quality gates, and safe editing workflow.

• AGENTS.md is the source of truth.
• CLAUDE.md must be a symbolic link to AGENTS.md.
• Never edit CLAUDE.md directly. Always update AGENTS.md.

• Monorepo: pnpm workspaces (apps/, packages/, tooling/)
• App workspaces: Rehoboam UI in apps/ui, Cloudflare Worker API in apps/api, and Cloudflare Worker Jobs in apps/jobs
• Package manager: pnpm (lockfile: pnpm-lock.yaml)
• Required Node version: 24.12.0 (from .nvmrc)

• App workspaces: apps/ui, apps/api, apps/jobs
• Shared packages: packages/*
• Shared tooling configs: tooling/eslint, tooling/prettier, tooling/typescript
• Architecture and project docs: docs/

• Web app detailed guidance lives in apps/ui/AGENTS.md.
• API app guidance lives in apps/api/AGENTS.md.
• Jobs app guidance lives in apps/jobs/AGENTS.md.
• Before changing a workspace, read its local AGENTS.md if present.

Run from repo root unless noted.

• Install dependencies: pnpm install
• Dev (all workspaces): pnpm dev
• Build (all workspaces): pnpm build
• Typecheck (all workspaces): pnpm typecheck
• Lint (all workspaces): pnpm lint
• Test (all workspaces): pnpm test
• Format all files: pnpm format
• Format check: pnpm format:check
• Run one workspace command: pnpm --filter <workspace> <script>

CI enforces the following on PRs and main:

• typecheck
• lint
• format:check
• test

Workflows: .github/workflows/feature.yml and .github/workflows/main.yml.

• TypeScript strict mode via @repo/typescript
• ESLint rules via @repo/eslint (type-aware)
• Prettier rules via @repo/prettier
• Prefer minimal, targeted edits and preserve existing architecture patterns
• Keep docs in docs/ aligned with behavior and architecture changes

1. Identify target workspace(s) and read local AGENTS.md guidance.
2. Make minimal edits in the correct workspace.
3. Run checks for touched scope (pnpm --filter <workspace> typecheck lint test when possible).
4. Run root checks when changes span multiple workspaces.
5. Update docs if architecture or behavior changed.