docs(conductor): Complete Phase 1 of AppController curation (Audit & Guidelines)

conductor/tracks/app_controller_curation_20260513/spec.md

@@ -0,0 +1,21 @@
+# Specification: AppController Curation & Structural Alignment
+
+## Context
+Following the successful cleanup and refactoring of `gui_2.py`, the same organizational patterns and AI-optimized coding conventions must be applied to `src/app_controller.py`. This module is a critical part of the Manual Slop architecture, acting as the bridge between the GUI and the underlying AI/MCP systems.
+
+## Goals
+1. **Structural Parity:** Reorganize `src/app_controller.py` to match the structure and quality of `gui_2.py`.
+2. **Standardization:** Enforce the AI-Optimized Python Style Guide (1-space indent, minimal blank lines, type hints, SDM tags).
+3. **Refactoring:** Identify and extract logic that violates the 5-level nesting limit or is better suited as module-level functions.
+4. **Validation:** Ensure full system integrity via the comprehensive test suite, run in batches of 4.
+
+## Scope
+- `src/app_controller.py`: Primary target for refactoring and curation.
+- `conductor/code_styleguides/python.md`: Potential updates if new nuances are found.
+- `conductor/product-guidelines.md`: Potential updates based on structural findings.
+
+## Constraints
+- **Indentation:** Must be exactly 1 space.
+- **Scoping:** Use `imscope` for any ImGui-related calls if present (though `app_controller` should ideally be logic-focused, some status rendering might exist).
+- **Anti-OOP:** Move state-independent methods to module level.
+- **Type Safety:** 100% type hint coverage for all modified sections.