Add SDLC pipeline Mermaid diagram
Visualizes both pipelines (A: plugin, B: infra), the board approval gate, PR review SLA, handoff protocol, and issue status lifecycle. Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
committed by
Countess von Containerheim [agent]
Countess von Containerheim [agent]
parent
b1e2000542
commit
da86aa7754
@@ -0,0 +1,159 @@
|
|||||||
|
# SDLC Pipeline Diagram
|
||||||
|
|
||||||
|
## Full Lifecycle
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
flowchart TD
|
||||||
|
subgraph Origin["Task Origin"]
|
||||||
|
GH["GitHub Issue"]
|
||||||
|
PP["Paperclip Issue"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph Approval["Board Gate"]
|
||||||
|
BA{"Board Approval<br/>Required?"}
|
||||||
|
REQ["Request Board Approval<br/>→ Issue blocked"]
|
||||||
|
APPROVED["Approved"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph Detection["Pipeline Detection"]
|
||||||
|
DET{"Changed files?"}
|
||||||
|
PA["Pipeline A<br/>Plugin / Feature"]
|
||||||
|
PB["Pipeline B<br/>Infrastructure"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph PipelineA["Pipeline A: Plugin / Feature Changes"]
|
||||||
|
direction TB
|
||||||
|
A_ENG["Engineer writes code<br/>(Gandalf)"]
|
||||||
|
A_PR["Create PR → main<br/>cc @cpfarhood"]
|
||||||
|
A_CI{"CI Passes?"}
|
||||||
|
A_UAT["UAT Review<br/>(Pixel Patty)<br/>E2E browser testing"]
|
||||||
|
A_UAT_PASS{"UAT Approved?"}
|
||||||
|
A_QA["QA Review<br/>(Regression Regina)<br/>Test coverage, regressions"]
|
||||||
|
A_QA_PASS{"QA Approved?"}
|
||||||
|
A_CTO["CTO Review<br/>(Null Pointer Nancy)<br/>Architecture, security"]
|
||||||
|
A_CTO_PASS{"CTO Approved?"}
|
||||||
|
A_CEO["CEO Merge<br/>(Countess)"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph PipelineB["Pipeline B: Infrastructure Changes"]
|
||||||
|
direction TB
|
||||||
|
B_ENG["Engineer writes code<br/>(Gandalf / Hugh)"]
|
||||||
|
B_PR["Create PR → main<br/>cc @cpfarhood"]
|
||||||
|
B_CI{"CI Passes?"}
|
||||||
|
B_QA["QA Review<br/>(Regression Regina)"]
|
||||||
|
B_QA_PASS{"QA Approved?"}
|
||||||
|
B_CTO["CTO Review<br/>(Null Pointer Nancy)"]
|
||||||
|
B_CTO_PASS{"CTO Approved?"}
|
||||||
|
B_CEO["CEO Merge<br/>(Countess)"]
|
||||||
|
end
|
||||||
|
|
||||||
|
subgraph Result["Outcome"]
|
||||||
|
MERGED["Merged to main<br/>✓ Production"]
|
||||||
|
RETURNED["Returned to Engineer<br/>Fix and resubmit"]
|
||||||
|
end
|
||||||
|
|
||||||
|
%% Origin routing
|
||||||
|
GH --> BA
|
||||||
|
PP --> DET
|
||||||
|
BA -->|"originKind: github"| REQ
|
||||||
|
REQ -->|"PAPERCLIP_APPROVAL_STATUS"| APPROVED
|
||||||
|
BA -->|"originKind: other"| DET
|
||||||
|
APPROVED --> DET
|
||||||
|
|
||||||
|
%% Pipeline detection
|
||||||
|
DET -->|"headlamp-*-plugin/ code"| PA
|
||||||
|
DET -->|".github/, infra/, org/"| PB
|
||||||
|
|
||||||
|
%% Pipeline A flow
|
||||||
|
PA --> A_ENG --> A_PR --> A_CI
|
||||||
|
A_CI -->|"Pass"| A_UAT
|
||||||
|
A_CI -->|"Fail"| RETURNED
|
||||||
|
A_UAT --> A_UAT_PASS
|
||||||
|
A_UAT_PASS -->|"Pass"| A_QA
|
||||||
|
A_UAT_PASS -->|"Fail"| RETURNED
|
||||||
|
A_QA --> A_QA_PASS
|
||||||
|
A_QA_PASS -->|"Pass"| A_CTO
|
||||||
|
A_QA_PASS -->|"Fail"| RETURNED
|
||||||
|
A_CTO --> A_CTO_PASS
|
||||||
|
A_CTO_PASS -->|"Pass"| A_CEO
|
||||||
|
A_CTO_PASS -->|"Fail — CEO rejection"| A_CTO
|
||||||
|
A_CTO_PASS -->|"Fail — other"| RETURNED
|
||||||
|
A_CEO --> MERGED
|
||||||
|
|
||||||
|
%% Pipeline B flow
|
||||||
|
PB --> B_ENG --> B_PR --> B_CI
|
||||||
|
B_CI -->|"Pass"| B_QA
|
||||||
|
B_CI -->|"Fail"| RETURNED
|
||||||
|
B_QA --> B_QA_PASS
|
||||||
|
B_QA_PASS -->|"Pass"| B_CTO
|
||||||
|
B_QA_PASS -->|"Fail"| RETURNED
|
||||||
|
B_CTO --> B_CTO_PASS
|
||||||
|
B_CTO_PASS -->|"Pass"| B_CEO
|
||||||
|
B_CTO_PASS -->|"Fail — CEO rejection"| B_CTO
|
||||||
|
B_CTO_PASS -->|"Fail — other"| RETURNED
|
||||||
|
B_CEO --> MERGED
|
||||||
|
|
||||||
|
RETURNED -->|"Fix and resubmit"| A_PR
|
||||||
|
RETURNED -->|"Fix and resubmit"| B_PR
|
||||||
|
|
||||||
|
%% Styling
|
||||||
|
classDef gate fill:#f9e4e4,stroke:#c0392b,color:#000
|
||||||
|
classDef pass fill:#e4f9e4,stroke:#27ae60,color:#000
|
||||||
|
classDef agent fill:#e4e9f9,stroke:#2980b9,color:#000
|
||||||
|
classDef decision fill:#fef9e7,stroke:#f39c12,color:#000
|
||||||
|
|
||||||
|
class BA,A_CI,A_UAT_PASS,A_QA_PASS,A_CTO_PASS,B_CI,B_QA_PASS,B_CTO_PASS,DET decision
|
||||||
|
class A_UAT,A_QA,A_CTO,B_QA,B_CTO gate
|
||||||
|
class MERGED pass
|
||||||
|
class A_ENG,B_ENG,A_CEO,B_CEO agent
|
||||||
|
```
|
||||||
|
|
||||||
|
## PR Review SLA
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
gantt
|
||||||
|
title PR Review SLA Timeline (per stage)
|
||||||
|
dateFormat X
|
||||||
|
axisFormat %d h
|
||||||
|
|
||||||
|
section SLA Windows
|
||||||
|
Normal review window :done, 0, 24
|
||||||
|
CEO escalation at 24h :active, 24, 48
|
||||||
|
SLA violation at 48h :crit, 48, 72
|
||||||
|
Release blocker at 72h :crit, 72, 96
|
||||||
|
```
|
||||||
|
|
||||||
|
## Handoff Protocol
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
sequenceDiagram
|
||||||
|
participant Src as Source Agent
|
||||||
|
participant API as Paperclip API
|
||||||
|
participant Tgt as Target Agent
|
||||||
|
|
||||||
|
Src->>API: PATCH /issues/{id}<br/>assigneeAgentId: target
|
||||||
|
Src->>API: PATCH /issues/{id}<br/>status: "todo"
|
||||||
|
Note over Src,API: Never use "in_review" —<br/>it won't trigger inbox
|
||||||
|
Src->>API: POST /issues/{id}/release<br/>X-Paperclip-Run-Id header
|
||||||
|
API-->>Tgt: Inbox wake
|
||||||
|
Tgt->>API: POST /issues/{id}/checkout
|
||||||
|
Tgt->>Tgt: Begin work
|
||||||
|
```
|
||||||
|
|
||||||
|
## Issue Status Lifecycle
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
stateDiagram-v2
|
||||||
|
[*] --> backlog: Created (unscheduled)
|
||||||
|
[*] --> todo: Created (ready)
|
||||||
|
backlog --> todo: Scheduled
|
||||||
|
todo --> in_progress: Checkout
|
||||||
|
in_progress --> in_review: Awaiting feedback
|
||||||
|
in_progress --> blocked: External blocker
|
||||||
|
in_progress --> done: Work complete
|
||||||
|
in_review --> in_progress: Feedback received
|
||||||
|
blocked --> in_progress: Unblocked
|
||||||
|
in_progress --> cancelled: Abandoned
|
||||||
|
todo --> cancelled: Abandoned
|
||||||
|
backlog --> cancelled: Abandoned
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user