Create Environment Module

Create Environment Module

Overview

Create or repair a custom EnvBase environment module under custom/envs. Guides requirements intake through validation, producing a single .py file with properly decorated tools.

When to Use

• User asks to create a new environment or simulation module (e.g. "social media module", "voting environment", "market simulation")
• experiment-config needs an environment module that does not yet exist in the workspace
• User wants to add or modify @tool-decorated methods on an existing custom env
• The simulation scale, step budget, or runtime budget should influence the module design

Do NOT use when:

• The env module already exists and only needs registration (use scan-modules instead)
• The task is about agent skills, not environment modules

Workflow

digraph create_env_flow {
    rankdir=LR;
    node [shape=box, style=filled, fillcolor="#E8F4FD"];
    intake [label="collect requirements"];
    clarify [label="clarify missing\nconstraints"];
    design [label="structured design"];
    generate [label="write custom/envs/<module>.py"];
    validate [label="run create-env-module-validate"];
    archive [label="optional run artifacts"];

    intake -> clarify -> design -> generate -> validate -> archive;
}

Stage Notes

• stages/intake.md: requirements intake
• stages/clarify.md: resolve missing constraints
• stages/design.md: structured design
• stages/generate.md: code generation
• stages/validate.md: validation and failure mapping