repo-manager/workplans/RMGR-WP-0001-foundation.md
tegwick e3fbdbc148 docs: establish INTENT/SCOPE and activate RMGR-WP-0001
Strengthen Intent and Scope for State Hub registration and HelixForge
boundaries; mark foundation workplan active. Classification synced via
register-from-classification (do not re-run statehub register bootstrap —
it collides with RMGR-WP-0001).
2026-08-09 21:55:59 +02:00

2.9 KiB

id type title domain repo status owner topic_slug created updated state_hub_workstream_id parent_project parent_workplan stream related
RMGR-WP-0001 workplan Repo Manager architecture and foundation infotech repo-manager active codex repo-manager 2026-08-09 2026-08-09 e32a9d49-a38f-4117-8e37-1c66afe1dad1 prj-state-hub-retirement SHR-WP-0001 S1
SHR-ARCH-IA-0001
SHR-INV-0001
HUB-WP-0004
STATE-WP-0079

Repo Manager architecture and foundation

Goal

Turn the repository genesis and scope into an implementable contract and first vertical slice, coordinated by the State Hub retirement project (prj-state-hub-retirement / SHR-WP-0001 stream S1). See project map: architecture/child-workplan-map_v0.1.md.

Define the repository representation

id: RMGR-WP-0001-T01
status: todo
priority: high
state_hub_task_id: "43468b5c-f49f-43c3-bf30-922fadc1f8c0"

Specify stable repository identity, locations, revisions, classifications, declared records, relationships, health, lifecycle, and coach/lead/director agent assignments. Identify which fields are authoritative in the repository and which are replaceable projections.

Define observation and command contracts

id: RMGR-WP-0001-T02
status: todo
priority: high
state_hub_task_id: "2453316f-33f4-41d0-bcb5-c7552db88d68"

Define normalized repository facts, governed commands, authorization context, idempotency, correlation, evidence, failure behavior, and hub-core integration without exposing persistence models.

Inventory extraction candidates

id: RMGR-WP-0001-T03
status: todo
priority: high
state_hub_task_id: "deee10be-25e1-4ee7-b47e-93dc816916c9"

Map relevant State Hub repository registration, host-path, workplan parsing, consistency, reconciliation, dependency, file-mutation, and outbox behavior to keep/adapt/replace/retire dispositions with compatibility tests.

Select the implementation foundation

id: RMGR-WP-0001-T04
status: todo
priority: medium
state_hub_task_id: "0a041f4e-09fc-4f69-8a48-ac396186bc8f"

Choose the runtime, persistence, package, migration, test, and deployment shape consistent with the ordinary HelixForge platform. Record the decision before substantial implementation.

Prove one repository end to end

id: RMGR-WP-0001-T05
status: todo
priority: high
state_hub_task_id: "5036a248-1c47-423f-be8d-4fd232896c31"

Register and represent one independently valid repository, index its declared work, emit a normalized change through hub-core contracts, apply one authorized file-backed transition, and prove the resulting Git evidence and rebuilt projection.

Acceptance

  • The authority and data model are explicit.
  • Observation and command contracts are versioned and testable.
  • State Hub extraction candidates have dispositions.
  • The implementation foundation has a recorded decision.
  • One repository completes the end-to-end vertical slice.