Skip to main content

value_stream_map View

The value_stream_map view visualizes end-to-end customer and business value delivery streams, mapping sequential stages to enabling business capabilities, business processes, software applications, autonomous AI agents, data assets, and strategic KPIs.


Visual Projection​

Value Stream Map View showing stage flow with enabling capability swimlanes and architecture realization


Purpose & Target Audience​

  • Target Audience: Enterprise Architects, Business Architects, Value Stream Managers, Product Directors, Transformation Leaders.
  • Primary Use Cases:
    • Depicting customer journeys and stage progression from trigger to value delivery.
    • Identifying capability gaps and redundant applications across the value stream.
    • Tracking realization of stage milestones by underlying software services and autonomous AI agents.
    • Mapping data assets read and produced across delivery stages.
    • Monitoring strategic KPIs and goals linked to each stage of customer value.
    • Generating stakeholder traceability registers with instant CSV export.

Flow Orientations & Auto Layout​

The value_stream_map view supports dual flow orientations via auto_layout:

Layout OptionFlow OrientationUsage & Visual Representation
Omitted / LeftToRight (Default)Horizontal Pipeline FlowStages flow left-to-right as sequential chevron cards with realization swimlanes underneath.
TopToBottomVertical Progression FlowStages flow vertically with progression connectors and adjacent realization summary cards.
views {
# 1. Horizontal Pipeline Flow (default when auto_layout is omitted or set to LeftToRight)
value_stream_map v_onboarding_pipeline "Customer Onboarding Pipeline" {
include vs_customer_onboarding
include stage
include capability
auto_layout LeftToRight
}

# 2. Vertical Stage Progression Flow
value_stream_map v_lending_lifecycle "Consumer Lending Lifecycle" {
include vs_consumer_lending
include stage
include capability
auto_layout TopToBottom
}
}

Supported Entity Types​

Entity TypeRole in Value StreamDescription
value_streamRoot StreamThe top-level value stream container enclosing stages.
stageJourney MilestoneThe sequential phases of value delivery with numeric order attributes.
capabilityFunctional EnablerBusiness capabilities realizing or supporting specific stages.
processOperational WorkflowHuman and system processes executed within each stage.
system, appTechnical SystemCore IT platforms and microservices powering stage operations.
agentAutonomous AI AgentAI agents and bot workers performing triage, review, or automation.
actorStakeholder / PersonaCustomers, operators, and employees participating in the stream.
data_objectInformation AssetBusiness entities and payloads read or written at each stage.
kpi, goalMeasurable OutcomePerformance metrics and strategic targets measuring stage success.

Supported Relationships & Verbs​

Relationship VerbSource EntityTarget EntityMeaning
realizescapability, app, system, agent, processstage, value_streamEnabler realization of value stream stages
servesapp, system, capabilitystage, actorSystem or capability servicing a stage
flows_tostage, app, data_objectstage, app, data_objectMaterial, data, or sequence flow between stages
triggersactor, system, stagestage, processEvent triggering subsequent stages or workflows
readsapp, stage, agentdata_objectData consumption at a stage
writesapp, stage, agentdata_objectData artifact production at a stage
influencesstage, capabilitygoal, kpiContribution to measurable business outcomes
composed_ofvalue_streamstageStructural stage decomposition
depends_onstage, appstage, appOperational prerequisite dependencies
governed_bystage, processpolicy, standardRegulatory and compliance constraints

Fixed Compiler-Defined Traversal​

value_stream_map views feature intrinsic compiler-defined traversal: authors only need to include the target value_stream root entity. The compiler automatically resolves participating architecture entities:

  1. Base Stages: Stages enclosed within the included value_stream.
  2. Capabilities (Frontier 1): Any capability realizing the base stages (incoming realizes).
  3. Systems, Apps, Agents, & Processes (Frontier 2): Any app, autonomous agent, or process realizing the capabilities (incoming realizes).
  4. Structural Systems (Frontier 2 Sys): Enclosing parent systems of any realized apps or agents.
  5. Strategic KPIs & Goals (Lateral): Any KPI or goal influenced by the capabilities (outgoing influences).
  6. Data Objects: Any data asset read or written by apps, agents, or processes (outgoing reads / writes).
  7. Stage Owner Fallback: If a stage does not define an explicit owner, it automatically inherits the parent value stream's owner.

:::info Single Value Stream Constraint A value_stream_map view supports exactly one value stream per view. Including multiple value streams or broad where clauses matching stages across multiple streams produces compile error NEA2019. If no value stream is resolved, compile error NEA2020 is emitted. :::


Complete DSL Example​

views {
value_stream_map customer_onboarding_value_stream "Customer Onboarding Value Stream" {
description "End-to-end customer onboarding pipeline mapping stages to enabling capabilities, systems, and KPIs."
tags ["Value Stream", "Onboarding", "Customer Experience"]

# Including the value stream automatically resolves all stages,
# enabling capabilities, apps/agents, enclosing systems, KPIs, and data objects
include vs_customer_onboarding

auto_layout LeftToRight
}
}