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
|
# 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.**
|
||||||
|
|||||||
Reference in New Issue
Block a user