Agile SDLC
Enterprise AI-Agent SDLC — Architecture
flowchart LR
%% ====== STYLE ======
%% classDef layer fill:#0b132b,stroke:#0b132b,color:#fff,rx:14,ry:14;
classDef layer0 fill:green,stroke:lightgrey,color:#ffffff,rx:14,ry:14;
classDef layer1 fill:lightblue,stroke:lightgrey,color:#fff,rx:14,ry:14;
classDef layer2 fill:darkblue,stroke:lightgrey,color:#fff,rx:14,ry:14;
classDef layer3 fill:darkred,stroke:lightgrey,color:#fff,rx:14,ry:14;
classDef layer4 fill:green,stroke:lightgrey,color:#fff,rx:14,ry:14;
classDef layer5 fill:darkgreen,stroke:lightgrey,color:#fff,rx:14,ry:14;
classDef box stroke:lightgrey,color:green,rx:10,ry:10;
classDef ctrl fill:#28304f,stroke:#28304f,color:#c7e3ff,rx:10,ry:10; %% guardrails
%% classDef box fill:#1c2541,stroke:#1c2541,color:#fff,rx:10,ry:10;
%% classDef ctrl fill:#28304f,stroke:#28304f,color:#c7e3ff,rx:10,ry:10; %% guardrails
classDef bus fill:#3a506b,stroke:#3a506b,color:orange,rx:14,ry:14;
%% classDef art fill:#eaeff7,stroke:#cbd5e1,color:#0b132b,rx:10,ry:10;
%% === COLORS (same 7-color scheme) ===
%% classDef layer0 fill:#16a34a,stroke:#0f5132,color:#ffffff
%% classDef bus fill:#475569,stroke:#1f2937,color:#ffffff
%% classDef layer1 fill:#111827,stroke:#0b132b,color:#ffffff
%% classDef layer2 fill:#0f172a,stroke:#111827,color:#ffffff
%% classDef layer3 fill:#0b132b,stroke:#0b132b,color:#ffffff
%% classDef layer4 fill:#0a192f,stroke:#0b132b,color:#ffffff
%% classDef layer5 fill:#eaeff7,stroke:#cbd5e1,color:#0b132b
%% ====== FLOW ======
%% SSoT --> POA
%% POA -->|INVEST Stories & AC| ARCA
%% ARCA -->|ADRs & NFRs : perf / sec / cost| DESA
%% DESA --> CODEA
%% TESTA --> QAA --> SEC
%% CD --> OPS
%% INS --> POA
%% ARCA --> IACA --> TESTA
%% FIN --> POA
%% FIN --> ARCA
%% ====== ARTIFACTS ======
%% POA -.->|User stories| PKG1[(📄 Product Backlog)]:::art
%% CODEA -.->|Source + Unit tests| PKG2[(🧩 Repo)]:::art
%% IACA -.->|Terraform/Bicep/Policies| PKG3[(🏗️ IaC)]:::art
%% TESTA -.->|Test suites| PKG4[(✅ Tests)]:::art
%% CD -.->|Release artifacts| PKG5[(🚀 Packages)]:::art
%% OPS -.->|SLIs • SLOs • Dashboards| PKG6[(📊 Observability)]:::art
%% ====== LAYER 4: DELIVER & OPERATE ======
subgraph L4["DELIVER & OPERATE"]
CD[🤖 Delivery Agent<br/>🚀 Pipelines • Releases]:::box
OPS[🤖 SRE / Operations Agent<br/>📊 SLIs • SLOs • Alerts]:::ctrl
FIN[🤖 FinOps Agent<br/>Cost/Unit-Econ • Efficiency]:::ctrl
end
class L4 layer4
%% ====== LAYER 3: TEST & VERIFY ======
subgraph L3["TEST & VERIFY"]
TESTA[🤖 Tester Agent<br/>✅ Test Cases • Test Suites]:::box
QAA[🤖 QA Agent<br/>Traceability • Coverage]:::box
SEC[🤖 SecOps Agent<br/>SAST/DAST/Policy-as-Code]:::ctrl
end
class L3 layer3
%% ====== LAYER 2: DESIGN & BUILD ======
subgraph L2["DESIGN & BUILD"]
DESA[🤖 Design Agent<br/>APIs • Schemas • Mockups]:::box
CODEA[🤖 Coder Agent<br/>Source Code • Unit Tests]:::box
IACA[🤖 IaC Agent<br/>Terraform/Bicep • Policies]:::box
end
class L2 layer2
%% ====== LAYER 1: PLAN & ANALYZE ======
subgraph L1["PLAN & ANALYZE"]
POA[🤖 <b>Product-Owner</b> Agent<br/>INVEST Stories • Backlog]:::box
ARCA[🤖 <b>Cloud-Architect</b> Agent<br/>ADRs • NFRs • Guardrails]:::ctrl
INS[🤖 <b>Dev-Insights</b> Agent<br/>DORA • SLO Trends]:::box
end
class L1 layer1
%% ====== MCP / TOOLING BUS ======
subgraph BUS["MCP Tooling Bus <br/> USB-C for AI apps"]
direction TB
SECPL[(Security Scanners)]:::bus
CICD[(CI/CD)]:::bus
CMDB[(CMDB/ITSM)]:::bus
OBS[(Observability)]:::bus
end
class BUS bus
%% ORCH --- BUS
%% POA --- JIRA
%% CODEA --- GIT
%% IACA --- GIT
%% CD --- CICD
%% SEC --- SECPL
%% OPS --- OBS
%% FIN --- CMDB
%% ====== LAYER 0: HUMAN + ORCHESTRATOR ======
subgraph L0["🤖 AI ORCHESTRATOR <br/> HUMAN HITL 👤"]
direction LR
SSoT[👤 Jira/GitHub/ADO <br/> Biz Goals & Constraints]:::box
ORCH[🤖 AI Orchestrator<br/>Agent Router + MCP]:::box
SSoT --- ORCH
end
class L0 layer0
flowchart TB
%% ==== STYLE ====
classDef quarter fill:#fef3c7,stroke:#f59e0b,color:#111827,rx:12,ry:12;
classDef sprint fill:#dcfce7,stroke:#16a34a,color:#052e16,rx:12,ry:12;
classDef daily fill:#e0f2fe,stroke:#0284c7,color:#0c4a6e,rx:12,ry:12;
classDef review fill:#f3e8ff,stroke:#9333ea,color:#2e1065,rx:12,ry:12;
%% ==== QUARTERLY ====
Q0[🎯 <b>Mission</b> : Annual+]:::quarter
Q1[🎯 Quarterly/Monthly OKRs set/refresh<br/>• 1–3 bold Objectives<br/>• Measurable Value KRs]:::quarter
%% Q2[Roadmap update & funding : persistent pods]:::quarter
QBR[QBR: track value, reprioritize, align domains]:::review
%% ==== SPRINT (BIWEEKLY) ====
SP0[🥇 Sprint Planning<br/>select stories -> Sprint Goal]:::sprint
SP1[Backlog Refinement<br/> : pod-defined cadence]:::sprint
SP2[🥉 Sprint Review<br/>demo working increments]:::review
SP3[Retrospective<br/>improve ways of working]:::review
%% ==== DAILY ====
D1[🥈 Daily Standup<br/>status, blockers, next steps]:::daily
%% ==== LOOPS ====
%% Q0 --> Q1 --> Q2 --> SP0
Q0 -->| Roadmap & Agile Team | SP0
SP0 --> D1 --> SP2 --> SP3 --> SP1 --> SP0
SP2 --> QBR
QBR -->|adjust OKRs / budgets / staffing| Q1
%% ==== AI/OPS GUARDRAILS ====
SLO[🏅 SLIs/SLOs & Error Budgets]:::review
DORA[🎖️ DORA metrics<br/>lead-time • deploy freq • CFR • MTTR]:::review
SLO -. informs & drive tradeoffs .- SP0
DORA -. informs .- QBR
Architecture & Automation Patterns for Cloud Foundation + FinOps
---
config:
themeVariables:
fontFamily: Inter
fontSize: 15px
primaryColor: '#34b2e7'
edgeLabelBackground: '#fff'
flowchart:
curve: basis
layout: dagre
---
flowchart LR
subgraph rb["Runbooks Platform"]
SpecLayer["Specs / Plans / Tasks"]
Router["Runbooks CLI / API Gateway"]
Executor["Orchestration Engine"]
EvidenceStore["Snapshots / Logs / Artifacts"]
MetricBus["Metrics & Telemetry"]
end
subgraph cf["Cloud Foundations / Landing Zone"]
Org["AWS Organizations + OUs"]
GuardrailEngine["Guardrail Modules"]
DriftDetector["Drift Detection"]
Remediator["Remediation Engine"]
InventorySvc["Discovery / Inventory"]
CostSvc["Cost Ingestion / Insights"]
end
subgraph es["External Systems"]
MCPModules["AWS MCP Servers"]
Dashboard["Vizro Analytics / BI"]
Jira["Atlassian / Ticketing"]
IAMIdentity["AWS SSO / Entra ID"]
end
SpecLayer e1@==> Router
Router e2@==> Executor
e1@{ animate: true }
e2@{ animate: true }
Executor --> GuardrailEngine & DriftDetector & EvidenceStore & MetricBus
Executor e3@==> |runbooks inventory| InventorySvc
Executor e4@==> |runbooks finops| CostSvc
Executor e5@<--> |spec-kit + atlassian-rovo MCP | Jira
e3@{ animate: true }
e4@{ animate: true }
e5@{ animate: true }
GuardrailEngine --> Org
DriftDetector --> Org
Remediator --> Org
InventorySvc --> Org
CostSvc --> Org
MetricBus e6@--> Dashboard
e6@{ animate: true }
IAMIdentity --> Org
SpecLayer:::core
Router:::core
Executor:::core
Org:::core
DriftDetector:::alert
Remediator:::alert
classDef core fill:#d1efff,stroke:#1090b2,stroke-width:2px
classDef alert fill:#ffe9e9,stroke:#d32c2c,stroke-width:2.5px
style rb fill:#e9f7fc,stroke:#1090b2,stroke-width:3px
style cf fill:#fff9ee,stroke:#b77f08,stroke-width:3px
style es fill:#f2e9fc,stroke:#8b60d5,stroke-width:3px
Project Structure
CloudOps-Runbooks/
├── src/runbooks/ # Production code ONLY
├── tests/ # ALL test-related files
│ ├── unit/ # Unit tests
│ ├── integration/ # Integration tests
│ └── artifacts/ # Test execution outputs
│ ├── evidence/ # Test results (.txt, .json)
│ ├── test-evidence/ # Test validation data
│ └── test-exports/ # Test exports
├── reports/ # Test reports (junit.xml, coverage)
├── tmp/ # Temporary files (fully gitignored)
│ ├── test-logs/ # Test execution logs
│ └── *.log # Application logs
├── artifacts/ # PROJECT artifacts ONLY (NOT test)
│ ├── active-projects.md
│ ├── mcp-validation/
│ ├── standards/
│ └── releases/
├── docs/ # User documentation
└── .claude/ # Framework files