polycode-sim/SCOPE.md
tegwick 395d0fddd0
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
Complete State Hub bootstrap (POLYCODE-WP-0001); add POLYCODE-WP-0002
2026-07-08 15:07:22 +02:00

36 lines
1.2 KiB
Markdown

# 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
- Planning/spec repo: README and pitch materials exist; v0.1 Python simulator modules not yet committed.
- Bootstrap State Hub integration (POLYCODE-WP-0001) finished; next: simulator scaffold (POLYCODE-WP-0002).
## Getting Oriented
- Start with: INTENT.md
- Agent instructions: AGENTS.md
- Workplans: workplans/