tegwick
9b5bece12a
Mark foundation workplan active and T01 done with pointer to the custodian canon standard and residual note for statehub register GOAL.md support.
118 lines
3.7 KiB
Markdown
118 lines
3.7 KiB
Markdown
---
|
|
id: SHR-WP-0001
|
|
type: workplan
|
|
title: "Project foundation and architecture baseline"
|
|
domain: infotech
|
|
repo: prj-state-hub-retirement
|
|
status: active
|
|
owner: codex
|
|
topic_slug: state-hub-retirement
|
|
created: "2026-08-09"
|
|
updated: "2026-08-09"
|
|
state_hub_workstream_id: "8498db77-cbe1-48ff-b7f0-03b933f0aa8a"
|
|
---
|
|
|
|
# Project foundation and architecture baseline
|
|
|
|
## Goal
|
|
|
|
Establish the durable project conventions, evidence inventories, architecture
|
|
decisions, and child-repository workplan map required before implementation
|
|
migration begins.
|
|
|
|
## Confirm the project-repository convention
|
|
|
|
```task
|
|
id: SHR-WP-0001-T01
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "528ed9c9-57a6-4f44-b1cf-9d2c1a5cbca4"
|
|
```
|
|
|
|
Define the `prj-` repository flavor, lifecycle, required files, authority
|
|
boundary, and archive procedure in the Custodian canon. Confirm that project
|
|
repositories use `GOAL.md` rather than durable-product `INTENT.md`.
|
|
|
|
**Result (2026-08-09):** Fleet standard published at
|
|
`the-custodian/canon/standards/project-repository-flavor_v0.1.md`. ADR-005
|
|
naming section points at the standard; classification standard §5.3 cross-links
|
|
it; CUST-WP-0050 open question D1a marked resolved. Reference instance: this
|
|
repository (`prj-state-hub-retirement`, `GOAL.md` only — no durable
|
|
`INTENT.md`). Residual tooling gap: `statehub register` still scaffolds
|
|
`INTENT.md` for ordinary repos — capture under a state-hub child workplan when
|
|
T05 maps implementation streams (do not invent `INTENT.md` on `prj-` repos).
|
|
|
|
## Inventory State Hub
|
|
|
|
```task
|
|
id: SHR-WP-0001-T02
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "f19351e4-c922-417c-bcc7-746a2cd7fe52"
|
|
```
|
|
|
|
Produce machine-readable inventories of State Hub routes, models, migrations,
|
|
jobs, MCP tools, dashboard views, datasets, callers, and operational
|
|
dependencies. Give every item an initial owner and keep/move/replace/retire
|
|
disposition.
|
|
|
|
## Define the information architecture
|
|
|
|
```task
|
|
id: SHR-WP-0001-T03
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "65e522c7-2550-4187-a308-a23a2bae7615"
|
|
```
|
|
|
|
Define canonical entities and relations plus the distinct semantics of events,
|
|
signals, messages, conversations, requests, work, decisions, knowledge, and
|
|
telemetry. Specify correlation, authority, provenance, sensitivity, retention,
|
|
cost attribution, and transformation rules.
|
|
|
|
## Define the hub and extension architecture
|
|
|
|
```task
|
|
id: SHR-WP-0001-T04
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "90e8350a-8a1c-4f46-a545-69c9cf00e6d1"
|
|
```
|
|
|
|
Revise the Orthogonal Architecture material into an implementable hub-core and
|
|
domain-extension contract. Define domain hubs, functional components,
|
|
authoritative services, projections, adapters, and conformance requirements.
|
|
|
|
## Establish the child-workplan map
|
|
|
|
```task
|
|
id: SHR-WP-0001-T05
|
|
status: todo
|
|
priority: high
|
|
state_hub_task_id: "1fc9da32-14ed-46b6-a965-b2477414df78"
|
|
```
|
|
|
|
Create or identify local implementation workplans in `repo-manager`,
|
|
`hub-core`, `core-hub`, `state-hub`, and other affected repositories. Record
|
|
dependencies and project gates without duplicating their tasks here.
|
|
|
|
## Baseline migration and retirement acceptance
|
|
|
|
```task
|
|
id: SHR-WP-0001-T06
|
|
status: todo
|
|
priority: medium
|
|
state_hub_task_id: "d793f242-999c-47ad-86f2-6d972cc20b84"
|
|
```
|
|
|
|
Record baseline row counts, callers, availability expectations, recovery paths,
|
|
and historical-evidence requirements. Turn the success and retirement clauses
|
|
in `GOAL.md` into executable or evidence-backed gates.
|
|
|
|
## Acceptance
|
|
|
|
- [x] The `prj-` flavor has a durable canonical definition.
|
|
- [ ] State Hub has a complete disposition inventory.
|
|
- [ ] The information and extension architectures are reviewable.
|
|
- [ ] Each implementation stream has one local owner and workplan.
|
|
- [ ] Migration and retirement gates have measurable evidence requirements.
|