Create Your Repository

You create your workspace by copying the template into a repository you own. There are two paths. Pick the one that matches where your team stores code.

• Path A — GitHub (recommended): You get your own private copy in two clicks, with no remote setup.
• Path B — Other platforms (GitLab, Bitbucket, self-hosted): You clone the template manually, then push it to your own repository. A few extra steps, but works anywhere.

Path A: GitHub Template

Step 1 — Create your repository from the template

1. On the template repository page, click Use this template.
2. On the next screen:
   • Owner: choose your GitHub account or organization.
   • Repository name: use a name like act-playbook-your-company (replace your-company).
   • Visibility: select Private.
3. Click Create repository.

GitHub creates a fresh private copy of the template under your account.

Step 2 — Clone your new repository

Clone the repository to your computer. Replace YOUR-ORG and YOUR-REPO with the values you chose in Step 1:

git clone https://github.com/YOUR-ORG/YOUR-REPO.git act-playbook
cd act-playbook

If GitHub asks you to sign in, use your GitHub account. If it asks for a password, use a GitHub personal access token instead of your normal password.

You are done with setup. Continue to Install Skills.

Path B: Manual Setup for Other Platforms

Use this path if your team stores code on GitLab, Bitbucket, a self-hosted server, or any platform other than GitHub.

Step 1 — Clone the template

git clone https://github.com/act-playbook/act-playbook-template.git act-playbook
cd act-playbook

Step 2 — Create an empty repository on your platform

On your platform (GitLab, Bitbucket, and so on), create a new private repository named act-playbook.

Create it empty. Do not add a README, license, or .gitignore when creating it.

Your platform will show you a repository URL, for example:

https://gitlab.com/YOUR-ORG/act-playbook.git

Step 3 — Point this workspace to your repository

The clone currently points to the template as origin. Rename that remote to template, then add your own repository as origin:

git remote rename origin template
git remote add origin https://YOUR-PLATFORM/YOUR-ORG/act-playbook.git
git push -u origin main

Replace the URL with the one from your platform.

Verify the remotes look right:

git remote -v

You should see:

• origin pointing to your private team repository
• template pointing to the original ACT Playbook template

Pull template updates later

Because the original template is saved as the template remote, you can pull future updates whenever you want them:

git fetch template
git merge template/main

If there are conflicts, resolve them, then commit the merge.