principle-distributed-systems

Guide distributed system design across consistency, ordering, consensus, and replication.

2|8|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/lugassawan/swe-workbench --skill principle-distributed-systems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: principle-distributed-systems
Source: https://github.com/lugassawan/swe-workbench/tree/main/skills/principle-distributed-systems
Command: npx skills add https://github.com/lugassawan/swe-workbench --skill principle-distributed-systems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Distributed systems fail in partial, non-deterministic ways, so teams need principled guidance to make correct trade-offs across consistency, availability, latency, and failure modes.

Core Features & Use Cases

  • CAP and PACELC decision-making: explicitly choose consistency vs availability under partitions, and name the latency vs consistency trade-off in normal operation (PACELC).
  • Correct consistency model selection: compare linearizable, causal, read-your-writes, monotonic reads, and eventual consistency to match actual correctness needs.
  • Ordering, clocks, and delivery semantics: replace unsafe wall-clock ordering with Lamport/vector/HLC concepts, and distinguish exactly-once delivery myths from exactly-once effects via idempotency and atomicity.

Quick Start

Use principle-distributed-systems to decide whether your system should be CP or AP under network partitions and what consistency model best matches your application’s correctness requirements.

Frequently Asked Questions about principle-distributed-systems

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose between CP and AP consistency under network partitions?

Use CAP and PACELC frameworks to explicitly choose consistency versus availability during network partitions, and name the latency versus consistency trade-off during normal operation to match your application's correctness requirements.

What is the difference between exactly-once delivery and exactly-once effects?

Exactly-once delivery is a myth, while exactly-once effects are achievable by implementing idempotent operations and atomicity under retries and partitions, distinguishing between at-most-once, at-least-once, and exactly-once effect semantics.

How do I prevent split-brain in distributed systems using quorum replication?

Prevent split-brain in distributed systems by implementing quorum-based writes, leader election, and fencing mechanisms, while framing protocol limits like FLP and two-generals to maintain correctness during partial network failures.

When do I need logical clocks instead of wall-clock timestamps for event ordering?

You need logical clocks instead of wall-clock timestamps when ordering cross-node events in distributed systems, replacing unsafe wall-clock ordering with Lamport clocks, vector clocks, or Hybrid Logical Clocks to guarantee correct causal ordering.

Which consistency model should I use for my distributed database?

Select a consistency model for your distributed database by comparing linearizable, causal, read-your-writes, monotonic reads, and eventual consistency to match your actual correctness needs and latency constraints across your system.