SilverElixir commited on
Commit
d1a24ba
·
1 Parent(s): 5f80ef1

AGENTS.md: comment style rules (Russian, short, why-only)

Browse files
Files changed (1) hide show
  1. AGENTS.md +8 -0
AGENTS.md CHANGED
@@ -37,6 +37,14 @@
37
  - Comments explain why, not what. Keep the dated evidence comments that prevent regressions, but keep them short and move long write-ups to docs/.
38
  - No filler prose, emojis, or heavy dash use in code, comments, or docs.
39
 
 
 
 
 
 
 
 
 
40
  ## Docs lookup
41
  - When you need current library docs (aiogram, FastAPI, google-genai, Deno) rather than memory, use the `context7` MCP tools.
42
 
 
37
  - Comments explain why, not what. Keep the dated evidence comments that prevent regressions, but keep them short and move long write-ups to docs/.
38
  - No filler prose, emojis, or heavy dash use in code, comments, or docs.
39
 
40
+ ## Comments (Russian, short, why-only)
41
+ - Russian only, except structural headers containing identifiers/commands.
42
+ - Explain why (reason, incident date, tradeoff), max 2-3 lines. Never restate what the code does.
43
+ - Dated evidence tags stay short: (prod 17.09.2026: ...), (audit 26.09.2026), (review 27.09.2026).
44
+ - Banned: code paraphrase, filler ("Важно", "Здесь мы", "Следует отметить"), emojis, commented-out code.
45
+ - Add a comment only where non-obvious: magic numbers, regexes, workarounds, ordering constraints, counterintuitive behavior.
46
+ - Module docstring: one line saying what the module does. No extraction history ("вынесено из bot.py").
47
+
48
  ## Docs lookup
49
  - When you need current library docs (aiogram, FastAPI, google-genai, Deno) rather than memory, use the `context7` MCP tools.
50