feat(directives): harvest 5 GUI/architecture directives from product-guidelines.md + python.md

This commit is contained in:
ed
2026-07-02 22:11:19 -04:00
parent 2d07df594d
commit fa3e5381fe
5 changed files with 72 additions and 0 deletions
@@ -0,0 +1,16 @@
# 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.
---
From `conductor/workflow.md` §"Code Style":
- **ImGui Defer Patterns:** Use `imscope` context managers or `_render_window_if_open` dispatch helpers to prevent resource leaks and keep the main loop flat. See `conductor/code_styleguides/python.md` for details.