Skip to content

A platform for community discussion. Free, open, simple.

DEV: Update AGENTS.md linting guidance (#42121)

Alan Guo Xiang Tan2d387ee856fe
diff --git a/AI-AGENTS.md b/AI-AGENTS.md
index 69109690492..40f2df6591e 100644
--- a/AI-AGENTS.md
+++ b/AI-AGENTS.md
@@ -46,7 +46,10 @@ bin/lint --fix path/to/file path/to/another/file
bin/lint --fix --recent # Lint all recently changed files
```
-ALWAYS lint any changes you make with `bin/lint --fix`
+Run `bin/lint --fix` once after implementation is complete and before handing
+off completed changes, committing, or pushing. During iterative edits, only run
+lint when it helps diagnose an issue. Prefer passing the specific changed files;
+use `bin/lint --fix --recent` only when appropriate.
## Site Settings
- Configured in `config/site_settings.yml` or `config/settings.yml` for plugins