Skip to content

CLAUDE.md

Latest commit

 

History

History
40 lines (28 loc) · 1.14 KB

CLAUDE.md

File metadata and controls

40 lines (28 loc) · 1.14 KB

CLAUDE.md

Project

  • Name: Perstack
  • Model: claude-sonnet-4-5
  • Runtime: local

Validation Commands

bun run typecheck      # Type checking
bun run test           # Unit tests
bun test --timeout 300000 e2e/ # E2E tests (requires API keys)
bun run build          # Build all packages
bun run format-and-lint # Lint and format

Versioning

  • Use bunx changeset to create changesets for any package changes
  • Core major/minor bump requires ALL packages to bump with the same type
  • Run bun run validate:changeset to verify before pushing

Coding Style

  • TypeScript with Biome for formatting and linting
  • Run bun run format-and-lint:fix to auto-fix formatting
  • Use zod for runtime validation schemas
  • Prefer explicit imports over barrel re-exports

Language

  • All artifacts must be written in English: code, comments, commit messages, issues, PRs, documentation, and changelogs

GitHub Operations

  • PRs require passing CI: typecheck, test, build, lint, changeset check
  • Commit messages follow conventional commits: feat:, fix:, chore:, refactor:
  • Security-related changes: read SECURITY.md first