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.**