polycode-sim/SCOPE.md

# SCOPE

> Lightweight boundary for agents and contributors.

## One-liner

PolyCode Simulator is a Python-based agent simulation framework for studying governance and resource-allocation dynamics. It models investor and voter strategies, runs parameterized scenario sweeps, and aggregates KPIs to compare the behavior, robustness, and outcomes of different allocation mechanisms.

## Core Idea

Polycode is a simulation laboratory for mechanism design: a way to test governance and funding systems before deploying them in the real world.

## In Scope

- Core simulation engine for a single demo run
- Pluggable investor/voter strategy modules
- Parameter sweeps and KPI aggregation via experiments.py
- Baseline parameter configuration management
- Protocol specification documentation

## Out of Scope

- Production/live deployment integration
- Visualization dashboard or UI
- Cross-repo orchestration

## Current State

- v0.1 simulator scaffold committed (`simulator.py`, `strategies.py`, `experiments.py`); outputs under `runs/`.
- POLYCODE-WP-0002 finished; next implementation work should extend strategies and KPI reporting.

## Getting Oriented

- Start with: INTENT.md
- Agent instructions: AGENTS.md
- Workplans: workplans/