Minimal policy¶

This policy manages one explicit merge setting for every repository selected under the owner. Everything else remains unmanaged.

Configuration¶

octoform.yml

# The smallest configuration that does something: one policy, applied to
# every repository the owner has, nothing else managed.
#
# `org-name` is a placeholder, not a real account — replace it with your own
# organisation or personal account before running this:
#   export GITHUB_TOKEN=...
#   octoform plan --config octoform.yml

owner: org-name

defaults:
  merge:
    delete_branch_on_merge: true

Download YAML

Adapt and review¶

Replace org-name with an organization or personal account the token can inspect.
Run octoform plan --config octoform.yml.
Confirm that every listed repository should delete its source branch after a pull request is merged.

Omitting another setting does not reset it. Octoform manages only merge.delete_branch_on_merge in this example.

Expected plan¶

Repositories already configured with automatic branch deletion produce no change. Other selected repositories produce one proposed update. If Octoform cannot read the current setting or prove the mutation is available, it reports a blocked operation instead of guessing.