ed/manual_slop
Private
Public Access
0
0
Fork 0
Code Activity

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

Browse Source
This commit is contained in:
ed
2026-07-02 23:46:41 -04:00
parent 831499622d
commit 68352ee206
18 changed files with 91 additions and 82 deletions
Download Patch File Download Diff File Expand all files Collapse all files
conductor/directives/no_diagnostic_noise/meta.md
+10
View File
@@ -0,0 +1,10 @@
# no_diagnostic_noise
## v1
**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/python.md` §8 (lines 68-70) + `AGENTS.md` "Session-Learned Anti-Patterns" §5. 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:68-70 + AGENTS.md:"Session-Learned Anti-Patterns" §5`
---
**Lifted:** 2026-07-02 (Phase 1 harvest by Tier 3 worker; user directive 2026-07-02 moved the header into this meta file)
conductor/directives/no_diagnostic_noise/v1.md
-9
View File
@@ -1,12 +1,3 @@
# no_diagnostic_noise — v1
**Why this iteration:** Lifted verbatim from `conductor/code_styleguides/python.md` §8 (lines 68-70) + `AGENTS.md` "Session-Learned Anti-Patterns" §5. 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:68-70 + AGENTS.md:"Session-Learned Anti-Patterns" §5`
---
From `conductor/code_styleguides/python.md` §8 "AI-Agent Specific Conventions":
- **No diagnostic noise in production code (Added 2026-06-09).** `sys.stderr.write(f"[XYZ_DIAG] ...")` lines added to `src/*.py` for one-time debugging are technical debt the moment they ship. The project's production code should not contain `[XYZ_DIAG]` markers, `print(...debug...)` calls, or any other ad-hoc debug instrumentation. The right place for diagnostic output during a one-time investigation is `tests/artifacts/<test_name>.diag.log` (a log file) or a standalone `/tmp/diag_<name>.py` script. If you must instrument a production function for a single test run, the diag lines are part of the same atomic commit as the fix — they do not live uncommitted in the working tree. If you "revert everything," that means the diag lines are also reverted.