From 81a811aeddf3f6d5d7578acc3f97a60f3c08c208 Mon Sep 17 00:00:00 2001 From: reachableceo Date: Thu, 30 Jul 2026 12:15:24 -0500 Subject: [PATCH] docs: update AGENTS.md with auto-commit and push policy MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Make explicit that agents must commit and push automatically after every logical unit of work — never wait to be asked. 🤖 Generated with [Crush](https://github.com/charmassociates/crush) Assisted-by: GLM-5 via Crush --- AGENTS.md | 35 ++++++++++++++++++++++++----------- 1 file changed, 24 insertions(+), 11 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 219ff49..c494cfa 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,23 +1,34 @@ # Agent Guidelines -## Git Commit Requirements +## Git Commit and Push Policy -When making changes to this repository, ALWAYS: +**ALWAYS commit and push automatically. NEVER wait to be asked.** -1. **Commit atomically**: Each logical change should be its own commit +After completing each logical unit of work, immediately: +1. Stage the relevant files +2. Commit with a well-formed message (see below) +3. Push to `origin/main` + +Do NOT batch multiple unrelated changes into one commit. Do NOT leave work +uncommitted at the end of a task. + +## Commit Rules + +1. **Commit atomically**: Each logical change is its own commit. 2. **Use conventional commit format**: - - `feat(scope): description` - New feature - - `fix(scope): description` - Bug fix - - `docs: description` - Documentation changes - - `refactor(scope): description` - Code refactoring - - `test(scope): description` - Test additions/changes - - `chore: description` - Maintenance tasks + - `feat(scope): description` — New feature + - `fix(scope): description` — Bug fix + - `docs: description` — Documentation changes + - `refactor(scope): description` — Code refactoring + - `test(scope): description` — Test additions/changes + - `chore: description` — Maintenance tasks 3. **Write verbose, beautifully formatted messages**: - Title line (50 chars max) - Blank line - Body explaining WHAT and WHY (not how) - Reference related files/issues - Include footer with attribution +4. **Push after every commit** — do not accumulate local commits. ## Example Commit @@ -41,5 +52,7 @@ Assisted-by: GLM-5 via Crush ## Important -**NEVER wait to be asked to commit and push your work.** -**Commit immediately after each logical unit of work.** +- **NEVER wait to be asked to commit and push.** +- **Commit immediately after each logical unit of work.** +- **Push after every commit.** +- **Prefer many small, focused commits over fewer large ones.**