From eae36087320a88c804bb6ff87650861303782517 Mon Sep 17 00:00:00 2001 From: Trish Whetzel Date: Wed, 17 Sep 2025 14:17:13 -0700 Subject: [PATCH 1/2] Update set-up-github-actions.md Add section for branch protection rules --- docs/how-tos/set-up-github-actions.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/how-tos/set-up-github-actions.md b/docs/how-tos/set-up-github-actions.md index 41d8147..9987e87 100644 --- a/docs/how-tos/set-up-github-actions.md +++ b/docs/how-tos/set-up-github-actions.md @@ -7,6 +7,12 @@ It also assumes you have some familiarity with GitHub actions, and have basic QC actions set up. If you are managing an ODK-compliant repo this is certainly the case. +# IMPORTANT - GitHub repo configuration +When using AI agents, ensure that your `main` repository branch has [GitHub branch protection rules](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) enabled. Specifically, the `main` branch should have at least these settings configured: +- Require pull request reviews before merging +- Require at least one PR reviewer to approve the PR +- Do not allow bypassing the above settings + ## Quick setup with Claude Code If you have [Claude Code](../reference/clients/claude-code.md) installed, you can use the `install-github-app` command for a streamlined setup process. This command will authenticate you and create a pull request with GitHub Actions configuration: From 05387d2f314dc148bac50f427795b9ad41c80603 Mon Sep 17 00:00:00 2001 From: Chris Mungall Date: Wed, 22 Oct 2025 08:43:10 -0700 Subject: [PATCH 2/2] Update docs/how-tos/set-up-github-actions.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- docs/how-tos/set-up-github-actions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/how-tos/set-up-github-actions.md b/docs/how-tos/set-up-github-actions.md index 9987e87..d6966dc 100644 --- a/docs/how-tos/set-up-github-actions.md +++ b/docs/how-tos/set-up-github-actions.md @@ -7,7 +7,7 @@ It also assumes you have some familiarity with GitHub actions, and have basic QC actions set up. If you are managing an ODK-compliant repo this is certainly the case. -# IMPORTANT - GitHub repo configuration +## IMPORTANT - GitHub repo configuration When using AI agents, ensure that your `main` repository branch has [GitHub branch protection rules](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) enabled. Specifically, the `main` branch should have at least these settings configured: - Require pull request reviews before merging - Require at least one PR reviewer to approve the PR