State-hub connect and initial workplans

docs/state-hub-integration.md

@@ -0,0 +1,50 @@
+# State Hub Integration
+
+`markitect-tool` was registered with the Custodian State Hub on 2026-05-03.
+
+| Field | Value |
+| --- | --- |
+| Domain | `markitect` |
+| Repo slug | `markitect-tool` |
+| Topic ID | `5571d954-0d30-4950-980d-7bcaaad8e3e2` |
+| Local path | `/home/worsch/markitect-tool` |
+
+## Integration Result
+
+The registration workflow:
+
+- Confirmed the State Hub API was reachable.
+- Confirmed the `state-hub` MCP server was configured.
+- Registered `markitect-tool` as a managed repo under the `markitect` domain.
+- Created the onboarding workstream `repo-integration-markitect-tool`.
+- Created four onboarding tasks for repo setup, workplans, SBOM, and catalogue hygiene.
+
+## Repository Source of Truth
+
+Per Custodian ADR-001, workplans and work items originate in repository files.
+State Hub should index and cache this state, not become the primary store.
+
+The canonical workplan location is:
+
+```text
+workplans/
+```
+
+## Follow-Up
+
+Once implementation dependencies exist, add an SBOM source and update State Hub
+with the SBOM ingestion result. This seed repo currently has no package manifest.
+
+## Registered Extension Points
+
+| ID | Title | Source |
+| --- | --- | --- |
+| `EP-MKTT-001` | Optional LLM-assisted generation adapter hook | `workplans/MKTT-WP-0003-core-toolkit-implementation.md` |
+| `EP-MKTT-002` | Query backend adapter boundary | `docs/markitect-main-scope-assessment.md` |
+
+## Registered Technical Debt
+
+| ID | Title | Source |
+| --- | --- | --- |
+| `TD-MKTT-001` | Implementation scaffold not yet created | `workplans/MKTT-WP-0003-core-toolkit-implementation.md` |
+| `TD-MKTT-002` | Legacy behavior requires test-level migration filter | `workplans/MKTT-WP-0002-markitect-main-migration.md` |