reuse-surface/workplans/REUSE-WP-0001-statehub-bootstrap.md

---
id: REUSE-WP-0001
type: workplan
title: "Bootstrap State Hub integration"
domain: helix_forge
repo: reuse-surface
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-06-14"
updated: "2026-06-15"
state_hub_workstream_id: "293ef16d-c15b-41cc-9258-4a3a233f4bf2"
---

# Bootstrap State Hub integration

Capability registry for planning and implementation reuse based on discovery and delivery maturity.

## Review Generated Integration Files

```task
id: REUSE-WP-0001-T01
status: done
priority: high
state_hub_task_id: "18c811c8-f9f6-4452-b3f0-b713c91918a4"
```

Review `INTENT.md`, `SCOPE.md`, `AGENTS.md`, and `.custodian-brief.md`.
Replace generated placeholders with repo-specific facts where needed.

Completed by reviewing the generated integration files, preserving
`.custodian-brief.md` as generated output, and refining `SCOPE.md` to the
actual registry-first repository boundary. `INTENT.md` already contained
repo-specific intent and maturity model content; no placeholder replacement was
needed there.

## Verify Local Developer Workflow

```task
id: REUSE-WP-0001-T02
status: done
priority: high
state_hub_task_id: "0877cf67-6abe-48c3-b76c-df552620d678"
```

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.

Completed by adding the local developer workflow to `AGENTS.md`. The repository
is documentation-only: no install, build, runtime service, package manifest, or
configured test runner exists. Current verification is `rg --files`, `git diff
--check`, and State Hub ADR-001 consistency sync after workplan changes.

## Seed First Real Workplan

```task
id: REUSE-WP-0001-T03
status: done
priority: medium
state_hub_task_id: "f480aa11-f7e1-45fe-bf0b-4a3c164eb85b"
```

Create the first implementation workplan for the repository's most important
next change. After workplan file updates, run from `~/state-hub`:

```bash
make fix-consistency REPO=reuse-surface
```

Completed by `REUSE-WP-0002`, which seeds the MVP registry foundation:
schema, templates, sample capabilities, index, validation guidance, and agent
registry instructions.