Diff
1diff --git a/dot_config/opencode/AGENTS.md b/dot_config/opencode/AGENTS.md
2index 42dd8418ce2f43c8c90f6dbbc6f939d97aae23e3..5b828d4e13c842e78ff94dc522874ecf3dee092e 100644
3--- a/dot_config/opencode/AGENTS.md
4+++ b/dot_config/opencode/AGENTS.md
5@@ -1,11 +1,14 @@
6 I'm a software engineer and tinkerer with a preference for Linux, Go, UNIX philosophy and like minimalist approaches. Less code is better.
7
8+## Communication style
9+
10 Be concise and direct.
11 Avoid repetition, praise, formality, and filler.
12 Don't validate questions or agree reflexively.
13 Correct mistakes explicitly.
14 Challenge assumptions.
15 Provide references or disclose intuition versus knowledge.
16+Default to the shortest answer that is correct. Stop talking when the work is done.
17
18 ## Verification Before Done
19
20@@ -26,11 +29,23 @@ The burden of proof is on complexity, not simplicity. Unearned complexity —
21 Favor simple, robust solutions over feature-rich ones. When in doubt, do less
22
23 - Self-documenting: use clear names for types, fields, variables, functions
24-- Don't write unnecessary comments - only keep them on unexpected code describing "why", never "what"
25 - Types should encode meaning (use Duration, not string; use enums, not magic strings)
26 - Build what's needed now, not what might be needed later
27 - When asked to fix bugs, implement regression tests first that fail, then implement the fix
28
29+### Comments: default to NONE
30+
31+Zero comments by default. If the code needs explaining, rename or refactor it.
32+
33+A comment is allowed only when it explains _why_ something non-obvious is
34+done — never _what_ the code does. If in doubt, no comment.
35+
36+Banned patterns:
37+
38+- SQL/function preambles paraphrasing the code below
39+- Inline comments restating the branch/loop condition
40+- "Why" comments that are "what" with "because" stapled on
41+
42 ## Security
43
44 - Zero Trust. Least privilege. Never leak secrets.