diff --git a/Directory.Build.props b/Directory.Build.props
index babb5f0..2eb3c32 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -3,8 +3,8 @@
AgileWebs
AgileWebs
git
- http://192.168.10.100:3000/AgileWebs/building-block-workflow
- http://192.168.10.100:3000/AgileWebs/building-block-workflow
+ https://gitea.dream-views.com/AgileWebs/building-block-workflow
+ https://gitea.dream-views.com/AgileWebs/building-block-workflow
false
diff --git a/docs/roadmap/feature-epics.md b/docs/roadmap/feature-epics.md
new file mode 100644
index 0000000..5091001
--- /dev/null
+++ b/docs/roadmap/feature-epics.md
@@ -0,0 +1,18 @@
+# Feature Epics
+
+## Repository
+building-block-workflow
+
+## Core Epics
+- Epic 1: Expand domain-aligned capabilities for restaurant operations.
+- Epic 2: Stabilize service contracts for containerized runtime integration.
+- Epic 3: Improve observability and operational readiness for demo compose environments.
+
+## Domain-Specific Candidate Features
+- Order lifecycle consistency and state transitions.
+- Kitchen queue and dispatch optimization hooks.
+- Operations control-plane policies (flags, service windows, overrides).
+- POS closeout and settlement summary alignment.
+
+## Documentation Contract
+Any code change in this repository must include docs updates in the same branch.
diff --git a/src/BuildingBlock.Workflow.Contracts/Abstractions/IWorkflowCapabilityContract.cs b/src/BuildingBlock.Workflow.Contracts/Abstractions/IWorkflowCapabilityContract.cs
index 55189c0..bd32532 100644
--- a/src/BuildingBlock.Workflow.Contracts/Abstractions/IWorkflowCapabilityContract.cs
+++ b/src/BuildingBlock.Workflow.Contracts/Abstractions/IWorkflowCapabilityContract.cs
@@ -5,6 +5,10 @@ namespace BuildingBlock.Workflow.Contracts.Abstractions;
public interface IWorkflowCapabilityContract
{
+ Task CreateWorkflowWorkItemAsync(
+ CreateWorkflowWorkItemRequest request,
+ CancellationToken cancellationToken);
+
Task TransitionWorkflowStateAsync(
TransitionWorkflowStateRequest request,
CancellationToken cancellationToken);
diff --git a/src/BuildingBlock.Workflow.Contracts/Requests/CreateWorkflowWorkItemRequest.cs b/src/BuildingBlock.Workflow.Contracts/Requests/CreateWorkflowWorkItemRequest.cs
new file mode 100644
index 0000000..487054b
--- /dev/null
+++ b/src/BuildingBlock.Workflow.Contracts/Requests/CreateWorkflowWorkItemRequest.cs
@@ -0,0 +1,11 @@
+using BuildingBlock.Workflow.Contracts.Contracts;
+
+namespace BuildingBlock.Workflow.Contracts.Requests;
+
+public sealed record CreateWorkflowWorkItemRequest(
+ string WorkItemId,
+ string WorkType,
+ int Priority,
+ DateTime RequestedAtUtc,
+ WorkflowState InitialState,
+ string CorrelationId);
diff --git a/src/BuildingBlock.Workflow.Contracts/Responses/CreateWorkflowWorkItemResponse.cs b/src/BuildingBlock.Workflow.Contracts/Responses/CreateWorkflowWorkItemResponse.cs
new file mode 100644
index 0000000..bc42f13
--- /dev/null
+++ b/src/BuildingBlock.Workflow.Contracts/Responses/CreateWorkflowWorkItemResponse.cs
@@ -0,0 +1,9 @@
+using BuildingBlock.Workflow.Contracts.Contracts;
+
+namespace BuildingBlock.Workflow.Contracts.Responses;
+
+public sealed record CreateWorkflowWorkItemResponse(
+ string WorkItemId,
+ WorkflowState State,
+ bool Created,
+ string? RejectionReason);