Development workflow

How we change this tree. Linux-first. One PR is one logical change. Do not run the full unscoped test suite.

Day to day

• export PATH="$HOME/.bun/bin:$PATH"
• bun install at the repo root (workspace lockfile).
• Typecheck: cd assistant && bunx tsc --noEmit or bun run typecheck:fast.
• Tests: cd assistant && bun test src/path/to/file.test.ts. Never bun test with no paths.

PRs

• Branch names include an issue id when one exists.
• Link Linear or GitHub with closing words when that ticket is the work.
• Do not commit generated clients/site/src/worker.js.
• Do not pack Linux or hatch from the server unless the board asked.

Agent commands

Maintainer slash commands live under .claude/ for isolated worktrees and review. Contributors do not need them. A normal clone, scoped tests, and a PR are enough.

See Contributing.