CAS: Why, What, Who, and How

This visual diagram provides a high-level overview of the Continuous Architecture System (CAS). It breaks down the core value proposition of CAS into four distinct pillars.

flowchart TB
    %% ───────── Styling ─────────
    classDef mainTitle fill:#1e293b,stroke:#334155,stroke-width:2px,color:#fff,font-size:20px,font-weight:bold
    classDef pillStyle fill:#3b82f6,stroke:#2563eb,stroke-width:2px,color:#fff,font-size:16px,font-weight:bold
    classDef item      font-size:13px
    classDef flowHead  fill:#e0e7ff,stroke:#6366f1,stroke-width:1px,color:#1e1b4b,font-size:14px,font-weight:bold
    classDef step      font-size:11px
    classDef govStyle  fill:#059669,stroke:#065f46,stroke-width:1px,color:#fff,font-size:13px,font-style:italic
    classDef promStyle fill:#d97706,stroke:#b45309,stroke-width:1px,color:#fff,font-size:13px,font-weight:bold
    classDef bandStyle fill:#7c3aed,stroke:#6d28d9,stroke-width:1px,color:#fff,font-size:14px,font-weight:bold
    classDef cliItem   font-size:13px

    %% ───────── Header ─────────
    Header["🧠 Continuous Architecture System (CAS) — The Enterprise Architecture Harness Platform"]:::mainTitle

    %% ───────── Top row: 4 pillars ─────────
    Why["❓ WHY · The Problem"]:::pillStyle
    What["💡 WHAT · The Value Proposition"]:::pillStyle
    Who["👥 WHO · The Beneficiaries"]:::pillStyle
    How["⚙️ HOW · Mechanism"]:::pillStyle

    Header --- Why
    Header --- What
    Header --- Who
    Header --- How

    %% ───────── Each pillar fans DOWN into its own vertical column ─────────
    W1["Stop Architecture Drift<br/>Bridge the gap between design and execution"]:::item
    W2["Ensure Traceability<br/>Link business intent directly to code"]:::item
    W3["Prevent Technical Debt<br/>Catch structural deviations early"]:::item

    WH1["Living Knowledge Brain<br/>Queryable, continuously updated"]:::item
    WH2["Decision-Driven Governance<br/>ADRs as single source of truth"]:::item
    WH3["Alignment Engine<br/>Compares intended vs. actual architecture"]:::item
    WH4["Prevent & Detect<br/>Stop bad structure upfront, correct drift"]:::item

    U1["🏢 Executives & CTOs<br/>Visibility, governance, ROI"]:::item
    U2["💼 Business Stakeholders<br/>Implementation matches requirements"]:::item
    U3["🛠️ Engineering Teams<br/>Automated guardrails & guidance"]:::item
    U4["🤖 AI Coding Agents<br/>Deep architectural context"]:::item

    %% ───────── HOW column: flows + CLI in one vertical chain ─────────
    CoreTitle["Core Orchestration Loop"]:::bandStyle
    C1["rules-context-loader"]:::step
    C2["architecture-work-to-evolution-map (AEM)"]:::step
    C3["alignment-engine (AIM)"]:::step
    C4["architecture-intent-generator (AID)"]:::step
    C5["governance-validator (continuous loop only)"]:::govStyle

    DiscTitle["Discovery Flow"]:::bandStyle
    D1["baseline-discovery"]:::step
    D2["rules-context-loader"]:::step
    D3["conversation-to-aw / discovery-to-aw / vision-to-aw"]:::step
    D4["→ AEM → AIM → AID"]:::step

    PatTitle["Pattern Flow"]:::bandStyle
    P1["signal-to-pattern-proposals"]:::step
    P2["pattern-scope-classifier"]:::step
    P3["pattern-promotion-workflow"]:::step
    P4["promotion-decision-capture"]:::step
    P5["promotion-to-decision-records (→ ADRs)"]:::step
    P6["approved-adr-to-pattern"]:::promStyle

    SteerTitle["Steering Projection"]:::bandStyle
    S1["steering-projection (git delta → knowledge artefact)"]:::step

    CLITitle["CLI surface (src/cas_runner/cli.py)"]:::bandStyle
    L1["cas bootstrap — install governance in a repo"]:::cliItem
    L2["cas init-workspace — attach knowledge workspace"]:::cliItem
    L3["cas dashboard [--format json|md]"]:::cliItem
    L4["cas evaluate &lt;trace-id&gt; — EvaluationHarness"]:::cliItem
    G1["cas governance validate — runs validator flow"]:::cliItem
    G2["cas governance approve | reject | defer | reopen &lt;artifact&gt; --rationale ..."]:::cliItem
    G3["cas governance resolve-conflicts — AgenticMerger"]:::govStyle
    T1["cas steering validate — ManagedSectionValidator"]:::cliItem
    T2["cas steering apply --projection &lt;id&gt; — ManagedSectionApplier"]:::cliItem

    %% ───────── Edges (vertical fan-out) ─────────
    Why --> W1 --> W2 --> W3
    What --> WH1 --> WH2 --> WH3 --> WH4
    Who --> U1 --> U2 --> U3 --> U4

    How --> CoreTitle
    CoreTitle --> C1 --> C2 --> C3 --> C4
    C4 -. continuous loop only .-> C5
    C5 -. loop back .-> C1
    C5 --> DiscTitle
    DiscTitle --> D1 --> D2 --> D3 --> D4
    D4 --> PatTitle
    PatTitle --> P1 --> P2 --> P3 --> P4 --> P5 --> P6
    P6 --> SteerTitle
    SteerTitle --> S1
    S1 --> CLITitle
    CLITitle --> L1 --> L2 --> L3 --> L4
    CLITitle --> G1 --> G2 --> G3
    CLITitle --> T1 --> T2

Pillars Explained

❓ WHY: The Problem We Solve

Architecture is traditionally static, written once, and quickly forgotten. Over time, the actual system diverges from the original design, leading to architecture decay, technical debt, and a disconnect between business requirements and the implemented code. With Coding Agents, this problem is exacerbated, as AI-generated code can introduce structural issues that are difficult to detect and correct.

💡 WHAT: The Value Proposition

CAS is an Architecture Harness Platform. It replaces static documents with a living, continuously derived knowledge system. It prevents bad structure from being created in the first place through CAS Skills, and detects and corrects drift using automated workflows. It constantly measures the system's intended architecture against its actual implementation, with Architecture Decision Records (ADRs) serving as the Single Source of Truth (SSOT). It amplifies reuse and reduces cognitive load by providing a Knowledge Layer that is queryable, continuously updated, and accessible to both humans and AI agents.

👥 WHO: The Beneficiaries

Execs: De-risks technology investments by guaranteeing alignment between spending (engineering effort) and business goals.
Architects & Engineers: Removes the burden of manual documentation while providing automated guardrails.
AI Ecosystem: Feeds crucial architectural context to autonomous coding agents, making AI-generated code safer and structurally sound.

⚙️ HOW: The Mechanism

CAS exposes a small set of composable flows, skills, and GitHub Actions. Each flow is a deterministic pipeline of steps that read from the knowledge layer and write back to it.

cas CLI is the user-facing surface that invokes those flows and adds lifecycle, observability, governance-state, and steering operations.
CI/CD pipelines and GitHub Actions invoke the same flows, enabling automated governance and steering of the system's architecture.