./code/Agora-Opt/ is the source directory for the Agora-Opt method. It
retains two categories of assets:
the Agora-Opt implementation
prebuilt memory assets used by the method
Historical run outputs are not stored here.
For compatibility with the original stage naming, the main reproduction script
maintains two convenience paths:
generated_with_memory
debate_runs
Important Subdirectories
The most important components are:
src/debate_memory/: core Agora-Opt implementation
scripts/: command-line wrappers
memory_storage/: solution memory
debug_case_memory/: debug memory retrieval bank
debate_memory_storage/: debate memory retrieval bank
memory_variants/: retained alternative memory variants
memory_backups/: retained memory backups
Multiple memory versions are intentionally kept. They were prepared during
different stages of the project and can all be treated as available assets for
generation, debugging, and debate.
Core Workflow
Agora-Opt runs in two stages.
Stage 1: Generate Initial Solutions
generate_with_memory.py generates candidate solutions, optionally using
solution memory and debug memory.
Primary entry script:
scripts/generate_with_memory.py
This stage:
reads benchmark problems
retrieves similar solved cases from memory_storage/
generates candidate modeling code
uses debug memory during self-repair when execution fails
Stage 2: Run Debate
run_memory_debate.py takes two sets of initial solutions and runs the
decentralized debate stage.
Primary entry script:
scripts/run_memory_debate.py
This stage:
loads both sides' initial solutions
retrieves historical debate cases from debate_memory_storage/
performs iterative comparison, revision, and convergence
executes and evaluates the final consensus solution
Memory Types
1. Solution Memory
Directory:
memory_storage/
Purpose:
retrieves similar successful modeling cases during generation
supplies formulation templates and structural priors
