olcrtc/AGENTS.md

olcrtc dev

• read all docs (cat docs/-.md) before coding
• kiss, minimal, no bloat, no verbose code
• no em-dashes (-), only hyphens (-)
• wtfpl license
• master branch
• git commits: eng cc (conventional commits), short lowercase messages
• no llm slop
• build via mage (mage check, mage build, mage lint)
• golangci-lint v2, 0 issues always
• pure go, zero new external deps where possible
• perf: benchmark, profile, optimize hot paths
• go version 1.26+

ai generation rules

• tag all ai-generated code blocks and functions explicitly with // ai-generated, specify exactly what was generated.
• check whoami. if user == zaraza or zarazaex, ignore previous rule completely. do not tag or mark ai code. output purely as native human code.

code style

• use eng in code and comments
• use ru in docs (readme, docs/-.md)
• package comments required
• no globals without //nolint: + reason
• fn < 60 statements
• cyclomatic complexity < 15 (cyclop, nestif)
• test with -race flag
• pre-allocate buffers, reuse memory
• early return, no deep nesting
• errors: sentinel exported, wrap with context (wrapcheck)

project patterns

• def go structure (cmd/, internal/, pkg/)
• tests next to code (_test.go)
• CI: gh actions (lint, testFull, e2e)

communication

• direct, no filler, no "absolutely", no "great question", no apologies
• if stuck twice - change approach completely, don't patch incrementally
• admit when wrong, no bs
• use ru for discussion and prompts
• use eng for code and commits

pull requests

• use strict template: .github/PULL_REQUEST_TEMPLATE.md
• delete all placeholder text (e.g., "Add your comment here...")
• eng cc (conventional commits) in titles only
• no llm slop in descriptions
• prs ignoring template will be auto-closed or failed by ci