From 395d0fddd0cdc920dccc8c33dc8f878bc71107f0 Mon Sep 17 00:00:00 2001 From: tegwick Date: Wed, 8 Jul 2026 15:07:22 +0200 Subject: [PATCH] Complete State Hub bootstrap (POLYCODE-WP-0001); add POLYCODE-WP-0002 --- .claude/rules/stack-and-commands.md | 18 +++++-------- SCOPE.md | 6 ++--- .../POLYCODE-WP-0001-statehub-bootstrap.md | 14 +++++++--- ...POLYCODE-WP-0002-simulator-v01-scaffold.md | 26 +++++++++++++++++++ 4 files changed, 46 insertions(+), 18 deletions(-) create mode 100644 workplans/POLYCODE-WP-0002-simulator-v01-scaffold.md diff --git a/.claude/rules/stack-and-commands.md b/.claude/rules/stack-and-commands.md index dc53ac6..ed70bf5 100644 --- a/.claude/rules/stack-and-commands.md +++ b/.claude/rules/stack-and-commands.md @@ -1,19 +1,15 @@ ## Stack - -- **Language:** -- **Key deps:** +- **Language:** Python 3.11+ (simulator scaffold planned) +- **Key deps:** stdlib-first; pytest when `simulator.py` lands ## Dev Commands ```bash -# TODO: Fill in the standard commands for this repo +# Planned v0.1 workflow (see README.md) +python3 simulator.py +python3 experiments.py -# Install dependencies - -# Run tests - -# Lint / type check - -# Build / package (if applicable) +# After workplan edits +statehub fix-consistency ``` diff --git a/SCOPE.md b/SCOPE.md index f3e3a2f..2b1957b 100644 --- a/SCOPE.md +++ b/SCOPE.md @@ -1,7 +1,6 @@ # SCOPE -> This file was generated by `statehub register`. Refine it as the repository -> boundaries become clearer. +> Lightweight boundary for agents and contributors. ## One-liner @@ -27,7 +26,8 @@ Polycode is a simulation laboratory for mechanism design: a way to test governan ## 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"} +- 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 diff --git a/workplans/POLYCODE-WP-0001-statehub-bootstrap.md b/workplans/POLYCODE-WP-0001-statehub-bootstrap.md index 6dd16f4..3bf99a1 100644 --- a/workplans/POLYCODE-WP-0001-statehub-bootstrap.md +++ b/workplans/POLYCODE-WP-0001-statehub-bootstrap.md @@ -4,7 +4,7 @@ type: workplan title: "Bootstrap State Hub integration" domain: infotech repo: polycode-sim -status: ready +status: finished owner: codex topic_slug: custodian created: "2026-07-08" @@ -20,11 +20,13 @@ PolyCode Simulator is a Python-based agent simulation modeling investor and vote ```task id: POLYCODE-WP-0001-T01 -status: todo +status: done priority: high state_hub_task_id: "d0f6a1cd-641f-4a63-890c-99bc5c12cc4b" ``` +Result 2026-07-08: INTENT.md and SCOPE.md reviewed; README/spec aligned with planned v0.1 layout. + Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`. Replace generated placeholders with repo-specific facts where needed. @@ -32,11 +34,13 @@ Replace generated placeholders with repo-specific facts where needed. ```task id: POLYCODE-WP-0001-T02 -status: todo +status: done priority: high state_hub_task_id: "6ad22e61-ad4d-4643-ad49-000e41e4959b" ``` +Result 2026-07-08: Documented planned Python workflow in stack-and-commands.md (code scaffold tracked in WP-0002). + Identify the repo's install, test, lint, build, and run commands. Add or refine those commands in the agent instructions so future coding sessions can verify changes confidently. @@ -45,11 +49,13 @@ changes confidently. ```task id: POLYCODE-WP-0001-T03 -status: todo +status: done priority: medium state_hub_task_id: "d0d8fea2-28e8-4766-8295-9118a8378c2c" ``` +Result 2026-07-08: Created POLYCODE-WP-0002. + Create the first implementation workplan for the repository's most important next change. After workplan file updates, run the sync locally from this repo checkout: diff --git a/workplans/POLYCODE-WP-0002-simulator-v01-scaffold.md b/workplans/POLYCODE-WP-0002-simulator-v01-scaffold.md new file mode 100644 index 0000000..a687984 --- /dev/null +++ b/workplans/POLYCODE-WP-0002-simulator-v01-scaffold.md @@ -0,0 +1,26 @@ +--- +id: POLYCODE-WP-0002 +type: workplan +title: "PolyCode simulator v0.1 scaffold" +domain: infotech +repo: polycode-sim +status: ready +owner: codex +topic_slug: custodian +created: "2026-07-08" +updated: "2026-07-08" +--- + +# PolyCode simulator v0.1 scaffold + +Implement the documented v0.1 simulation engine (`simulator.py`, `strategies.py`, `experiments.py`, `params_default.json`) described in README and specs. + +## Simulator scaffold + +```task +id: POLYCODE-WP-0002-T01 +status: todo +priority: high +``` + +Add minimal runnable simulator with default strategies, params file, `./runs/` output, and a smoke test for one demo run.