Skip to content

Workflow — Vision to blueprint

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 vision-to-blueprint · version 1 · Draft (Draft → InReview → Published → Deprecated, BC-04)
Coordinator vision-agent-coordinator · family Planning, Intent Routing & Product Vision
Owner service WorkflowEngineService (BC-38) under Run Control (BC-03)
Starts on RunAccepted from RunControlService (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

Runs the Vision Architect Agent from a prompt and constraints to a validated Vision Blueprint with its artifacts, clarifying assumptions first and revising on validation findings.

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(("RunAccepted"))
    clarify_intent["Clarify the intent"]
    draft_vision["Draft the Vision Blueprint"]
    validate{"Validate the blueprint"}
    store_artifacts["Store with lineage"]
    start --> clarify_intent
    clarify_intent --> draft_vision
    draft_vision --> validate
    validate --> store_artifacts
    done(("WorkflowRunCompleted"))
    store_artifacts --> 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 Clarify the intent
clarify-intent		 agent vision-architect none read — exponential ×2 PT30M — Lists the open questions and the assumptions taken for each, as an artifact the requester can correct.
2 Draft the Vision Blueprint
draft-vision		 agent vision-architect none sandbox clarify-intent exponential ×2 PT30M — Writes the Vision Blueprint: problem, goals, scope classes, personas, constraints and success measures.
3 Validate the blueprint
validate		 condition engine none sandbox draft-vision fixed ×2 PT2M — BlueprintService validates the draft against blueprint-vision-v1 and the VIS rules; findings go back to the draft step up to twice. Condition: blueprint.valid.
4 Store with lineage
store-artifacts		 agent vision-architect none sandbox validate exponential ×2 PT30M — Stores the validated blueprint and the assumptions artifact with lineage to the prompt.

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 prompt run-submission-v1
in constraints artifact-v1
out vision-blueprint blueprint-vision-v1

Starts on RunAccepted; emits BlueprintValidated, 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-08 Validated artifacts with lineageXL: XL-03 Read-only assessmentFUX: FUX-06 Source-backed artifacts · FUX-11 Software Factory journeyADRs: ADR-0014, ADR-0024 · ADR index

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