polycode-sim/workplans/POLYCODE-WP-0001-statehub-bootstrap.md

---
id: POLYCODE-WP-0001
type: workplan
title: "Bootstrap State Hub integration"
domain: infotech
repo: polycode-sim
status: finished
owner: codex
topic_slug: custodian
created: "2026-07-08"
updated: "2026-07-08"
state_hub_workstream_id: "05e27f85-6a20-4906-a3c1-633776d6c448"
---

# Bootstrap State Hub integration

PolyCode Simulator is a Python-based agent simulation modeling investor and voter strategies to study governance/allocation dynamics, with parameter sweeps and KPI aggregation.

## Review Generated Integration Files

```task
id: POLYCODE-WP-0001-T01
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.

## Verify Local Developer Workflow

```task
id: POLYCODE-WP-0001-T02
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.

## Seed First Real Workplan

```task
id: POLYCODE-WP-0001-T03
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:

```bash
statehub fix-consistency
```