Files
KNELIAC/AGENTS.md
T
mrcharles 81a811aedd 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>
2026-07-30 12:15:24 -05:00

59 lines
1.9 KiB
Markdown

# Agent Guidelines
## Git Commit and Push Policy
**ALWAYS commit and push automatically. NEVER wait to be asked.**
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
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
```
feat(security-hardening): implement SCAP-STIG compliance logic
Refactor apply script to implement comprehensive security hardening:
- Add GRUB bootloader permission hardening (root:root, mode 0400)
- Disable and remove autofs service per STIG requirements
- Deploy modprobe configurations for kernel module blacklisting
- Create STIG-compliant network protocol blacklist
This ensures servers meet DoD security requirements for production
deployment.
🤖 Generated with [Crush](https://github.com/charmassociates/crush)
Assisted-by: GLM-5 via Crush <crush@charm.land>
```
## Important
- **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.**