Private
Public Access
0
0

refactor(directives): strip metadata header from v1.md (45-51 of 51; meta extracted to meta.md)

This commit is contained in:
2026-07-02 23:47:20 -04:00
parent 5b0f932c4b
commit 559db09ce4
14 changed files with 71 additions and 64 deletions
@@ -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)
@@ -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.
+10
View File
@@ -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)
-9
View File
@@ -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? |
@@ -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)
@@ -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.
@@ -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)
@@ -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.**
@@ -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)
@@ -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.
@@ -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)
@@ -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.
@@ -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)
@@ -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