tegwick 9b5bece12a docs(SHR-WP-0001): complete T01 project-repository convention

Mark foundation workplan active and T01 done with pointer to the
custodian canon standard and residual note for statehub register GOAL.md
support.

2026-08-09 17:24:07 +02:00

3.7 KiB

Raw Blame History

id	type	title	domain	repo	status	owner	topic_slug	created	updated	state_hub_workstream_id
SHR-WP-0001	workplan	Project foundation and architecture baseline	infotech	prj-state-hub-retirement	active	codex	state-hub-retirement	2026-08-09	2026-08-09	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

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

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

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

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

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

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

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.

3.7 KiB Raw Blame History