Private
Public Access
refactor(directives): strip metadata header from v1.md (45-51 of 51; meta extracted to meta.md)
This commit is contained in:
@@ -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):**
|
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`.
|
- **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.
|
- **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.
|
||||||
|
|||||||
@@ -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)
|
||||||
@@ -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
|
## The 4-Layer Model
|
||||||
|
|
||||||
| Layer | Mechanism | Where | Default-on? |
|
| 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
|
## 2. Type Annotations
|
||||||
|
|
||||||
- **All functions and methods** must have return 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)
|
### 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.**
|
**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":
|
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.
|
- **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)
|
### 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.
|
**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
|
# Test Workspace Paths — Hard Rule
|
||||||
|
|
||||||
## TL;DR
|
## TL;DR
|
||||||
|
|||||||
Reference in New Issue
Block a user