idea39-vizforge-interactive-economic/AGENTS.md

AGENTS.md

Repository Purpose

VizForge models startup economics in a YAML DSL, runs stochastic scenario simulation, and generates investor-facing artifacts.

Architecture

• src/idea39_vizforge_interactive_economic/models.py: typed domain models and validation.
• src/idea39_vizforge_interactive_economic/dsl.py: YAML DSL parser, serializer, and model digesting.
• src/idea39_vizforge_interactive_economic/simulation.py: Monte Carlo engine, sensitivity analysis, dilution projection.
• src/idea39_vizforge_interactive_economic/artifacts.py: markdown report and SVG chart generation.
• src/idea39_vizforge_interactive_economic/cli.py: command-line entry point.
• tests/: integration-style tests for parsing, simulation, and artifacts.

Tech Stack

• Python 3.11+
• numpy for stochastic simulation
• pydantic for validation
• PyYAML for DSL parsing
• jinja2 for report templating
• matplotlib for chart rendering

Rules

• Keep the DSL declarative and versioned.
• Prefer deterministic tests with explicit seeds.
• Do not weaken validation to make a test pass.
• Preserve the README package metadata fields if packaging changes.
• Keep outputs reproducible by recording seeds and source digests.

Verification

• bash test.sh
• python3 -m pytest
• python3 -m build