37 lines
3.1 KiB
Markdown
37 lines
3.1 KiB
Markdown
|
# SCOPE
|
||
|
|
|
||
|
|
> This file was generated by `statehub register`. Refine it as the repository
|
||
|
|
> boundaries become clearer.
|
||
|
|
|
||
|
|
## 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
|
||
|
|
|
||
|
|
- {"project_description": "PolyCode Simulator is a Python-based agent simulation modeling investor and voter strategies to study governance/allocation dynamics, with parameter sweeps and KPI aggregation.", "intent_markdown": "# Intent\n\n## Purpose\nPolyCode Simulator (v0.1) is a Python simulation engine that models interactions between investor and voter agents under pluggable strategies, used to explore governance and capital-allocation dynamics and their emergent outcomes (KPIs) across parameter sweeps.\n\n## In Scope\n- Core simulation engine (`simulator.py`) running single demo simulations\n- Pluggable investor/voter strategy implementations (`strategies.py`)\n- Parameter sweep / grid-search experiments with KPI aggregation (`experiments.py`)\n- Baseline parameter configuration (`params_default.json`)\n- Protocol specification documentation (`spec.md`)\n- Run outputs written to `./runs/`\n\n## Out of Scope\n- Production deployment or live trading/voting integration\n- UI/dashboard for visualizing results\n- Multi-repo orchestration or external service integration\n\n## Current State\nEarly-stage (v0.1) simulator with a minimal CLI-driven workflow; single initial commit plus a CI smoke workflow.\n", "domain_slug": null, "topic_slug": "polycode-sim", "topic_title": "PolyCode Simulator", "repo_slug": "polycode-sim", "workplan_prefix": "POLYCODE-WP", "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"], "project_description": "PolyCode Simulator is a Python-based agent simulation modeling investor and voter strategies to study governance/allocation dynamics, with parameter sweeps and KPI aggregation.", "repo_slug": "polycode-sim", "topic_slug": "polycode-sim", "topic_title": "PolyCode Simulator", "workplan_prefix": "POLYCODE-WP"}
|
||
|
|
|
||
|
|
## Getting Oriented
|
||
|
|
|
||
|
|
- Start with: INTENT.md
|
||
|
|
- Agent instructions: AGENTS.md
|
||
|
|
- Workplans: workplans/
|