How They Do ItBETA

COMPANY PLAYBOOK

Cal.com

Cal.com describes an outward-visible workflow for contributors, engineering release discipline and a mutual-fit hiring trial in the same public handbook.
Operating system
  1. Linear ticket ↔ GitHub issue
  2. reviewed PR
  3. main/staging
  4. production; 30-day mutual trial in hiring
  5. full-time decision.

System principles

  • Connect open-source contributors to the internal workflow.
  • Separate release environments through branches.
  • Create mutual work experience before a hiring decision.

Tensions and trade-offs

  • An open workflow eases contribution but can increase the cost of public discussion and synchronization.
  • A trial reduces fit risk but can create income and security uncertainty for the candidate.

PRACTICES

How Cal.com builds its operating system

01
Open-source coordination

Mirror Linear tickets bi-directionally to GitHub

A 2023 Cal.com handbook page describes mirroring Linear tickets to GitHub issues in both directions via SyncLinear; the page does not verify the current workflow.

How it works
The 2023 guide describes two-way syncing between internal tickets and public issues; current use is unconfirmed.
Why it is used
External contributors can converse with the team without access to the internal Linear workspace.
Trade-off
Synchronization and public-context maintenance are required across two surfaces.
Best fit
Open-source product teams that use an internal planning tool.
Open original source
02
Release management

Gate releases with branches and environments

Reviewed and approved PRs merge to main and then to the production branch, which starts automated deployment.

How it works
A PR maps to preview, main to staging and production to the live environment.
Why it is used
It separates a change into a distinct environment before it reaches production.
Trade-off
Additional branch and environment transitions lengthen the release process.
Best fit
Web product teams with preview and staging infrastructure.
Open original source
03
Hiring

30-day contract-to-hire trial

Cal.com uses a 30-day contract-to-hire trial before most full-time hires, then makes a full-time decision at its end.

How it works
Candidate and company assess mutual fit and red flags while doing real team work.
Why it is used
It lets both sides see the work, team and working style before a long commitment.
Trade-off
A short contract can increase candidate risk and uncertainty.
Best fit
Teams able to run the trial safely in contractual and ethical terms.
Open original source
04
Quality

Author self-review before PR review

The code author reviews their own change before sending the PR to someone else.

How it works
The self-review guide asks the author to read the diff and address errors, unnecessary changes, and clarity first.
Why it is used
Reserves reviewer attention for higher-value judgment rather than first-pass defects.
Trade-off
Authors can miss their own blind spots; it does not replace independent review.
Best fit
Pull-request-based engineering workflows.
Open original source
05
Production flow

Manage review queue with drafts and auto-update

Incomplete work is visible as a draft PR; ready PRs are kept current through auto-update/auto-merge mechanisms.

How it works
The PR-review guide distinguishes drafts from ready changes and defines auto-update/auto-merge separately.
Why it is used
Signals readiness to reviewers and reduces integration waiting.
Trade-off
Automation can accelerate a risky change if tests or protections are weak.
Best fit
Teams with CI protections and clear review ownership.
Open original source
06
Compensation

Biannual salary review

Cal.com’s pay page, changed 17 July 2026 but still marked “might be outdated / under construction,” describes twice-yearly reviews; current practice is unconfirmed.

How it works
The caveated source describes twice-yearly salary reviews; it is not presented as verified current policy.
Why it is used
Links pay decisions to recurring performance and market signals.
Trade-off
Frequent review adds management load and can create short-term performance pressure.
Best fit
Growing teams that generate regular performance evidence.
Open original source
07
Careers

Separate IC5 practice from IC6 strategy

In Cal.com’s published engineering ladder, IC5 owns team practices such as AI-development guidance and evaluation guardrails; IC6 sets company-level AI-tool strategy and the 18–24 month technical direction. These descriptions do not establish current staffing.

How it works
Separate role documents define IC5’s cross-team practice ownership and IC6’s long-horizon architecture and tooling choices.
Why it is used
Makes practice and strategy expectations visible in technical leadership.
Trade-off
A role description is normative and does not prove how many people currently hold the role.
Best fit
Engineering teams designing senior individual-contributor ladders.
Open original source
08
CI/CD

Move every standard into pre-merge CI and do not approve past nits

