| name | data-workstream-foundation |
| description | State, resume, reconstruction, job-lifecycle, transition, and flow-state mechanics for the Data Workstream Coach. Loaded by the coach; not a user entry point. |
| license | CC-BY-4.0 |
| user-invocable | false |
| metadata | {"authors":"microsoft/hve-core","spec_version":"1.0","last_updated":"2026-08-03"} |
Data Workstream Foundation
Goal
Keep Data Workstream Coach orchestration consistent across job changes and
sessions without duplicating job-specific guidance. The coach loads this index
at initialization and resume, then reads the reference for the current
coaching moment.
Reference index
| Reference | When to read |
|---|
| job-registry.md | Before offering or selecting a job, routing to a skill or specialist, or naming a durable output |
| lifecycle-classes.md | When starting, pausing, resuming, completing, or re-invoking a job |
| transition-protocol.md | When a topic shift, explicit request, or completion suggests moving between jobs |
| session-state.md | Before initialization, validation, mutation, resume, recovery, or reconstruction of coaching state |
| flow-state.md | Before interrupting work, crossing a gate, writing a durable artifact, or offering post-job choices |
Success criteria
- Each orchestration rule has one owner in this package.
- State and lifecycle mechanics remain independent of job-specific methods.
- The coach reads the applicable reference before acting on its contract.
Constraints
- Keep catalog guidance in
ds-catalog, the durable data-catalog workflow for
entities, declared relationships, lineage, and ERD-ready model semantics.
- Keep feasibility guidance in
ds-feasibility, the evidence-led data and ML
feasibility-study workflow with lifecycle and interchange traceability.
- Keep pipeline and testing guidance in
ds-dataops, the DataOps reference for
tier behavior, pipeline invariants, validation placement, tests, drift, and
operational signals.
- Keep general experiment guidance in
experiment-design, the reusable
workflow for candidate selection, hypotheses, vetting, minimum scope, and
result evaluation.
- Keep ML-specific experiment guidance in
ml-experimentation, the reference
for ML environments, reproducibility, tracking, evaluation, abstractions,
and production readiness.
- Keep notebook and dashboard guidance in
ds-analysis-authoring, the
reference for EDA notebook and analytical dashboard composition,
visualization selection, and dashboard validation.
- Keep AI-system evaluation guidance in
ds-evaluation-design, the reference
for evaluation dataset design, difficulty balance, metric selection, and
tooling fit.
- Treat this package as internal foundation knowledge, not a user-selectable
workflow.
- Preserve the seven Data Science skill boundaries defined in the job registry.
Stop rules
- Stop before a state mutation when the session-state protocol has not been
loaded or project identity is uncertain.
- Stop before a job switch when the user has not confirmed the transition.
- Stop and report the missing owner when requested behavior belongs to neither
this foundation nor a registered job capability.
Attribution
This package is repository-original orchestration guidance licensed under
CC BY 4.0. It does not reproduce or summarize an external standard.
