GitHub
AvailableGit Provider
Decisions versioned alongside code.
Arbtr's GitHub integration exports your architectural decisions as ADR (Architecture Decision Record) files directly to your repository. Decisions live where developers work—in the same repo as the code they govern. One-way sync means Arbtr is the editor; Git is the archive.
Key Features
One-Way Sync
Decisions in Arbtr are automatically exported to your GitHub repository as Markdown ADR files.
ADR Format
Exports follow the standard ADR format with title, status, context, decision, and consequences.
Configurable Path
Choose where ADRs are stored in your repo. Default is docs/adr/ but fully customizable.
Branch Selection
Sync to main, develop, or any branch you choose. Perfect for review workflows.
Automatic Updates
When decisions change in Arbtr, the corresponding ADR file is automatically updated.
Commit Messages
Clear, automated commit messages link back to the decision in Arbtr for full traceability.
Quick Setup
Get up and running in minutes.
Connect your GitHub account
Authorize Arbtr to access your repositories. We request minimal permissions—just repo write access.
Select a repository
Choose which repository should receive your ADR files. You can connect multiple repos to different teams.
Configure sync settings
Set the target branch, file path, and sync frequency. Decisions sync automatically or on-demand.