Cal.com writes its engineering standards down and aims to have each one checked in CI before merge: lint rules for domain boundaries, performance benchmarks that block regressions, and enforced test coverage for new code. Reviewers are expected to request fixes for nits and pattern violations rather than approve to reduce friction, and small refactors belong in the current PR instead of a deferred follow-up.

How it works
Architecture moves to vertical slices (`packages/features`), with repositories behind dependency injection and DTOs validated with Zod. Roughly 80% of boilerplate and non-critical code is meant to be AI-generated, large test suites are built with AI, and AI code reviewers are part of review. The stated target is to cut the share of PR effort spent on fixes from 35% to 20% or lower.
Why it is used
To tie quality to tooling instead of individual attention while output grows, and to share ownership across the whole system.
Trade-off
Initial velocity drops while standards settle in; DTOs, abstractions and tests add code; lint and CI tooling needs ongoing upkeep and stricter review can lengthen cycles. The claim that output doubled and the targets are self-reported, and partly describe planned rather than completed work.
Best fit
Mid-sized engineering teams that have written their standards down and where AI-assisted coding is widespread.
Open original source

Primary sources

How we work on ticketsCompany-owned GitHub handbook: engineering workflow
Source details
Company publication: YesAccessed: 2026-09-05Visible update: 2023-11-13 (visible page history)Licence: No LICENSE file surfaced in the handbook root; prose is unlicensed/all rights reserved.Archive: Public GitHub page; commit permalinks, raw files, and repository archives are capturable (no snapshot is claimed).
Deploying to ProductionCompany-owned GitHub handbook: production deployment guide
Source details
Company publication: YesAccessed: 2026-09-05Visible update: 2024-01-15 (visible page history)Licence: No LICENSE file surfaced in the handbook root; prose is unlicensed/all rights reserved.Archive: Public GitHub page; commit permalinks, raw files, and repository archives are capturable (no snapshot is claimed).
Contract-to-hire trialsCompany-owned GitHub handbook: hiring policy
Source details
Company publication: YesAccessed: 2026-09-05Visible update: 2025-05-28 (visible page history)Licence: No LICENSE file surfaced in the handbook root; prose is unlicensed/all rights reserved.Archive: Public GitHub page; commit permalinks, raw files, and repository archives are capturable (no snapshot is claimed).
Self-reviewsCompany-owned GitHub handbook: engineering workflow
Source details
Company publication: YesAccessed: 2026-09-05Visible update: Not displayedLicence: No licence stated in the reviewed source.Archive: Public GitHub page; commit permalinks, raw files, and repository archives are capturable (no snapshot is claimed).
PR ReviewsCompany-owned GitHub handbook: engineering workflow
Source details
Company publication: YesAccessed: 2026-09-05Visible update: Not displayedLicence: No licence stated in the reviewed source.Archive: Public GitHub page; commit permalinks, raw files, and repository archives are capturable (no snapshot is claimed).
Bonus & Equity StructureCompany-owned GitHub handbook: people policy
Source details
Company publication: YesAccessed: 2026-09-25Visible update: 2026-07-17 (repository path commit; page warns it might be outdated)Licence: No licence stated in the reviewed source.Archive: Public GitHub page; commit permalinks, raw files, and repository archives are capturable (no snapshot is claimed).
Cal.com IC5 engineering levelCompany-owned GitHub engineering ladder
Source details
Company publication: YesAccessed: 2026-09-25Visible update: 2026-04-21 (repository path commit; not page update)Licence: No licence stated in the reviewed source.Archive: Public GitHub page; commit permalinks, raw files, and repository archives are capturable (no snapshot is claimed).
Cal.com engineering IC5 and IC6Company-owned GitHub engineering ladder
Source details
Company publication: YesAccessed: 2026-09-25Visible update: 2026-04-21 (repository path commit; not page update)Licence: No licence stated in the reviewed source.Archive: Public GitHub page; commit permalinks, raw files, and repository archives are capturable (no snapshot is claimed).
Engineering in 2026 and beyondCompany-published blog post
Source details
Company publication: YesAccessed: 2026-10-15Visible update: 2025-10-14 (byline date shown; page metadata says 2026-10-14)Licence: No reuse licence displayed; treat page prose as copyrighted/all rights reserved.Archive: Public HTML URL; eligible for an external web snapshot (no snapshot is claimed).