polycode-sim/SCOPE.md
tegwick a8e4f03172
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
Complete POLYCODE-WP-0002 simulator v0.1 scaffold
2026-07-08 15:21:15 +02:00

1.2 KiB

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/