Soul ID
Soul IDAI AGENTS

⚑ Workflows

Canary Rollout (progressive deployment)

Minimize risk by deploying changes to a small subset first, validating metrics, and progressively expanding β€” or rolling back β€” based on observed health.

Bundle files

πŸ“„ORCHESTRATION.mdβ€” Orchestration
1# ORCHESTRATION.md
2
3## Diagram
4
5 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
6 β”‚ Change / Deployment β”‚
7 β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
8 β–Ό
9 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
10 β”‚ Canary Agent β”‚
11 β”‚ (execute on reduced scope: 5-10%) β”‚
12 β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
13 β–Ό
14 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
15 β”‚ Observer Agent β”‚
16 β”‚ (monitor metrics + error rates) β”‚
17 β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
18 β–Ό
19 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
20 β”‚ Metrics β”‚
21 β”‚ healthy? β”‚
22 β””β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜
23 yes β”‚ no
24 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
25 β–Ό β–Ό
26 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
27 β”‚ Expand to β”‚ β”‚ Rollback Agent β”‚
28 β”‚ next tier β”‚ β”‚ (revert canary) β”‚
29 β”‚ 25%β†’50%β†’100%β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
30 β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜ β–Ό
31 β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
32 β–Ό β”‚ Incident Report β”‚
33 β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
34 β”‚ Full Rolloutβ”‚
35 β”‚ Complete β”‚
36 β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
37
38
39## Workflow
40Canary Rollout (progressive deployment)
41
42## Objective
43Minimize risk by deploying changes to a small subset first, validating metrics, and progressively expanding β€” or rolling back β€” based on observed health.
44
45## Roles
46- **Canary Agent:** executes the change on the canary scope (limited blast radius).
47- **Observer Agent:** monitors health metrics, error rates, latency, and business KPIs during each tier.
48- **Rollback Agent:** reverts the canary if metrics breach thresholds.
49- **Promotion Controller:** decides tier progression based on Observer data.
50
51## When to use
52- Deployments to production or shared environments.
53- Configuration changes with uncertain impact.
54- Any change where "test in prod safely" is the strategy.
55- Multi-agent task rollouts where you want to validate the approach on a subset.
56
57## Protocol
581. Define canary tiers: 5% β†’ 25% β†’ 50% β†’ 100% (configurable).
592. Canary Agent executes change on tier 1 scope.
603. Observer Agent monitors for observation window (e.g., 10 min per tier).
614. Promotion Controller evaluates:
62 - Error rate < threshold β†’ promote to next tier.
63 - Error rate β‰₯ threshold β†’ trigger Rollback Agent.
645. Repeat for each tier until 100% or rollback.
656. On full rollout: Observer continues monitoring for bake period.
66
67## Health thresholds
68- **Error rate:** < 1% increase from baseline
69- **Latency p99:** < 20% increase from baseline
70- **Business KPIs:** no degradation beyond tolerance
71
72## Tier schedule (default)
73| Tier | Scope | Observation window |
74|------|-------|--------------------|
75| 1 | 5% | 10 min |
76| 2 | 25% | 15 min |
77| 3 | 50% | 15 min |
78| 4 | 100% | 30 min (bake) |
79
80## Rules
81- Never skip tiers (no 5% β†’ 100%).
82- Rollback is automatic if thresholds are breached β€” no manual approval needed.
83- Observer must compare against pre-deployment baseline, not absolute values.
84- All tier transitions logged with metrics snapshot.
85
86## Deliverables
87- Deployment progression log (tier, timestamp, metrics)
88- Health dashboard per tier
89- Final status: fully-rolled-out | rolled-back-at-tier-N
90- Post-deployment bake report
91

Lines: 91 | Words: 431

Install

Copy bundle to your OpenClaw workspace.

curl -fsSL https://raw.githubusercontent.com/cerealskill/openclaw-agents/main/install.sh | bash -s workflow canary-rollout EN
Download .tar.gz

Rate this agent

Loading...

Sign in to rate this agent

Includes

  • βœ“ ORCHESTRATION.md

Info

Slug
canary-rollout
Lines
91
Words
431