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>
12 lines
596 B
Markdown
12 lines
596 B
Markdown
# CLAUDE.md
|
|
|
|
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.
|
|
- **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. |