---
id: capability.statehub.workstream-coordinate
name: Workstream And Task Coordination
summary: Track active workstreams, tasks, progress, and consistency across domain repositories through a local-first coordination service.
owner: state-hub
status: draft
domain: helix_forge
tags:
  - state-hub
  - coordination
  - workplans

maturity:
  discovery:
    current: D4
    target: D5
    confidence: medium
    rationale: >
      State Hub intent, scope, and ADR-001 workplan conventions are documented;
      concrete agent workflows are still being standardized across repos.
  availability:
    current: A4
    target: A6
    confidence: medium
    rationale: >
      Consumers integrate through the State Hub HTTP API and custodian scripts.
      Managed platform operation is the natural target for multi-repo agents.

external_evidence:
  completeness:
    level: C3
    name: Functional Core
    confidence: medium
    basis: scope_vs_intent_and_consumer_expectations
    satisfied_expectations:
      - workstream and task tracking via HTTP API
      - workplan file to database consistency sync
      - progress event logging
    broken_expectations:
      - no native MCP server for all agent environments
    out_of_scope_expectations:
      - replacing git-backed workplan canon
      - identity authority
  reliability:
    level: R2
    name: Tolerable
    confidence: low
    basis: consumer_quality_signals
    known_reliability_risks:
      - depends on local hub availability and operator maintenance

discovery:
  intent: >
    Give agents and operators a live, queryable memory of work across domains
    without replacing file-backed workplans and governance canon.
  includes:
    - workstream and task indexing
    - progress and decision events
    - repo consistency synchronization
    - inbox and human-review flags
  excludes:
    - canon ownership
    - task factory for all work origins
    - identity authority
  assumptions:
    - workplans remain authoritative in git for ADR-001 repos
  use_cases:
    - UC-RS-013
  research_memos:
    - state-hub/INTENT.md

availability:
  current_level: A4
  target_level: A6
  current_artifacts:
    - state-hub/api/
    - state-hub/scripts/consistency_check.py
  target_artifacts:
    - state-hub/platform/state-hub-service
  consumption_modes:
    - service API
    - HTTP REST

relations:
  depends_on:
    - capability.infotech.hub-core-library
  supports:
    - capability.registry.register
    - capability.infotech.core-hub
  related_to:
    - capability.statehub.progress-log
    - capability.infotech.hub-core-library
    - capability.infotech.core-hub

evidence:
  documentation:
    - state-hub/INTENT.md
    - state-hub/AGENTS.md
  tests: []
  consumer_feedback: []
  bug_reports: []
  incidents: []

consumer_guidance:
  recommended_for:
    - cross-repo agent orientation and task status sync
    - logging progress after workplan changes
  not_recommended_for:
    - storing canonical requirements or architecture canon
    - assuming hub state overrides git workplan files
  known_limitations:
    - requires running State Hub locally or via tunnel
---

# Workstream And Task Coordination

## Overview

State Hub provides live coordination for helix_forge repositories while
workplans remain file-backed. This entry represents the service/API consumption
mode for cross-repo agent work.