chaos-experiment

CategoryCoding

AuthorAlireza Rezvani

LicenseMIT

Rating4.40/5

Uses13.6K

/chaos-experiment

Step through the design of a chaos engineering experiment using the chaos-engineering skill. Produces a plan, calculates blast radius, validates abort criteria, and outputs a markdown plan ready for peer review.

Usage

code

/chaos-experiment
/chaos-experiment --target checkout-svc --attack latency

Implementation

bash

SKILL=engineering/chaos-engineering/skills/chaos-engineering
Step 1: gather inputs interactively (target, hypothesis, attack, magnitude, ...)
Step 2: run experiment_designer.py to produce the plan
python "$SKILL/scripts/experiment_designer.py" \
  --target "$TARGET" --hypothesis "$HYPOTHESIS" \
  --attack "$ATTACK" --magnitude "$MAGNITUDE" \
  --duration-min "$DURATION" \
  --abort-if "$ABORT" --owner "$OWNER" \
  --format json > .chaos-plan.json
Step 3: calculate blast radius against the team's error budget
python "$SKILL/scripts/blast_radius_calculator.py" \
  --traffic-share "$TRAFFIC_SHARE" \
  --user-pop "$USER_POP" \
  --duration-min "$DURATION" \
  --baseline-availability "$BASELINE_AVAIL" \
  --expected-impact-availability "$IMPACT_AVAIL"
Step 4: render the markdown plan for peer review
python "$SKILL/scripts/experiment_designer.py" \
  --target "$TARGET" --hypothesis "$HYPOTHESIS" \
  --attack "$ATTACK" --abort-if "$ABORT" --owner "$OWNER"

Output

A markdown plan with:

Hypothesis, steady-state metric, attack, magnitude, duration

Blast radius (calculated) with risk score (GREEN/YELLOW/RED)

Abort criteria parsed from --abort-if

Rollback procedure

Monitoring dashboard link

Learning question

Pre-conditions

chaos-engineering skill installed

Target identified

Steady-state metric and dashboard available

On-call team available

Error budget known (or use defaults)

Post-conditions

.chaos-plan.json written for use with experiment_postmortem.py later

Markdown plan streamed for review

Recommendation printed: PROCEED / REDUCE / ABORT