Vercel CI Setup

Onboard a private GitHub repository to Vercel CI by selecting a small initial set of Turborepo tasks and opening one configuration pull request.

Read the current Vercel CI documentation before starting. Treat it as the source of truth for current product requirements, supported configuration syntax, and CLI behavior. If it is unavailable, continue with the bundled reference and note that current documentation could not be verified.

Read references/local-onboarding.md before starting. It contains the task-selection rules, commands, and recovery behavior.

Preconditions

1. Require a clean local Git checkout of the repository being onboarded. Never discard unrelated work.
2. Require authenticated git, GitHub CLI, and Vercel CLI access. Confirm that vercel api and vercel ci list are available from the installed CLI; otherwise stop with upgrade guidance.
3. Identify the Vercel team and either a project ID/name or GitHub owner/repo.
4. Resolve project input to its linked GitHub repository and ask the user to confirm the inferred owner/repo.
5. Require the local checkout's GitHub remote to match the confirmed repository.
6. Require a private GitHub repository linked to at least one project on the selected Vercel team.
7. Require a root turbo.json or turbo.jsonc and a declared turbo dependency. Stop if the repository does not use Turborepo.

Workflow