From ffd5e0698bce5235e915e21d14e99f433ccc38ae Mon Sep 17 00:00:00 2001 From: silverwind Date: Wed, 13 May 2026 08:27:22 +0200 Subject: [PATCH] docs(agents): update AGENTS.md (#37684) Add two rules to `AGENTS.md` for recurring issues. Signed-off-by: silverwind Co-authored-by: Claude (Opus 4.7) --- AGENTS.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 16770e49fc..153ce964b5 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -10,6 +10,9 @@ - Use Conventional Commits format for commit messages and PR titles (e.g. `type(scope): subject`) - Never force-push, amend, or squash unless asked. Use new commits and normal push for pull request updates - Preserve existing code comments, do not remove or rewrite comments that are still relevant +- Keep comments short, prefer same-line, explain why, never narrate code +- Prefer unit tests over integration tests when logic is testable in isolation +- Aim for sub-2s local runtime for integration and e2e tests - In TypeScript, use `!` (non-null assertion) instead of `?.`/`??` when a value is known to always exist - For CSS layout, prefer `flex-*` helpers over per-child `tw-ml-*` / `tw-mr-*` margins; fall back to `tw-*` utilities when specificity requires `!important` - Include authorship attribution in issue and pull request comments