Skip to content

alirezarezvani/claude-skills / engineering/skills/chaos-engineering

chaos-engineering

Verified

Use before running a chaos experiment, gameday or fault injection, or after one to write it up. Designs it with steady state and abort criteria in experiment_designer.py, sizes the blast radius with blast_radius_calculator.py and drafts the postmortem.

assets/experiment_template.md

View on GitHub
# Chaos Experiment

Fill in every section before running. Refuse to run if any section is empty.

## Identity

- **Experiment ID:** `<auto-generated; format: chaos-<target>-<attack>-<unix-ts>>`
- **Date:** `<YYYY-MM-DD>`
- **Owner:** `<your-handle@team>`
- **On-call team:** `<team channel / pager>`
- **Reviewer:** `<peer who reviewed this plan>`

## 1. Hypothesis

> When `<fault>`, `<steady-state metric>` stays `<tolerance>`.

Example: *When payment-svc is +200ms slow, checkout p99 stays below 500ms.*

## 2. Steady-state metric

- **Metric:** `<e.g., p99 checkout latency>`
- **Baseline window:** `<e.g., 5 minutes pre-experiment>`
- **Tolerance:** `<e.g., within ±5% of baseline>`
- **Dashboard:** `<URL>`

## 3. Attack

- **Type:** `[ ] latency  [ ] error  [ ] cpu  [ ] memory  [ ] disk  [ ] network-partition  [ ] dependency-failure  [ ] time-skew  [ ] kill-instance`
- **Magnitude:** `<e.g., +200ms>`
- **Duration:** `<minutes>`
- **Target:** `<service / pod / instance / region>`
- **Tooling:** `<Chaos Toolkit / Chaos Mesh / Litmus / Gremlin / AWS FIS / Custom>`

## 4. Blast radius

- **Traffic share:** `<e.g., 5% of US>`
- **Expected affected users:** `<from blast_radius_calculator.py>`
- **Error budget consumed:** `<from blast_radius_calculator.py>`
- **Risk score:** `[ ] GREEN  [ ] YELLOW  [ ] RED`

## 5. Abort criteria

> Auto-trigger experiment termination if ANY of these hit.

- [ ] `<signal 1, e.g., p99 > 1000ms>`
- [ ] `<signal 2, e.g., 5xx rate > baseline + 1pp>`
- [ ] `<signal 3, e.g., on-call paged SEV1/SEV2>`

## 6. Rollback procedure

1. `<step to disable fault, e.g., "kubectl delete chaos networkchaos/<name>">`
2. Verify steady state recovers within 2 minutes
3. If not recovering, escalate as incident; restore from backup if needed

## 7. Learning question

> What do you expect NOT to learn? Force yourself to predict.

`<your prediction>`

## Pre-flight checklist

- [ ] Hypothesis written
- [ ] Steady-state metric measured for ≥5 min
- [ ] Blast radius calculated (GREEN or YELLOW only)
- [ ] Abort criteria documented with thresholds
- [ ] Rollback procedure tested in staging
- [ ] On-call team notified
- [ ] Monitoring dashboards open
- [ ] Owner identified and reachable
- [ ] Time-box agreed
- [ ] Communication plan if abort triggers

## Post-experiment

Run `experiment_postmortem.py --plan <plan.json> --result-log <results>` to generate the postmortem.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall