diff --git a/conductor/directives/tdd_red_green_required/meta.md b/conductor/directives/tdd_red_green_required/meta.md new file mode 100644 index 00000000..6c81df89 --- /dev/null +++ b/conductor/directives/tdd_red_green_required/meta.md @@ -0,0 +1,10 @@ +# tdd_red_green_required + +## v1 + +**Why this iteration:** Lifted verbatim from `conductor/workflow.md` §"Standard Task Workflow" steps 4-6 (lines 78-100). This is the baseline encoding — the numbered-step style currently in production. +Future variants will test alternative encodings (rationale-first, tabular) against this baseline. +**Source:** `conductor/workflow.md:78-100` + +--- +**Lifted:** 2026-07-02 (Phase 1 harvest by Tier 3 worker; user directive 2026-07-02 moved the header into this meta file) diff --git a/conductor/directives/tdd_red_green_required/v1.md b/conductor/directives/tdd_red_green_required/v1.md index ea625ed6..2d61f3b0 100644 --- a/conductor/directives/tdd_red_green_required/v1.md +++ b/conductor/directives/tdd_red_green_required/v1.md @@ -1,12 +1,3 @@ -# tdd_red_green_required — v1 - -**Why this iteration:** Lifted verbatim from `conductor/workflow.md` §"Standard Task Workflow" steps 4-6 (lines 78-100). This is the baseline encoding — the numbered-step style currently in production. -Future variants will test alternative encodings (rationale-first, tabular) against this baseline. - -**Source:** `conductor/workflow.md:78-100` - ---- - 4. **Write Failing Tests (Red Phase):** - **Pre-Delegation Checkpoint:** Before spawning a worker for dangerous or non-trivial changes, ensure your current progress is staged (`git add .`) or committed. This prevents losing iterations if a sub-agent incorrectly uses `git restore`. - **Zero-Assertion Ban:** You MUST NOT write tests that contain only `pass` or lack meaningful assertions. A test is only valid if it contains assertions that explicitly test the behavioral change and verify the failure condition. diff --git a/conductor/directives/test_sandbox/meta.md b/conductor/directives/test_sandbox/meta.md new file mode 100644 index 00000000..a88e2a1f --- /dev/null +++ b/conductor/directives/test_sandbox/meta.md @@ -0,0 +1,10 @@ +# test_sandbox + +## v1 + +**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/test_sandbox.md` §"The 4-Layer Model" + §"The `--config` CLI Flag" + §"The `--basetemp` Rule" (lines 5-58). This is the baseline encoding — the layered-table-plus-mechanism style currently in production. +Future variants will test alternative encodings (rule-only, before/after) against this baseline. +**Source:** `conductor/code_styleguides/test_sandbox.md:5-58` + +--- +**Lifted:** 2026-07-02 (Phase 1 harvest by Tier 3 worker; user directive 2026-07-02 moved the header into this meta file) diff --git a/conductor/directives/test_sandbox/v1.md b/conductor/directives/test_sandbox/v1.md index 67b8a86f..3719fa79 100644 --- a/conductor/directives/test_sandbox/v1.md +++ b/conductor/directives/test_sandbox/v1.md @@ -1,12 +1,3 @@ -# test_sandbox — v1 - -**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/test_sandbox.md` §"The 4-Layer Model" + §"The `--config` CLI Flag" + §"The `--basetemp` Rule" (lines 5-58). This is the baseline encoding — the layered-table-plus-mechanism style currently in production. -Future variants will test alternative encodings (rule-only, before/after) against this baseline. - -**Source:** `conductor/code_styleguides/test_sandbox.md:5-58` - ---- - ## The 4-Layer Model | Layer | Mechanism | Where | Default-on? | diff --git a/conductor/directives/type_hints_required/meta.md b/conductor/directives/type_hints_required/meta.md new file mode 100644 index 00000000..9e701e79 --- /dev/null +++ b/conductor/directives/type_hints_required/meta.md @@ -0,0 +1,10 @@ +# type_hints_required + +## v1 + +**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/python.md` §2 (lines 23-31) + `conductor/product-guidelines.md` §"AI-Optimized Compact Style" (line 58). 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:23-31 + product-guidelines.md:58` + +--- +**Lifted:** 2026-07-02 (Phase 1 harvest by Tier 3 worker; user directive 2026-07-02 moved the header into this meta file) diff --git a/conductor/directives/type_hints_required/v1.md b/conductor/directives/type_hints_required/v1.md index b6cf722c..83aa4473 100644 --- a/conductor/directives/type_hints_required/v1.md +++ b/conductor/directives/type_hints_required/v1.md @@ -1,12 +1,3 @@ -# type_hints_required — v1 - -**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/python.md` §2 (lines 23-31) + `conductor/product-guidelines.md` §"AI-Optimized Compact Style" (line 58). 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:23-31 + product-guidelines.md:58` - ---- - ## 2. Type Annotations - **All functions and methods** must have return type annotations. diff --git a/conductor/directives/typed_dataclass_fields/meta.md b/conductor/directives/typed_dataclass_fields/meta.md new file mode 100644 index 00000000..47a71a15 --- /dev/null +++ b/conductor/directives/typed_dataclass_fields/meta.md @@ -0,0 +1,11 @@ +# typed_dataclass_fields + +## v1 + +**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/data_oriented_design.md` §8.5 (lines 175-198). +This is the baseline encoding — the rationale-then-table style currently in production. +Future variants will test alternative encodings (rule-list, before/after only) against this baseline. +**Source:** `conductor/code_styleguides/data_oriented_design.md:175-198` + +--- +**Lifted:** 2026-07-02 (Phase 1 harvest by Tier 3 worker; user directive 2026-07-02 moved the header into this meta file) diff --git a/conductor/directives/typed_dataclass_fields/v1.md b/conductor/directives/typed_dataclass_fields/v1.md index 1eec611e..e2d60332 100644 --- a/conductor/directives/typed_dataclass_fields/v1.md +++ b/conductor/directives/typed_dataclass_fields/v1.md @@ -1,13 +1,3 @@ -# typed_dataclass_fields — v1 - -**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/data_oriented_design.md` §8.5 (lines 175-198). -This is the baseline encoding — the rationale-then-table style currently in production. -Future variants will test alternative encodings (rule-list, before/after only) against this baseline. - -**Source:** `conductor/code_styleguides/data_oriented_design.md:175-198` - ---- - ### 8.5 The Python Type Promotion Mandate (added 2026-06-25) **C11/Odin/Jai semantics in a Python runtime.** This codebase is written in Python because of practical constraints (time, dependencies, LLM codegen ability), but the convention is to make Python behave as close to a statically-typed value-typed language as the runtime allows. **LLMs default to opaque types (`dict[str, Any]`, `Any`, `Optional[T]`, `hasattr()` polymorphism) because that's what idiomatic Python training data looks like. That defaults to mediocrity; this rule overrides it.** diff --git a/conductor/directives/ui_delegation_for_hot_reload/meta.md b/conductor/directives/ui_delegation_for_hot_reload/meta.md new file mode 100644 index 00000000..fdbff41a --- /dev/null +++ b/conductor/directives/ui_delegation_for_hot_reload/meta.md @@ -0,0 +1,10 @@ +# ui_delegation_for_hot_reload + +## v1 + +**Why this iteration:** Lifted verbatim from `conductor/product-guidelines.md` §"Code Standards & Architecture" (line 41). This is the baseline encoding — the imperative-bullet-with-rationale style currently in production. +Future variants will test alternative encodings (rationale-first, before/after) against this baseline. +**Source:** `conductor/product-guidelines.md:41` + +--- +**Lifted:** 2026-07-02 (Phase 1 harvest by Tier 3 worker; user directive 2026-07-02 moved the header into this meta file) diff --git a/conductor/directives/ui_delegation_for_hot_reload/v1.md b/conductor/directives/ui_delegation_for_hot_reload/v1.md index 8d54acb7..189955b5 100644 --- a/conductor/directives/ui_delegation_for_hot_reload/v1.md +++ b/conductor/directives/ui_delegation_for_hot_reload/v1.md @@ -1,11 +1,2 @@ -# ui_delegation_for_hot_reload — v1 - -**Why this iteration:** Lifted verbatim from `conductor/product-guidelines.md` §"Code Standards & Architecture" (line 41). This is the baseline encoding — the imperative-bullet-with-rationale style currently in production. -Future variants will test alternative encodings (rationale-first, before/after) against this baseline. - -**Source:** `conductor/product-guidelines.md:41` - ---- - From `conductor/product-guidelines.md` §"Code Standards & Architecture": - **UI Delegation for Hot-Reload:** All complex ImGui rendering logic must be extracted from the `App` class into module-level functions named `render_xxx(app: App)`. The `App` class should only contain thin delegation wrappers (`def _render_xxx(self): render_xxx(self)`). This architecture is mandatory for supporting state-preserving hot-reloads of the UI logic. \ No newline at end of file diff --git a/conductor/directives/verbose_commit_message_ban/meta.md b/conductor/directives/verbose_commit_message_ban/meta.md new file mode 100644 index 00000000..b3eb9bfd --- /dev/null +++ b/conductor/directives/verbose_commit_message_ban/meta.md @@ -0,0 +1,10 @@ +# verbose_commit_message_ban + +## v1 + +**Why this iteration:** Lifted verbatim from `AGENTS.md` §"Process Anti-Patterns" #7 (lines 170-173). This is the baseline encoding — the symptom-rule-pair style currently in production. +Future variants will test alternative encodings (rule-only, tabular) against this baseline. +**Source:** `AGENTS.md:170-173` + +--- +**Lifted:** 2026-07-02 (Phase 1 harvest by Tier 3 worker; user directive 2026-07-02 moved the header into this meta file) diff --git a/conductor/directives/verbose_commit_message_ban/v1.md b/conductor/directives/verbose_commit_message_ban/v1.md index f3354a39..d7af3665 100644 --- a/conductor/directives/verbose_commit_message_ban/v1.md +++ b/conductor/directives/verbose_commit_message_ban/v1.md @@ -1,12 +1,3 @@ -# verbose_commit_message_ban — v1 - -**Why this iteration:** Lifted verbatim from `AGENTS.md` §"Process Anti-Patterns" #7 (lines 170-173). This is the baseline encoding — the symptom-rule-pair style currently in production. -Future variants will test alternative encodings (rule-only, tabular) against this baseline. - -**Source:** `AGENTS.md:170-173` - ---- - ### 7. The Verbose-Commit-Message Pattern (kill it) **Symptom:** Your commit message is 50 lines. It contains the root cause analysis, the alternatives you considered, the side effects you considered, the cross-references, the "what this doesn't fix", the "what to verify", and a personal essay. The commit message is longer than the diff it describes. diff --git a/conductor/directives/workspace_paths/meta.md b/conductor/directives/workspace_paths/meta.md new file mode 100644 index 00000000..e1ab57f3 --- /dev/null +++ b/conductor/directives/workspace_paths/meta.md @@ -0,0 +1,10 @@ +# workspace_paths + +## v1 + +**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/workspace_paths.md` (lines 1-103). This is the baseline encoding — the rule-plus-forbidden-patterns-plus-rationale-history style currently in production. +Future variants will test alternative encodings (rule-only, tabular) against this baseline. +**Source:** `conductor/code_styleguides/workspace_paths.md:1-103` + +--- +**Lifted:** 2026-07-02 (Phase 1 harvest by Tier 3 worker; user directive 2026-07-02 moved the header into this meta file) diff --git a/conductor/directives/workspace_paths/v1.md b/conductor/directives/workspace_paths/v1.md index d940bd50..f49c578f 100644 --- a/conductor/directives/workspace_paths/v1.md +++ b/conductor/directives/workspace_paths/v1.md @@ -1,12 +1,3 @@ -# workspace_paths — v1 - -**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/workspace_paths.md` (lines 1-103). This is the baseline encoding — the rule-plus-forbidden-patterns-plus-rationale-history style currently in production. -Future variants will test alternative encodings (rule-only, tabular) against this baseline. - -**Source:** `conductor/code_styleguides/workspace_paths.md:1-103` - ---- - # Test Workspace Paths — Hard Rule ## TL;DR