33 lines
1.3 KiB
Markdown
33 lines
1.3 KiB
Markdown
# 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`
|