Atomizer/optimization_engine/future/README.md

Experimental LLM Features (Archived)

Status: Archived for post-MVP development Date Archived: November 24, 2025

Purpose

This directory contains experimental LLM integration code that was explored during early development phases. These features are archived (not deleted) for potential future use after the MVP is stable and shipped.

MVP LLM Integration Strategy

For the MVP, LLM integration is achieved through:

• Claude Code Development Assistant: Interactive development-time assistance
• Claude Skills (.claude/skills/):
  • create-study.md - Interactive study scaffolding
  • analyze-workflow.md - Workflow classification and analysis

This approach provides LLM assistance without adding runtime dependencies or complexity to the core optimization engine.

Archived Experimental Files

1. llm_optimization_runner.py

Experimental runner that makes runtime LLM API calls during optimization. This attempted to automate:

• Extractor generation
• Inline calculations
• Post-processing hooks

Why Archived: Adds runtime dependencies, API costs, and complexity. The centralized extractor library (optimization_engine/extractors/) provides better maintainability.

2. llm_workflow_analyzer.py

LLM-based workflow analysis for automated study setup.

Why Archived: The analyze-workflow Claude skill provides the same functionality through development-time assistance, without runtime overhead.

3. inline_code_generator.py

Auto-generates inline Python calculations from natural language.

Why Archived: Manual calculation definition in optimization_config.json is clearer and more maintainable for MVP.

4. hook_generator.py

Auto-generates post-processing hooks from natural language descriptions.

Why Archived: The plugin system (optimization_engine/plugins/) with manual hook definition is more robust and debuggable.

5. report_generator.py

LLM-based report generation from optimization results.

Why Archived: Dashboard provides rich visualizations. LLM summaries can be added post-MVP if needed.

6. extractor_orchestrator.py

Orchestrates LLM-based extractor generation and management.

Why Archived: Centralized extractor library (optimization_engine/extractors/) is the production approach. No code generation needed at runtime.

When to Revisit

Consider reviving these experimental features after MVP if:

1. ✅ MVP is stable and well-tested
2. ✅ Users request more automation
3. ✅ Core architecture is mature enough to support optional LLM features
4. ✅ Clear ROI on LLM API costs vs manual configuration time

Production Architecture (MVP)

For reference, the stable production components are:

optimization_engine/
├── runner.py                    # Production optimization runner
├── extractors/                  # Centralized extractor library
│   ├── __init__.py
│   ├── base.py
│   ├── displacement.py
│   ├── stress.py
│   ├── frequency.py
│   └── mass.py
├── plugins/                     # Plugin system (hooks)
│   ├── __init__.py
│   └── hook_manager.py
├── nx_solver.py                 # NX simulation interface
├── nx_updater.py                # NX expression updates
└── visualizer.py                # Result plotting

.claude/skills/                  # Claude Code skills
├── create-study.md              # Interactive study creation
└── analyze-workflow.md          # Workflow analysis

Migration Notes

If you need to use any of these experimental files:

1. They are functional but not maintained
2. Update imports to optimization_engine.future.{module_name}
3. Install any additional dependencies (LLM client libraries)
4. Be aware of API costs for LLM calls

Related Documents

• docs/07_DEVELOPMENT/Today_Todo.md - MVP Development Plan
• DEVELOPMENT.md - Development guide
• .claude/skills/create-study.md - Study creation skill

Questions?

For MVP development questions, refer to the DEVELOPMENT.md guide or the MVP plan in docs/07_DEVELOPMENT/Today_Todo.md.