flowchart LR
    A[Draft] --> B[Review]
    B --> C[Staging]
    C --> D{Testing}
    D -->|Pass| E[Production]
    D -->|Fail| A
    E --> F[Monitor]
    F -->|Issue| G[Rollback]
    G --> E
    F -->|Improvement| A

    style E fill:#22c55e,color:#000
    style G fill:#ef4444,color:#fff

{
  "prompt_id": "customer-support-v1",
  "versions": [
    {
      "version": "1.0.0",
      "content": "You are a helpful support agent.",
      "model": "gpt-4",
      "temperature": 0.3,
      "author": "alice@company.com",
      "date": "2025-01-15",
      "status": "deprecated",
      "changelog": "Initial version"
    },
    {
      "version": "1.1.0",
      "content": "You are a helpful support agent. Be concise.",
      "model": "gpt-4",
      "temperature": 0.3,
      "author": "bob@company.com",
      "date": "2025-02-01",
      "status": "production",
      "changelog": "Added conciseness instruction"
    }
  ]
}

flowchart TD
    Q1[What changed?]
    Q1 -->|"Typo, grammar, formatting"| PATCH["Patch (1.0.0 → 1.0.1)"]
    Q1 -->|"New instruction, examples"| MINOR["Minor (1.0.0 → 1.1.0)"]
    Q1 -->|"New approach, structure"| MAJOR["Major (1.0.0 → 2.0.0)"]

    PATCH --> LOW["Low risk, auto-deploy"]
    MINOR --> MED["Medium risk, staged rollout"]
    MAJOR --> HIGH["High risk, full testing"]

    style LOW fill:#22c55e,color:#000
    style MED fill:#eab308,color:#000
    style HIGH fill:#ef4444,color:#fff

prompts/
  customer-support/
    v1.0.0.yaml
    v1.1.0.yaml
    v1.2.0.yaml
    current -> v1.1.0.yaml

CREATE TABLE prompt_versions (
  id UUID PRIMARY KEY,
  prompt_id VARCHAR(255) NOT NULL,
  version VARCHAR(20) NOT NULL,
  content TEXT NOT NULL,
  parameters JSONB,
  status VARCHAR(20),
  author VARCHAR(255),
  changelog TEXT,
  created_at TIMESTAMP DEFAULT NOW(),
  UNIQUE(prompt_id, version)
);

sequenceDiagram
    participant User
    participant Router
    participant Registry
    participant Monitor

    User->>Router: Request
    Router->>Registry: Get version (A=control, B=test)
    Registry-->>Router: Version config
    Router->>LLM: Send prompt
    LLM-->>User: Response

    par Tracking
        Monitor->>Monitor: Log version, latency, score
    end

    Note over Router,Monitor: Compare metrics after N samples

ab_test:
  experiment_id: "conciseness-v1"
  variants:
    control:
      version: "1.0.0"
      traffic: 50%
    treatment:
      version: "1.1.0"
      traffic: 50%
  metrics:
    - accuracy
    - response_length
    - user_satisfaction
  duration: "7d"
  decision: "rollout_if_improvement > 5%"

flowchart TD
    Q1[Monitor alert?]
    Q1 -->|Yes| Q2{Severity?}
    Q1 -->|No| NORMAL["Continue monitoring"]

    Q2 -->|Critical| AUTO["Auto-rollback<br/>to previous version"]
    Q2 -->|Warning| MANUAL["Notify team<br/>Manual review"]
    Q2 -->|Info| LOG["Log for analysis"]

    AUTO --> NOTIFY["Notify stakeholders"]
    MANUAL --> DECIDE{Keep or revert?}
    DECIDE -->|Revert| ROLLBACK["Rollback executed"]
    DECIDE -->|Keep| FIX["Deploy fix patch"]

    style AUTO fill:#ef4444,color:#fff
    style ROLLBACK fill:#22c55e,color:#000
    style FIX fill:#3b82f6,color:#fff

prompt_deployment:
  stages:
    - name: draft
      checks: []
    - name: review
      checks: [peer_review, safety_scan]
    - name: staging
      checks: [unit_tests, eval_suite]
    - name: canary
      checks: [metrics_monitor, 10min_stable]
    - name: production
      checks: [gradual_rollout]
    - name: deprecated
      checks: [archive]