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,23 @@
+# one_space_indent — v1
+
+**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/python.md` §1 (lines 7-12) + `conductor/workflow.md` §"Code Style" line 7. This is the baseline encoding — the imperative-bullet style currently in production.
+Future variants will test alternative encodings (rationale-first, tabular) against this baseline.
+
+**Source:** `conductor/code_styleguides/python.md:7-12 + workflow.md:7`
+
+---
+
+## 1. Indentation and Whitespace
+
+- **Indentation:** 1 space per level. No tabs.
+- **Continuation lines:** 1 space relative to the opening construct.
+- **Blank lines:** Zero blank lines between function/method definitions within a class. One blank line between top-level definitions only when separating logically distinct sections.
+- **Trailing whitespace:** None.
+- **Rationale:** 1-space indentation reduces token count by ~40% compared to 4-space on deeply nested GUI code, with no loss of structural clarity for AST-based tools.
+
+---
+
+From `conductor/workflow.md` "Code Style":
+- **1-space indentation** for ALL Python code (NO EXCEPTIONS)
+- **CRLF line endings** on Windows
+- **NO COMMENTS** unless explicitly requested