Skip to content

Workflow — Capability gap analysis

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.
Workflow id capability-gap-analysis · version 1 · Draft (Draft → InReview → Published → Deprecated, BC-04)
Coordinator capability-discovery-coordinator · family Planning, Intent Routing & Product Vision
Owner service WorkflowEngineService (BC-38) under Run Control (BC-03)
Starts on BlueprintValidated from BlueprintService (event)
Steps 4 · gated 0 · agents 1
Budget per run 600000 tokens · cap 60.0 USD · 240 min
Descriptor workflow-definition-v1 · schema
Status target

Finds the APIs, data and templates a Service Blueprint needs but the estate lacks, by querying the template catalog, the knowledge platform and repository intelligence, and classifies each gap as build, reuse or defer.

Authored design, Draft (D54, D57)

These definitions were authored on 2026-10-14 from the coordinator cards as design assumptions. None is published, evaluated or has run; agents are named by id as design bindings, not as tested integrations.

Definition

flowchart TD
    start(("BlueprintValidated"))
    inventory_needs["Inventory the needs"]
    query_estate[["tool: Query the estate"]]
    classify_gaps["Classify the gaps"]
    store_report["Store the report"]
    start --> inventory_needs
    inventory_needs --> query_estate
    query_estate --> classify_gaps
    classify_gaps --> store_report
    done(("WorkflowRunCompleted"))
    store_report --> done
    classDef gated stroke:#B45309,stroke-width:2px
Hold "Alt" / "Option" to enable pan & zoom

Shapes: rectangle = agent attempt · double rectangle = tool call · stadium = human decision · diamond = condition evaluated by the engine · parallelogram = fan-out or join · circle = timer · cylinder = sub-workflow · flag = compensation. A thick amber border marks a gated step.

Steps

# Step Kind Runs Gate Class Depends on Retry Timeout Compensation What it does
1 Inventory the needs
inventory-needs		 agent enterprise-architect none read — exponential ×2 PT30M — Lists the required APIs, data stores, integrations and templates per context of the blueprint.
2 Query the estate
query-estate		 tool knowledge-search none read inventory-needs exponential ×2 PT30M — Searches the template catalog, the knowledge platform and the repository indexes for each need; results carry citations.
3 Classify the gaps
classify-gaps		 agent enterprise-architect none read query-estate exponential ×2 PT30M — Marks each need build, reuse or defer with the evidence and the owning platform.
4 Store the report
store-report		 agent enterprise-architect none sandbox classify-gaps exponential ×2 PT30M — Stores the gap report with lineage to the blueprint and the evidence.

Gates and approvals

No approval is required: every step runs in the read or sandbox class; the agents' own tool calls still carry their classes (D21). Compensation steps run in reverse order of the succeeded steps on failure after the last checkpoint; a step without a compensation leaves its sandbox output in place and the run ends Failed with the evidence (ADR-0014, recovery not replay).

Inputs, outputs and events

Direction Name Descriptor
in service-blueprint blueprint-service-v1
in template-catalog artifact-v1
out gap-report artifact-v1

Starts on BlueprintValidated; emits ArtifactStored, plus the engine's WorkflowRunStarted, StepReady, StepRunStateChanged and WorkflowRunCompleted / WorkflowRunFailed and Run Control's run and attempt events (ADR-0014).

Decisions and traceability

FR: FR-07 Authorized context assembly with provenance · FR-11 Compatible templates and libraries through release gatesXL: XL-07 Honest knowledge searchFUX: FUX-09 Intelligence viewsADRs: ADR-0014, ADR-0024 · ADR index

Definition authored 2026-10-14 from the coordinator card capability-discovery-coordinator (D54); Draft until an evaluation gate (ADR-0021) and a review publish it as a BC-04 asset release.