docs: rehome state model workplan

2026-05-17 19:10:34 +02:00
parent bd7ac91ebf
commit f9d2dd0046
2 changed files with 215 additions and 1 deletions
--- a/docs/workplan-convention.md
+++ b/docs/workplan-convention.md
@@ -0,0 +1,24 @@
+# State Hub Workplan Convention
+
+New workplans in this repository use:
+
+```text
+SHUB-WP-0001-short-title.md
+```
+
+Workplan frontmatter should include:
+
+```yaml
+id: SHUB-WP-0001
+type: workplan
+title: "Short Title"
+domain: custodian
+repo: state-hub
+status: active
+owner: custodian
+topic_slug: custodian
+```
+
+During extraction, legacy `CUST-WP-*` plans may be bridged or migrated with
+their existing `state_hub_workstream_id` values. Write files first, then run
+State Hub consistency sync after this repo is registered.