Skip to content

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.

  • 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

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

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.