How Claude Handles Git

You never run a git command during a Stadium 8 session. Claude handles everything from the first branch to the final merge.

What Claude Does Automatically

• Creates a branch for each epic before implementation starts

• Commits after each story's tests pass

• Tags the branch after your browser verification sign-off

• Opens a PR to main

• Merges to main after all quality gates pass

Commit Naming

Planning commits follow a docs(...) format:

• Project brief: docs(intake): project brief

• Epic list: docs(plan): epic list approved

• Stories: docs(plan): stories for epic 1 — auth

Story commits use a feature format:

• Story: feat(epic-1-story-2): add login form validation

Post-QA fixes (if any): committed before the epic is tagged

Epic tag: <epic-id>-done, applied after browser verification sign-off

PR Merge Strategy

PRs merge using a merge commit (not squash). This preserves the per-story commit history on main.

You can trace exactly when each story was completed and what changed.