docs: update AGENTS.md with auto-commit and push policy

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 <crush@charm.land>
This commit is contained in:
2026-07-30 12:15:24 -05:00
parent ee0b181463
commit 81a811aedd
+24 -11
View File
@@ -1,23 +1,34 @@
# Agent Guidelines # 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**: 2. **Use conventional commit format**:
- `feat(scope): description` - New feature - `feat(scope): description` New feature
- `fix(scope): description` - Bug fix - `fix(scope): description` Bug fix
- `docs: description` - Documentation changes - `docs: description` Documentation changes
- `refactor(scope): description` - Code refactoring - `refactor(scope): description` Code refactoring
- `test(scope): description` - Test additions/changes - `test(scope): description` Test additions/changes
- `chore: description` - Maintenance tasks - `chore: description` Maintenance tasks
3. **Write verbose, beautifully formatted messages**: 3. **Write verbose, beautifully formatted messages**:
- Title line (50 chars max) - Title line (50 chars max)
- Blank line - Blank line
- Body explaining WHAT and WHY (not how) - Body explaining WHAT and WHY (not how)
- Reference related files/issues - Reference related files/issues
- Include footer with attribution - Include footer with attribution
4. **Push after every commit** — do not accumulate local commits.
## Example Commit ## Example Commit
@@ -41,5 +52,7 @@ Assisted-by: GLM-5 via Crush <crush@charm.land>
## Important ## Important
**NEVER wait to be asked to commit and push your work.** - **NEVER wait to be asked to commit and push.**
**Commit immediately after each logical unit of work.** - **Commit immediately after each logical unit of work.**
- **Push after every commit.**
- **Prefer many small, focused commits over fewer large ones.**