The repository-level contribution guide defines the complete workflow. The engineering rules that matter most are:

  • enforce authorization on the server
  • scope tenant-owned resources by organizationId
  • validate input with Zod
  • record schema changes in Prisma migrations
  • log important mutations without secrets or unnecessary personal data
  • update documentation alongside behavior.
pnpm typecheck
pnpm lint
pnpm test
pnpm build

Add pnpm e2e for critical workflows or navigation changes. Preview documentation with:

python3.13 -m venv .venv-docs
source .venv-docs/bin/activate
python -m pip install -r requirements-docs.txt
python -m mkdocs serve

Documentation should begin with the reader's goal, use exact interface labels when needed, and include diagrams only when they clarify a relationship or sequence.