# 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`