Skip to content

Workflow definitions

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.

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.

A workflow definition is data: a DAG of agent, tool, human, condition, parallel, timer, sub-workflow and compensation steps, validated against workflow-definition-v1 when it is published as a BC-04 asset. The Workflow Engine (BC-38) walks it; Run Control dispatches every agent step as an attempt, holds the approvals and records the truth (ADR-0014); durability is the Orleans substrate of ADR-0024. Each definition below realizes one June-2026 coordinator.

25 definitions, all Draft (D52): a definition is published only after its evaluation gate (ADR-0021) and every agent it names is Published.

API & Gateway Design

Workflow Starts on Steps Gated Agents Summary
API contracts
api-contracts
BlueprintValidated 4 0 api-designer Generates the OpenAPI and gRPC contracts of a validated Service Blueprint's operations, lints them against the API governance rules and stores them as artifacts.
Gateway generation
gateway-generation
BlueprintValidated 4 0 api-designer, api-gateway-generator Generates the product's API gateway (GW-07) from the API Gateway Blueprint on the ConnectSoft API gateway template, validates it and records the output.
## Architecture, Domain Modeling & Bounded Contexts
Workflow Starts on Steps Gated Agents Summary
Architecture decomposition
architecture-decomposition
BlueprintValidated 4 0 enterprise-architect, domain-modeler Decomposes a validated Vision Blueprint into bounded contexts and modules with their domain models, producing the Service Blueprint from which BlueprintService derives the context map.
## Testing & Quality
Workflow Starts on Steps Gated Agents Summary
Behaviour simulation
behaviour-simulation
GenerationCompleted 4 0 e2e-testing, qa-engineer Runs the acceptance scenarios of a generated product end to end in the sandbox with agents, scores the results into evaluation records and stores the validated results.
Test plan
test-plan
BlueprintValidated 4 0 test-generator, qa-engineer Builds the Test Blueprint from the service and module blueprints: scenarios from features and invariants, a coverage matrix and the quality constraints, validated against the DSL.
## Planning, Intent Routing & Product Vision
Workflow Starts on Steps Gated Agents Summary
Capability gap analysis
capability-gap-analysis
BlueprintValidated 4 0 enterprise-architect 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.
Plan a run
plan-run
RunAccepted 5 0 factory-workflow-orchestrator Turns an accepted run submission into a workflow-definition instance: classifies the intent, selects a Published definition or composes a plan validated against the DSL, and hands the first steps to the engine.
Product plan
product-plan
BlueprintValidated 4 0 product-manager Builds the feature hierarchy, the edition scope and the roadmap-free dependency view from a validated Vision Blueprint, as artifacts for review.
UX personas and journeys
ux-personas
BlueprintValidated 4 0 persona-builder, ux-designer Extracts actors and personas from the Vision Blueprint, maps their journeys, and writes them into a validated UX Blueprint.
Vision to blueprint
vision-to-blueprint
RunAccepted 4 0 vision-architect 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.
## Observability, Security & Compliance
Workflow Starts on Steps Gated Agents Summary
Compliance check
compliance-check
GenerationCompleted 7 0 privacy-compliance, security-engineer Checks generated code and infrastructure against the selected compliance rule sets, raises findings to audit and blocks on critical findings.
## Lifecycle Feedback & Governance
Workflow Starts on Steps Gated Agents Summary
Technical debt review
debt-review
PipelineRunCompleted 3 0 code-reviewer, tech-lead Collects reviewer comments and analyzer results of a pipeline run, classifies the shortcuts as debt with owners and severity, and raises them as findings.
Milestone lifecycle
milestone-lifecycle
RunCompleted 4 1 product-owner, qa-engineer, release-manager Validates a milestone's runs, tests and evidence before release packaging: collects the runs, verifies tests and evidence, and creates the release through ReleaseService when all pass.
Release promotion
release
ReleaseReady 6 1 release-manager, devops-engineer, deployment-orchestrator Promotes a milestone-validated release through the environments: verifies readiness, promotes to staging, bakes against the guards, waits for the production approval, promotes and verifies; a failed verification requests the rollback.
Sprint execution
sprint-execution
RunAccepted 4 1 work-preparation-orchestrator, product-owner Runs a sprint's planned items as child runs in order, reviews each item's outcome against its acceptance criteria and closes the sprint with the evidence.
## DevOps, Infrastructure & Environments
Workflow Starts on Steps Gated Agents Summary
Delivery run
delivery-run
PipelineRunCompleted 5 1 devops-engineer, deployment-orchestrator Evaluates a completed pipeline run's typed results, prepares the release manifest and requests the promotion; a production promotion waits for its approval. Deployment is a promotion, never a pipeline stage.
Infrastructure plan
infrastructure-plan
BlueprintValidated 5 0 infrastructure-architect, infrastructure-engineer Derives the Infrastructure Blueprint and the Pulumi program from the module, database, security and observability blueprints, previews it in the sandbox and records the output; nothing is applied.
## Documentation & Knowledge Management
Workflow Starts on Steps Gated Agents Summary
Documentation sync
documentation-sync
ChangeProposalMerged 5 1 documentation-site-generator, documentation-writer Regenerates a product's documentation site from the model after a merged change, writes the narrative deltas, validates the build and proposes the documentation change set.
Guides generation
guides-generation
GenerationCompleted 4 0 documentation-writer Drafts guides and tutorials for a generated product as artifacts for human review; nothing is published by the run.
## Blueprint & Microservice Assembly
Workflow Starts on Steps Gated Agents Summary
Generate libraries
generate-libraries
RecipeApproved 4 0 library-generator, backend-developer Scaffolds shared-kernel and client libraries from Backend Library Blueprints, implements the shared kernel, validates by build and test and records the outputs.
Generate a product
generate-product
RecipeApproved 10 1 microservice-generator, backend-developer, frontend-developer, database-engineer Executes an approved generation recipe: scaffolds every module from its template in the sandbox, fills backend, frontend and database from the domain model, validates by build and test, records the outputs with provenance and proposes the change set under approval.
Module blueprints
module-blueprints
ContextMapDerived 4 0 backend-developer Produces one Module Blueprint per context of a derived context map: the clean-architecture layout, template switches and adapters each module will be scaffolded with.
## ChatOps, Runtime Commands, Developer Experience
Workflow Starts on Steps Gated Agents Summary
Preview environment
preview-environment
ChangeProposalOpened 5 1 environment-manager, devops-engineer Creates a per-developer preview environment from a change proposal, keeps it for its time to live and tears it down; a later capability of Runtime Cloud exposed as a workflow.
## Project Initialization & Session Management
Workflow Starts on Steps Gated Agents Summary
Project bootstrap
project-bootstrap
ProjectCreated 5 1 devops-engineer Creates the system-of-record project, repositories, pipelines and boards for a new Factory project through connectors, under one shared-write approval, and records the trace scaffolding.
## Event-Driven Architecture & Messaging
Workflow Starts on Steps Gated Agents Summary
Saga design as workflow definitions
saga-design
DomainModelDerived 4 0 event-driven-architect, enterprise-architect Finds the long-running flows in a derived domain model and designs each as a workflow definition with compensation, validated against the DSL, instead of an ad-hoc saga.

How the definitions interlock

flowchart LR
    vision["vision-to-blueprint"] --> plan["product-plan"]
    vision --> ux["ux-personas"]
    vision --> arch["architecture-decomposition"]
    arch --> gaps["capability-gap-analysis"]
    arch --> modules["module-blueprints"]
    arch --> saga["saga-design"]
    arch --> api["api-contracts"]
    arch --> tests["test-plan"]
    api --> gateway["gateway-generation"]
    modules --> infra["infrastructure-plan"]
    modules --> gen["generate-product"]
    modules --> libs["generate-libraries"]
    gen --> sim["behaviour-simulation"]
    gen --> comp["compliance-check"]
    gen --> guides["guides-generation"]
    gen --> preview["preview-environment"]
    gen --> delivery["delivery-run"]
    delivery --> docs["documentation-sync"]
    delivery --> debt["debt-review"]
    delivery --> milestone["milestone-lifecycle"]
    milestone --> release["release"]
    bootstrap["project-bootstrap"] --> planrun["plan-run"]
    planrun --> vision
    sprint["sprint-execution"] --> planrun
Hold "Alt" / "Option" to enable pan & zoom

The edges are the events one definition emits and another starts on; a product run normally begins with plan-run, which instantiates one of these definitions or composes a plan from them.