DocumentationWorking with Git

Working with Git

BuildStax works best when Git remains the review boundary: inspect before editing, keep the diff narrow, verify it, and commit only the intended files.

03 sections6 min readUpdated for preview
On this page
  1. 01Start from a known state
  2. 02Review by file and behavior
  3. 03Keep normal protections
01

Start from a known state

You do not need a clean working tree, but you do need to know what is already modified. Existing changes may belong to another task or teammate.

Command
git status --short
git diff --stat
02

Review by file and behavior

Read the final diff instead of relying on the conversation. Confirm that every touched file supports the requested behavior and that generated files are expected.

Command
git diff --check
git diff -- path/to/file
03

Keep normal protections

Branch protection, required checks, and human review should apply to agent-authored changes exactly as they apply to human-authored changes.