AGENTS.md · diff
git:20260419.4b1859e to git:20260419.66fc11a
7 added, 7 removed. Audit A to A.
What this update changes in the checks
No check changed: every fixed check gives the same answer before and after this update.
A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.
- # Agent Instructions — humanizer repo
+ # Agent Instructions — unslop repo
- Drop AI-isms. Keep the technical substance exact. Eat our own dog food: every doc, comment, and reply we ship in this repo follows the humanizer rules.
+ Drop AI-isms. Keep the technical substance exact. Eat our own dog food: every doc, comment, and reply we ship in this repo follows the unslop rules.
## Workflow
1. Read [`CLAUDE.md`](./CLAUDE.md) for the full maintainer guide.
2. Edit only the SSOT files. Mirrors are auto-generated by CI.
- 3. Run `python3 -m pytest tests/humanizer-humanize/` after any change to the Python package.
- 4. Run `bash hooks/install.sh` after editing any hook script and verify the `.humanizer-active` flag updates correctly with `/humanizer full` and `stop humanizer`.
+ 3. Run `python3 -m pytest tests/unslop/` after any change to the Python package.
+ 4. Run `bash hooks/install.sh` after editing any hook script and verify the `.unslop-active` flag updates correctly with `/unslop full` and `stop unslop`.
## Tone
- No "Great question!" openers. No "I'd be happy to help."
- No "delve", "tapestry", "testament", "leverage" (as filler), "robust" (as filler), "seamless", "holistic", "comprehensive" (as filler).
- No "It's important to note that". No "Generally speaking". No "In essence".
- No five-paragraph essay shape in commit messages or PR descriptions.
- Burstiness: short. Then one longer sentence that develops the point. Short again.
- Real uncertainty is fine ("I think", "probably") when honest. Performative softening isn't.
## Commits
- Use `humanizer-commit` style (Conventional Commits, body only when "why" isn't obvious from subject). See `skills/humanizer-commit/SKILL.md`.
+ Use `unslop-commit` style (Conventional Commits, body only when "why" isn't obvious from subject). See `skills/unslop-commit/SKILL.md`.
## Reviews
- Use `humanizer-review` style (file:line, severity prefix, observation, fix). See `skills/humanizer-review/SKILL.md`.
+ Use `unslop-review` style (file:line, severity prefix, observation, fix). See `skills/unslop-review/SKILL.md`.
## Tests are the contract
- The `TestPreservation` suite enforces that humanization never modifies code, URLs, or headings. Don't disable it. If a test fails, the humanizer is wrong, not the test.
+ The `TestPreservation` suite enforces that humanization never modifies code, URLs, or headings. Don't disable it. If a test fails, the unslop is wrong, not the test.
## Relationship to CLAUDE.md
This file is the short cross-IDE companion to `CLAUDE.md`. Keep the two aligned on policy; if one changes significantly, update the other in the same PR.