Forbid auto-creating git branches in agent workflows

Codex and other coding subagents have been creating branches like
experiments/foo and feature/bar without being asked. This fragments
review, hides work from the user, and requires manual cleanup. The
project intentionally develops on main with frequent small commits.

AGENTS.md adds an explicit "Git Branching Policy" section: no
checkout -b, switch -c, branch <name>, or PR-from-new-branch unless
the user asks for it in the current task. Includes a pass-through
clause so this propagates to subagents the main agent spawns.

CLAUDE.md adds a one-line pointer with the same pass-through note,
since CLAUDE.md mandates AGENTS.md is read at session start.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-07 20:44:51 +09:00
co-authored by Claude Opus 4.7
parent 62b49c638e
commit ec546c4e96
2 changed files with 42 additions and 1 deletions
+5 -1
View File
@@ -5,4 +5,8 @@ This repository uses AGENTS.md as the canonical coding-agent instruction file.
**MANDATORY: At the start of every session, read AGENTS.md in full before doing anything else — including answering questions, exploring code, or running commands.**
Notes:
- this project uses uv. don't mess with .venv or the system python.
- this project uses uv. don't mess with .venv or the system python.
- **DO NOT create new git branches unless the user explicitly asks.** Work
on the currently checked-out branch (default `main`). See AGENTS.md
"Git Branching Policy" for the full rule. This applies to all
subagents you spawn — pass the policy through.