Distributed Systems Basics

Deliverables

• Failure-mode map and risk ranking.
• Consistency decision record per critical flow.
• Reliability mechanism selection (retry, idempotency, backoff, timeout).
• Validation plan (fault injection and invariant checks).

Workflow

1. Capture critical flows with assets/distributed-flow-risk-template.md.
2. Map failure assumptions and consistency requirements per flow.
3. Select reliability primitives using references/failure-mode-consistency-rules.md.
4. Define observability and recovery behavior.
5. Validate assumptions with targeted failure tests and invariant checks.

Quality Standard

• Critical flows have explicit consistency and ordering rules.
• Retry/timeout semantics are bounded and intentional.
• Idempotency strategy exists where at-least-once delivery is possible.
• Failure handling is observable and testable.

Failure Conditions

• Stop when consistency assumptions are implicit or contradictory.
• Stop when retries/timeouts can amplify failure unboundedly.
• Escalate when critical failure modes have no mitigation path.