Private
Public Access
refactor(directives): strip metadata header from v1.md (18-26 of 51; meta extracted to meta.md)
This commit is contained in:
@@ -0,0 +1,10 @@
|
||||
# config_state_owner
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/config_state_owner.md` (entire file, lines 1-82). This is the baseline encoding — the rule-plus-allowed/forbidden-lists style currently in production.
|
||||
Future variants will test alternative encodings (rule-only, before/after) against this baseline.
|
||||
**Source:** `conductor/code_styleguides/config_state_owner.md:1-82`
|
||||
|
||||
---
|
||||
**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 @@
|
||||
# config_state_owner — v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/config_state_owner.md` (entire file, lines 1-82). This is the baseline encoding — the rule-plus-allowed/forbidden-lists style currently in production.
|
||||
Future variants will test alternative encodings (rule-only, before/after) against this baseline.
|
||||
|
||||
**Source:** `conductor/code_styleguides/config_state_owner.md:1-82`
|
||||
|
||||
---
|
||||
|
||||
# Config I/O State Ownership
|
||||
|
||||
**Rule:** The `AppController` is the single source of truth for the
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
# deduction_loop_limit
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` §"Process Anti-Patterns" #1 (lines 119-125). 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:119-125`
|
||||
|
||||
---
|
||||
**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 @@
|
||||
# deduction_loop_limit — v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` §"Process Anti-Patterns" #1 (lines 119-125). 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:119-125`
|
||||
|
||||
---
|
||||
|
||||
### 1. The Deduction Loop (kill it)
|
||||
|
||||
**Symptom:** Run test → fail → read log → form hypothesis → run again → fail differently → add diag → run again → fail again → loop. You end up running the same test 4+ times in one session, each run reading partial log output.
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
# feature_flag_delete_to_turn_off
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/feature_flags.md` §"0. The two patterns (the one-glance table)" (lines 13-21) + §1 + §2 + §3 (lines 22-143). This is the baseline encoding — the one-glance-table-plus-rationale style currently in production.
|
||||
Future variants will test alternative encodings (rule-only, decision-tree) against this baseline.
|
||||
**Source:** `conductor/code_styleguides/feature_flags.md:13-143`
|
||||
|
||||
---
|
||||
**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 @@
|
||||
# feature_flag_delete_to_turn_off — v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/feature_flags.md` §"0. The two patterns (the one-glance table)" (lines 13-21) + §1 + §2 + §3 (lines 22-143). This is the baseline encoding — the one-glance-table-plus-rationale style currently in production.
|
||||
Future variants will test alternative encodings (rule-only, decision-tree) against this baseline.
|
||||
|
||||
**Source:** `conductor/code_styleguides/feature_flags.md:13-143`
|
||||
|
||||
---
|
||||
|
||||
## 0. The two patterns (the one-glance table)
|
||||
|
||||
| Pattern | How it works | How to turn off | How to turn on |
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
# file_naming_convention
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` "File Size and Naming Convention (HARD RULE — added 2026-06-11)" (lines 62-69) + `conductor/workflow.md` §"Guiding Principles" #8 (line 45). This is the baseline encoding — the rationale-bullet style currently in production.
|
||||
Future variants will test alternative encodings (tabular, before/after) against this baseline.
|
||||
**Source:** `AGENTS.md:62-69 + workflow.md:45`
|
||||
|
||||
---
|
||||
**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 @@
|
||||
# file_naming_convention — v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` "File Size and Naming Convention (HARD RULE — added 2026-06-11)" (lines 62-69) + `conductor/workflow.md` §"Guiding Principles" #8 (line 45). This is the baseline encoding — the rationale-bullet style currently in production.
|
||||
Future variants will test alternative encodings (tabular, before/after) against this baseline.
|
||||
|
||||
**Source:** `AGENTS.md:62-69 + workflow.md:45`
|
||||
|
||||
---
|
||||
|
||||
## File Size and Naming Convention (HARD RULE — added 2026-06-11)
|
||||
|
||||
**The "small files are good, large files are bad" stance is propaganda from LLM training data. It is wrong for this project. Reject it.**
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
# git_hard_bans
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` "Critical Anti-Patterns" HARD BAN lines (59-60) + `conductor/workflow.md` §"Known Pitfalls" (lines 417-430). This is the baseline encoding — the imperative-bullet-with-rationale style currently in production.
|
||||
Future variants will test alternative encodings (tabular, before/after) against this baseline.
|
||||
**Source:** `AGENTS.md:59-60 + workflow.md:417-430`
|
||||
|
||||
---
|
||||
**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 @@
|
||||
# git_hard_bans — v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` "Critical Anti-Patterns" HARD BAN lines (59-60) + `conductor/workflow.md` §"Known Pitfalls" (lines 417-430). This is the baseline encoding — the imperative-bullet-with-rationale style currently in production.
|
||||
Future variants will test alternative encodings (tabular, before/after) against this baseline.
|
||||
|
||||
**Source:** `AGENTS.md:59-60 + workflow.md:417-430`
|
||||
|
||||
---
|
||||
|
||||
From `AGENTS.md` "Critical Anti-Patterns" HARD BAN:
|
||||
- HARD BAN: `git restore`, `git checkout -- <file>`, `git reset` are FORBIDDEN without explicit user permission in the same message. They destroyed user in-progress src/* edits twice in one session (2026-06-07). If you think you need one, ASK FIRST.
|
||||
- HARD BAN: `git stash*` (any form: `git stash`, `git stash pop`, `git stash apply`, `git stash drop`, `git stash clear`) is FORBIDDEN. Stashing inverts the safety net of the working tree: a `git add .` then `git stash` then "fresh start" pattern is exactly how Tier 2 corrupted files in the 2026-06-27 `cruft_elimination_20260627` track. The user explicitly stated "I hate when people fuck with my commits" — stashing throws away the user's in-progress edits silently. If you think you need a stash, you don't — use a NEW BRANCH or a WORKTREE instead. Tier 2 sandbox enforces this via `conductor/tier2/opencode.json.fragment` bash deny rules.
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
# imgui_scope_verification
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `conductor/product-guidelines.md` §"Code Standards & Architecture" (line 39) + `conductor/workflow.md` §"Code Style" line 9. 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/product-guidelines.md:39 + workflow.md:9`
|
||||
|
||||
---
|
||||
**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 @@
|
||||
# imgui_scope_verification — v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `conductor/product-guidelines.md` §"Code Standards & Architecture" (line 39) + `conductor/workflow.md` §"Code Style" line 9. 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/product-guidelines.md:39 + workflow.md:9`
|
||||
|
||||
---
|
||||
|
||||
From `conductor/product-guidelines.md` §"Code Standards & Architecture":
|
||||
- **Mandatory ImGui Verification:** All changes to the GUI (`gui_2.py`) MUST be verified using the custom AST linter (`scripts/check_imgui_scopes.py`) to ensure all ImGui scopes (begin/end, push/pop) are properly matched. Developers should prioritize the use of `src/imgui_scopes.py` context managers (`imscope`) over manual push/pop calls.
|
||||
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
# inherited_cruft_ask_first
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` §"Process Anti-Patterns" #4 (lines 146-150). 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:146-150`
|
||||
|
||||
---
|
||||
**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 @@
|
||||
# inherited_cruft_ask_first — v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` §"Process Anti-Patterns" #4 (lines 146-150). 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:146-150`
|
||||
|
||||
---
|
||||
|
||||
### 4. The Inherited-Cruft Pattern (kill it)
|
||||
|
||||
**Symptom:** The previous agent left a half-finished refactor in the working tree. The file is broken. You try to fix it and make it worse. You try again. You make it worse. The file stays broken for 3 days.
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
# knowledge_harvest_pattern
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/knowledge_artifacts.md` §"0. The one-glance directory layout" (lines 9-26) + §1 (lines 28-44). This is the baseline encoding — the directory-tree-plus-rationale style currently in production.
|
||||
Future variants will test alternative encodings (rule-only, table-only) against this baseline.
|
||||
**Source:** `conductor/code_styleguides/knowledge_artifacts.md:9-44`
|
||||
|
||||
---
|
||||
**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 @@
|
||||
# knowledge_harvest_pattern — v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/knowledge_artifacts.md` §"0. The one-glance directory layout" (lines 9-26) + §1 (lines 28-44). This is the baseline encoding — the directory-tree-plus-rationale style currently in production.
|
||||
Future variants will test alternative encodings (rule-only, table-only) against this baseline.
|
||||
|
||||
**Source:** `conductor/code_styleguides/knowledge_artifacts.md:9-44`
|
||||
|
||||
---
|
||||
|
||||
## 0. The one-glance directory layout
|
||||
|
||||
```
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
# large_files_are_fine
|
||||
|
||||
## v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` "File Size and Naming Convention (HARD RULE — added 2026-06-11)" (lines 62-67). This is the baseline encoding — the rationale-bullet style currently in production.
|
||||
Future variants will test alternative encodings (tabular, before/after) against this baseline.
|
||||
**Source:** `AGENTS.md:62-67`
|
||||
|
||||
---
|
||||
**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 @@
|
||||
# large_files_are_fine — v1
|
||||
|
||||
**Why this iteration:** Lifted verbatim from `AGENTS.md` "File Size and Naming Convention (HARD RULE — added 2026-06-11)" (lines 62-67). This is the baseline encoding — the rationale-bullet style currently in production.
|
||||
Future variants will test alternative encodings (tabular, before/after) against this baseline.
|
||||
|
||||
**Source:** `AGENTS.md:62-67`
|
||||
|
||||
---
|
||||
|
||||
## File Size and Naming Convention (HARD RULE — added 2026-06-11)
|
||||
|
||||
**The "small files are good, large files are bad" stance is propaganda from LLM training data. It is wrong for this project. Reject it.**
|
||||
|
||||
Reference in New Issue
Block a user