DocumentationRepo grounding

Repo grounding

The repository is the source of truth. BuildStax gathers local structure, instructions, symbols, scripts, and working-tree state before deciding what to change.

03 sections6 min readUpdated for preview
On this page
  1. 01The working directory is the boundary
  2. 02Context narrows the edit
  3. 03Existing work stays visible
01

The working directory is the boundary

Run from the target repository or pass --cwd. Grounding and session lookup use that directory, so selecting the correct root is the first safety decision.

02

Context narrows the edit

BuildStax searches for relevant files and established patterns before writing. It gathers the smallest context that supports a correct change instead of loading the entire repository into a prompt.

03

Existing work stays visible

Check the working tree before a task and review it afterward. Unrelated modifications should remain untouched and should not be folded into the generated change.

Command
git status --short
buildstax "inspect the failing test before proposing a fix"
git diff --stat