Skip to content

E2E Steering Projection & Sync Sequence

This diagram illustrates the end-to-end flow of the CAS Steering Projection workflow, from indexing current system state to generating persona-specific LLM-augmented guidance and applying approved updates.

sequenceDiagram
    participant Host as CI / Developer CLI
    participant Runner as FlowRunner
    participant Step as SteeringProjectionStep
    participant Core as Deterministic Engines
    participant Synth as ArchitectureSynthesizer
    participant LLM as LLM (Reasoning Contract)
    participant Rend as ManagedSectionRenderer
    participant Proj as SteeringPatchProjector
    participant Apply as ManagedSectionApplier

    Host->>Runner: cas run steering-projection-flow
    Runner->>Step: execute()

    Note over Step, Core: Phase 1: Deterministic Extraction
    Step->>Core: build_index() [Indexer]
    Step->>Core: analyze(baseline) [Analyzer]
    Step->>Core: extract(deltas) [Extractor]
    Core-->>Step: current_deltas, capabilities

    Note over Step, LLM: Phase 2: Persona-Driven Synthesis
    Step->>Core: scan() [ArtifactScanner]
    Core-->>Step: artifact_claims (markers)
    Step->>Synth: synthesize(request)

    par Parallel Synthesis (README, AGENTS, Platform)
        Synth->>LLM: reason(synthesis-narrative)
        Synth->>LLM: reason(synthesis-rules)
        Synth->>LLM: reason(synthesis-context)
    end
    LLM-->>Synth: synthesized_markdown (JSON)
    Synth-->>Step: synthesized_content_map

    Note over Step, Proj: Phase 3: Projection Bundling
    Step->>Rend: render(project, deltas, capabilities, synth_content)
    Rend-->>Step: managed_section_proposals
    Step->>Proj: persist(project, index, findings, proposals)
    Proj-->>Step: SteeringProjectionBundle (.md)

    Step-->>Runner: bundle_output
    Runner-->>Host: Done. Projection Persisted.

    Note over Host, Apply: Optional Approval Step

    Host->>Apply: cas steering apply --projection <id>
    Apply->>Apply: plan(proposals) [Validation & Diffs]
    Apply->>Apply: apply(plan) [Atomic Surgical Injection]
    Apply-->>Host: Steering Artifacts Updated

Flow Description

  1. Extraction: The workflow begins by deterministically indexing the current project state and comparing it against a baseline (e.g., previous projection) to extract architectural deltas and capabilities.
  2. Synthesis: The ArchitectureSynthesizer identifies existing managed markers in steering artifacts. It dispatches concurrent requests to the LLM via the unified reasoning contract, providing persona-specific prompts and current content to ensure high-signal, incremental updates.
  3. Bundling: The ManagedSectionRenderer prioritizes synthesized content over raw data tables. The SteeringPatchProjector then persists a human-readable projection bundle containing all proposed changes.
  4. Application: Once the projection is reviewed (manually or via CI), the ManagedSectionApplier performs a surgical, atomic update, injecting the new content strictly between the <!-- CAS-STEERING --> markers.

Patterns Illustrated

  • Deterministic Core / Selective Augmentation: Core state extraction is deterministic; LLM is used only to improve guidance signal.
  • Persona-Driven Synthesis: Content is tailored for specific audiences (Humans vs. Agents).
  • Safe Surgical Injection: Updates are limited to managed markers to prevent data loss in human-authored sections.

See Also