Trunk-First Repo

Initialize a folder as a git repository following scaled trunk-based development. The core principle: main is sacred — it starts empty and content only enters through peer-reviewed pull requests from short-lived feature branches.

This matters because it prevents accidental pushes to main, establishes a clean PR-based workflow from day one, and makes the git history meaningful by design rather than as an afterthought.

Workflow

Step 0: Select Mode

If the user says push remote, do not initialize the repository again. Use the Push Remote Workflow below.

Otherwise, use the Initialize Workflow.

Initialize Workflow

Step 1: Collect Parameters