Conventions with BUHG.md

Why a config file

A terminal-first agent workflow is only safe when your conventions are explicit. BUHG.md is a plain-text file in your repository that the agent reads before it touches code, so its branches and pull requests look like your team wrote them.

A minimal BUHG.md

# BUHG.md
Branch format:  fix/bug-{number}-{slug}
PR target:      main
Rules:
  - Run the test suite before opening a PR
  - Keep each change scoped to a single bug
  - Squash-merge only

Multi-repo workspaces

For products that span several repositories, a workspace map tells Buhg which codebase a bug belongs to, so a report about one service does not land a branch in another.