Setting Up Your Project

Each Stadium 8 application lives in its own GitHub repository, separate from your backend and other projects. This keeps the workflow’s commits, branches and quality gates isolated from everything else.

Create your repository

1. Go to the Stadium 8 template on GitHub.

2. Click Use this template, then Create a new repository.

3. Enter a name, choose who can see it, and click Create repository.

4. Clone your new repository:

   git clone <your-repo-url>

5. Open the project folder in VS Code with the Claude Code extension, or run claude in the project folder.

You don’t need to install anything else. When you run /start, Claude installs the dependencies in the background while you answer its first questions.

Check your repository settings

Two GitHub settings matter. Both are on by default, so check them only if your organisation changes defaults:

Setting	Why it matters
GitHub Actions enabled	The quality gates run on Actions.
Merge commits allowed	Claude merges each epic with a merge commit. A squash-only repository makes the merge fail.

What’s in the project

project-root/
├── documentation/    # Your materials: specs, designs, API schema, sample data
├── web/              # The application Claude builds
└── generated-docs/   # The workflow's records, created as you build

template-version.json at the top of the project records which template version you’re on.

Staying up to date

The template behind your project keeps improving. To be told about new versions, open the template repository and click Watch, then Custom, then Releases. When a new version ships, type /upgrade in Claude Code to bring your project up to date. See Upgrading Your Project.

Don’t add anything to documentation/ yet. That comes in the next step.