Designing Distributed System Tests

Claim-gedreven testplannen voor gedistribueerde en stateful systemen, gekoppeld aan fault-injection scenario's

Door shenli · shenli/distributed-system-testing

Getest · Werkt ★ 9.2/10

Designing Distributed System Tests — Claim-gedreven testplannen voor gedistribueerde en stateful systemen, gekoppeld aan fault-injection scenario's

Wat het doet

Begeleidt een agent bij het ontwerpen van een claim-gedreven testplan voor een gedistribueerd of stateful systeem: het extraheert de garanties die het systeem claimt (durability, linearizability, idempotency, isolation, ordering), genereert failure-mode hypotheses gekoppeld aan elke claim, kiest technieken uit een catalogus, en zendt een gestructureerd planbestand uit met fault-injection scenario's en machine-checkable oracles. Activeert wanneer gevraagd wordt wat te testen voor een wijziging, voor een holistisch release-validation plan, of hoe durability, partitions, tenant isolation, of fairness te testen over shards of tenants.

Testrapport

SKILL.md via GitHub API/raw opgehaald; frontmatter parseert met name+description; assets/plan-template.md, references/catalog-index.md, references/common-distributed-systems-pitfalls.md steekproefsgewijs gecontroleerd — allemaal HTTP 200. Geen security smells (geen curl|sh, base64, exfil). Trigger: 5 zinsneden beoordeeld, alle 5 correct. Output: één change-scoped taak ontworpen en twee echte artifacts naar scratchpad geschreven. Baseline gaf een 7-item vlakke checklist waarvan de crashtest is "kill leader after ack, restart, value still there" met exit criterium "all tests pass in CI"; het skill-followed plan noemde claims C1-C4 plus een "missing claims" sectie, en scenario S1 injecteerde SIGKILL "between value-WAL-fsync and dedup-WAL-fsync" met oracle "exactly ONE committed effect ... state comparison against model, not logs fine" — een double-commit-on-retry window dat de baseline nooit target.

Getest op: 2026-07-31 · Claude Code 2.x (agent harness)

Installatie

git clone --depth 1 https://github.com/shenli/distributed-system-testing.git /tmp/designing-distributed-system-tests-src
mkdir -p ~/.claude/skills
cp -R /tmp/designing-distributed-system-tests-src/skills/designing-distributed-system-tests ~/.claude/skills/designing-distributed-system-tests
# Companion skill in same repo: skills/executing-distributed-system-tests (runs the plan this one emits).
# Plugin marketplace alt: repo ships .claude-plugin/marketplace.json (plugin "distributed-testing-skills").
# No external deps to produce a plan; executing the plan needs docker/netem/etc. per the plan's env section.

Commando's en voorbeeldprompts

/designing-distributed-system-testsClaim-gedreven testplannen voor gedistribueerde en stateful systemen, gekoppeld aan fault-injection scenario's

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

Design a test plan for this replicated database
Write a fault matrix for this consensus system
Create a stability plan for our messaging service

Volledig rapport (Engels) →