WIP almost done with track planning

conductor/tracks/on_demand_def_lookup_20260306/index.md

@@ -0,0 +1,9 @@
+# On-Demand Definition Lookup
+
+**Track ID:** on_demand_def_lookup_20260306
+
+**Status:** Planned
+
+**See Also:**
+- [Spec](./spec.md)
+- [Plan](./plan.md)

conductor/tracks/on_demand_def_lookup_20260306/metadata.json

@@ -0,0 +1,9 @@
+{
+  "id": "on_demand_def_lookup_20260306",
+  "name": "On-Demand Definition Lookup",
+  "status": "planned",
+  "created_at": "2026-03-06T00:00:00Z",
+  "updated_at": "2026-03-06T00:00:00Z",
+  "type": "feature",
+  "priority": "medium"
+}

conductor/tracks/on_demand_def_lookup_20260306/plan.md

@@ -1,16 +1,30 @@
-# Implementation Plan: On-Demand Definition Lookup (on_demand_def_lookup)
+# Implementation Plan: On-Demand Definition Lookup (on_demand_def_lookup_20260306)
 
-## Phase 1: Research & Design
-- [ ] Task: Analyze existing backend implementation
-- [ ] Task: Design GUI/UX approach
-- [ ] Task: Conductor - User Manual Verification
+## Phase 1: Symbol Parsing
+- [ ] Task: Initialize MMA Environment
+- [ ] Task: Implement @syntax parsing
+    - WHERE: src/gui_2.py
+    - WHAT: Detect @symbol in input
+    - HOW: Regex or string match
+    - SAFETY: Handle edge cases
 
-## Phase 2: Implementation
-- [ ] Task: Implement feature
-- [ ] Task: Write tests
-- [ ] Task: Conductor - User Manual Verification
+## Phase 2: Definition Retrieval
+- [ ] Task: Integrate py_get_definition
+    - WHERE: src/gui_2.py
+    - WHAT: Get definition from outline_tool
+    - HOW: Call existing function
+    - SAFETY: Handle not found
 
-## Phase 3: Verification
-- [ ] Task: Run test suite
-- [ ] Task: Verify coverage
-- [ ] Task: Conductor - Phase Completion Verification
+## Phase 3: Inline Display
+- [ ] Task: Render inline
+    - WHERE: src/gui_2.py
+    - WHAT: Show definition in discussion
+    - HOW: imgui.text with formatting
+- [ ] Task: Implement navigation
+    - WHERE: src/gui_2.py
+    - WHAT: Click to jump to source
+    - HOW: Store file/line refs
+
+## Phase 4: Verification
+- [ ] Task: Test lookup flow
+- [ ] Task: Conductor - Phase Verification

conductor/tracks/on_demand_def_lookup_20260306/spec.md

@@ -1,26 +1,21 @@
-# Track Specification: On-Demand Definition Lookup
+# Track Specification: On-Demand Definition Lookup (on_demand_def_lookup_20260306)
 
 ## Overview
-Agent can request specific class/function definitions during discussion.
+Add ability for agent to request specific class/function definitions during discussion. User @mentions symbol for inline definition, or AI auto-fetches on unknown symbols.
 
-## Current State Audit
-### Already Implemented
-- outline_tool.py for definitions
-- py_get_definition tool
-
-### Gaps to Fill
-- No @mention syntax
-- No inline display
-
-## Goals
-- @symbol lookup syntax
-- Inline definition display
-- Auto-fetch on unknown symbols
+## Architectural Constraints
+- **Fast Lookup**: Definition lookup MUST complete in <100ms.
+- **Accurate Parsing**: Symbol parsing MUST handle edge cases.
 
 ## Functional Requirements
-- Symbol parsing
-- Definition retrieval
-- Inline rendering
+- **@Syntax**: Parse @symbol to trigger lookup.
+- **Inline Display**: Show definition inline in discussion.
+- **Auto-Fetch**: Option for AI to auto-fetch on unknown symbols.
+- **Navigation**: Click definition to jump to source.
 
-## Non-Functional Requirements
-- Quick lookup (<100ms)
+## Acceptance Criteria
+- [ ] @symbol triggers lookup.
+- [ ] Definition displays inline.
+- [ ] Auto-fetch option works.
+- [ ] Click navigation functional.
+- [ ] Uses existing py_get_definition.