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_prompt_framing_study(),
13        drex.build_grammar_scaffold_study(),
14        drex.build_human_vs_agent_process_study(),
15        drex.build_diversity_and_exploration_study(),
16        drex.build_optimization_benchmark_study(),
17    )
18    bundles = (
19        drex.ideation_bundle(),
20        drex.optimization_bundle(),
21        drex.grammar_problem_bundle(),
22        drex.human_vs_agent_bundle(),
23    )
24
25    print(f"Loaded {len(bundles)} benchmark bundles")
26
27    first_study = studies[0]
28    first_study.output_dir = Path("artifacts") / "recipe-overview"
29    conditions = drex.build_design(first_study)
30
31    print(drex.render_markdown_summary(first_study, run_results=[]))
32    print(drex.render_methods_scaffold(first_study))
33    print(drex.render_codebook(first_study, conditions[:2]))
34
35
36if __name__ == "__main__":
37    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.