feat(directives): harvest 5 code style directives from python.md + workflow.md + product-guidelines.md + AGENTS.md

2026-07-02 22:00:37 -04:00
parent a3e587280e
commit b5baaaaab7
5 changed files with 102 additions and 0 deletions
@@ -0,0 +1,16 @@
+# no_comments_in_body — v1
+
+**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/python.md` §8 (lines 64-71) + `AGENTS.md` "Critical Anti-Patterns" (line 54). This is the baseline encoding — the imperative-bullet style currently in production.
+Future variants will test alternative encodings (rationale-first, before/after) against this baseline.
+
+**Source:** `conductor/code_styleguides/python.md:64-71 + AGENTS.md:54`
+
+---
+
+From `conductor/code_styleguides/python.md` §8 "AI-Agent Specific Conventions":
+- **No redundant comments.** Do not add comments that restate what the code does. Only comment on *why* when non-obvious.
+
+---
+
+From `AGENTS.md` "Critical Anti-Patterns":
+- Do not add comments to source code; documentation lives in `/docs`