Recipe Overview#

Source: examples/recipe_overview.py

Introduction#

Survey the reusable recipe builders and reporting helpers without running a study.

Technical Implementation#

  1. Instantiate each recipe factory once.

  2. Load standard benchmark bundles.

  3. Render markdown summary, methods scaffold, and codebook snippets.

 1from __future__ import annotations
 2
 3from pathlib import Path
 4
 5import design_research_experiments as drex
 6
 7
 8def main() -> None:
 9    """Build recipe studies and render lightweight markdown outputs."""
10    studies = (
11        drex.build_agent_architecture_comparison_study(),
12        drex.build_univariate_comparison_study(),
13        drex.build_bivariate_comparison_study(),
14        drex.build_strategy_comparison_study(),
15        drex.build_prompt_framing_study(),
16        drex.build_grammar_scaffold_study(),
17        drex.build_human_vs_agent_process_study(),
18        drex.build_diversity_and_exploration_study(),
19        drex.build_optimization_benchmark_study(),
20    )
21    bundles = (
22        drex.ideation_bundle(),
23        drex.optimization_bundle(),
24        drex.grammar_problem_bundle(),
25        drex.human_vs_agent_bundle(),
26    )
27
28    print(f"Loaded {len(bundles)} benchmark bundles")
29
30    first_study = studies[0]
31    first_study.output_dir = Path("artifacts") / "recipe-overview"
32    conditions = drex.build_design(first_study)
33
34    print(drex.render_markdown_summary(first_study, run_results=[]))
35    print(drex.render_methods_scaffold(first_study))
36    print(drex.render_codebook(first_study, conditions[:2]))
37
38
39if __name__ == "__main__":
40    main()

Expected Results#

Run Command

PYTHONPATH=src python examples/recipe_overview.py

The script prints bundle counts and markdown snippets that confirm recipe objects and reporting helpers are wired correctly.