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

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

  • 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/