Spaces:
Running
Running
SilverElixir commited on
Commit ·
d1a24ba
1
Parent(s): 5f80ef1
AGENTS.md: comment style rules (Russian, short, why-only)
Browse files
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 |
|