Complete State Hub bootstrap (RALPH-WP-0001); add RALPH-WP-0002

workplans/RALPH-WP-0001-statehub-bootstrap.md

@@ -0,0 +1,65 @@
+---
+id: RALPH-WP-0001
+type: workplan
+title: "Bootstrap State Hub integration"
+domain: agents
+repo: ralph-workplan
+status: finished
+owner: codex
+topic_slug: foerster-capabilities
+created: "2026-07-08"
+updated: "2026-07-08"
+state_hub_workstream_id: "a2d88606-9cd6-4e78-9afe-45475287407b"
+---
+
+# Bootstrap State Hub integration
+
+ralph-workplan is a Claude Code skill/plugin that runs a Ralph Loop scoped to a Markdown workplan file, automatically stopping once every task in the workplan is marked done.
+
+## Review Generated Integration Files
+
+```task
+id: RALPH-WP-0001-T01
+status: done
+priority: high
+state_hub_task_id: "6c2f735a-cf29-4c7e-a6b2-2d476418132a"
+```
+
+Result 2026-07-08: INTENT.md and SCOPE.md reviewed; AGENTS.md confirmed.
+
+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: RALPH-WP-0001-T02
+status: done
+priority: high
+state_hub_task_id: "e53d0322-c88c-4503-9e61-8dc54f993d7f"
+```
+
+Result 2026-07-08: Documented bash/plugin workflow in stack-and-commands.md.
+
+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: RALPH-WP-0001-T03
+status: done
+priority: medium
+state_hub_task_id: "fe7d0e1b-fa7e-4684-ace2-71b80d89d33a"
+```
+
+Result 2026-07-08: Created RALPH-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
+```

workplans/RALPH-WP-0002-plugin-hardening.md

@@ -0,0 +1,26 @@
+---
+id: RALPH-WP-0002
+type: workplan
+title: "Plugin hardening and adoption docs"
+domain: agents
+repo: ralph-workplan
+status: ready
+owner: codex
+topic_slug: foerster-capabilities
+created: "2026-07-08"
+updated: "2026-07-08"
+---
+
+# Plugin hardening and adoption docs
+
+Harden install/check scripts and document adoption path for workplan-driven Ralph loops across coulomb repos.
+
+## Adoption and guardrail checklist
+
+```task
+id: RALPH-WP-0002-T01
+status: todo
+priority: high
+```
+
+Document workplan-spec.md requirements, check-done behavior, max-iterations guidance, and cross-repo install notes in README.