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

refactor(conductor/edit_workflow.md): thin-pointer §9 to conductor/code_styleguides/python.md

Browse Source 
Per agent_directives_consolidation_20260705 §3.3.

The 9-line §9 'No Diagnostic Noise in Production Code' section is
replaced with a 1-line pointer to the canonical home in
conductor/code_styleguides/python.md §AI-Agent Specific Conventions.

Net: 9 lines reduced to 1 line. Duplicate content removed; the
canonical styleguide remains the source of truth.
This commit is contained in:
Edward R. Gonzalez
2026-07-05 15:18:01 -04:00
parent fa0ba73035
commit 3a47dede4b
1 changed files with 1 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
conductor/edit_workflow.md
+1 -7
View File
@@ -109,13 +109,7 @@ If you mismatch any of these, the file will fail to parse. Run `py_check_syntax`
### 9. No Diagnostic Noise in Production Code (Added 2026-06-09)
`sys.stderr.write(f"[XYZ_DIAG] ...")` lines added to `src/*.py` for debugging are technical debt the moment they ship. If you need to instrument for a one-time investigation:
- Write the diag output to a log file: `tests/artifacts/<test_name>.diag.log`
- Or to a standalone diagnostic script under `/tmp/diag_<name>.py` that imports the production module and exercises it
- Or read the production source with `get_file_slice` and reason about it directly
Do NOT add diag lines to `src/*.py` "temporarily." If you must add them for a single test run, they 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.
See `conductor/code_styleguides/python.md` §"AI-Agent Specific Conventions" (the canonical home for this rule).
## Step-by-Step Workflow for gui_2.py