From f93dac7d8f76708a2d31fcafd08b5412c50209df Mon Sep 17 00:00:00 2001 From: Ed_ Date: Tue, 2 Jun 2026 23:53:31 -0400 Subject: [PATCH] conductor(guidelines): add See Also section linking to per-file conventions --- conductor/product-guidelines.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/conductor/product-guidelines.md b/conductor/product-guidelines.md index 465ab8ba..4fb8d70b 100644 --- a/conductor/product-guidelines.md +++ b/conductor/product-guidelines.md @@ -46,3 +46,13 @@ - **Structural Dependency Mapping (SDM):** All major state variables, methods, and functions MUST include terse dependency tags at the end of their docstrings for AI-assisted impact analysis. - **Functions/Methods:** `[C: Caller1, Caller2]` (Primary callers). - **State Variables:** `[M: File:Line, Method]` (Mutation points) and `[U: File]` (Major use paths). + +## See Also — Applied Conventions + +The product guidelines are best understood alongside the per-source-file guides that demonstrate them: + +- **[docs/guide_gui_2.md](../docs/guide_gui_2.md):** §"UI Delegation Pattern" + §"ImGuiScope context managers" — Data-Oriented / Immediate Mode heuristics in action. +- **[docs/guide_app_controller.md](../docs/guide_app_controller.md):** §"Modular Controller Pattern" + §"Hook API Surface" — handler maps for dispatch, not if/elif chains. +- **[docs/guide_multi_agent_conductor.md](../docs/guide_multi_agent_conductor.md):** §"Thread Safety" — `threading.local()` source tier tagging, lock-protected event queue. +- **[docs/guide_models.md](../docs/guide_models.md):** §"Design Principles" + §"SDM Tags" — centralized registry, pydantic validation, `[C: ...]` / `[M: ...]` tags in docstrings. +- **[docs/guide_testing.md](../docs/guide_testing.md):** §"Structural Testing Contract" — Ban on Arbitrary Core Mocking, `live_gui` Standard, Artifact Isolation.