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:
@@ -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 <crush@charm.land>
|
||||
|
||||
## 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.**
|
||||
|
||||
Reference in New Issue
Block a user